修改注释

src/net/micode/notes/ui/AlarmAlertActivity.java

@@ -59,26 +59,25 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
         win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED);
 
         if (!isScreenOn()) {
-            win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON
+            win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON//保持窗体点亮
-                    //保持窗体点亮
+                    
-                    | WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON
+                    | WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON//将窗体点亮
-                    //将窗体点亮
+                    
-                    | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON
+                    | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON//允许窗体点亮时锁屏
-                    //允许窗体点亮时锁屏
+                    
-                    | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);
+                    | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);//在手机锁屏后如果到了闹钟提示时间，点亮屏幕
-        }//在手机锁屏后如果到了闹钟提示时间，点亮屏幕
+        }
 
         Intent intent = getIntent();
 
         try {
             mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));
-            mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId);
+            mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId);//根据ID从数据库中获取标签的内容；getContentResolver（）是实现数据共享，实例存储。
-            //根据ID从数据库中获取标签的内容；
+            
-            //getContentResolver（）是实现数据共享，实例存储。
+            mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet.substring(0,//判断标签片段是否达到符合长度
-            mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet.substring(0,
                     SNIPPET_PREW_MAX_LEN) + getResources().getString(R.string.notelist_string_info)
                     : mSnippet;
-            //判断标签片段是否达到符合长度
+            
         } catch (IllegalArgumentException e) {
             e.printStackTrace();
             return;
@@ -95,26 +94,22 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
                      代码区如果有错误，就会返回所写异常的处理。*/
         mPlayer = new MediaPlayer();
         if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
-            showActionDialog();
+            showActionDialog();//弹出对话框
-            //弹出对话框
+            playAlarmSound();//闹钟提示音激发
-            playAlarmSound();
-            //闹钟提示音激发
         } else {
-            finish();
+            finish();//完成闹钟动作
-            //完成闹钟动作
         }
     }
 
-    private boolean isScreenOn() {
         //判断屏幕是否锁屏，调用系统函数判断，最后返回值是布尔类型
+    private boolean isScreenOn() {
         PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
         return pm.isScreenOn();
     }
 
-    private void playAlarmSound() {
+    private void playAlarmSound() {//闹钟提示音激发
-        //闹钟提示音激发
+        
-        Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);
+        Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);        //调用系统的铃声管理URI，得到闹钟提示音
-        //调用系统的铃声管理URI，得到闹钟提示音
         int silentModeStreams = Settings.System.getInt(getContentResolver(),
                 Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0);
 
@@ -124,19 +119,13 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
             mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM);
         }
         try {
-            mPlayer.setDataSource(this, url);
+            mPlayer.setDataSource(this, url);//方法：setDataSource(Context context, Uri uri)
-            //方法：setDataSource(Context context, Uri uri) 
+            mPlayer.prepare(); //准备同步
-            //解释：无返回值，设置多媒体数据来源【根据 Uri】
+            mPlayer.setLooping(true);//设置是否循环播放
-            mPlayer.prepare();
+            mPlayer.start();//开始播放
-            //准备同步
-            mPlayer.setLooping(true);
-            //设置是否循环播放
-            mPlayer.start();
-            //开始播放
         } catch (IllegalArgumentException e) {
             // TODO Auto-generated catch block
-            e.printStackTrace();
+            e.printStackTrace();//e.printStackTrace()函数功能是抛出异常， 还将显示出更深的调用信息
-            //e.printStackTrace()函数功能是抛出异常， 还将显示出更深的调用信息
             //System.out.println(e)，这个方法打印出异常，并且输出在哪里出现的异常
         } catch (SecurityException e) {
             // TODO Auto-generated catch block
@@ -156,32 +145,23 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
         //所以不能直接通过new一个AlertDialog来创建出一个AlertDialog。
         //要创建一个AlertDialog，就要用到AlertDialog.Builder中的create()方法
         //如这里的dialog就是新建了一个AlertDialog
-        dialog.setTitle(R.string.app_name);
+        dialog.setTitle(R.string.app_name);//为对话框设置标题
-        //为对话框设置标题
+        dialog.setMessage(mSnippet);//为对话框设置内容
-        dialog.setMessage(mSnippet);
+        dialog.setPositiveButton(R.string.notealert_ok, this);//给对话框添加"Yes"按钮
-        //为对话框设置内容
-        dialog.setPositiveButton(R.string.notealert_ok, this);
-        //给对话框添加"Yes"按钮
         if (isScreenOn()) {
-            dialog.setNegativeButton(R.string.notealert_enter, this);
+            dialog.setNegativeButton(R.string.notealert_enter, this);//对话框添加"No"按钮
-        }//对话框添加"No"按钮
+        }
         dialog.show().setOnDismissListener(this);
     }
-
     public void onClick(DialogInterface dialog, int which) {
-        switch (which) {
+        switch (which) {//用which来选择click后下一步的操作
-            //用which来选择click后下一步的操作
+            
-            case DialogInterface.BUTTON_NEGATIVE:
+            case DialogInterface.BUTTON_NEGATIVE://这是取消操作
-                //这是取消操作
+                Intent intent = new Intent(this, NoteEditActivity.class);//实现两个类间的数据传输
-                Intent intent = new Intent(this, NoteEditActivity.class);
+                intent.setAction(Intent.ACTION_VIEW);//设置动作属性
-                //实现两个类间的数据传输
+                intent.putExtra(Intent.EXTRA_UID, mNoteId);//实现key-value对,EXTRA_UID为key；mNoteId为键
-                intent.setAction(Intent.ACTION_VIEW);
+                startActivity(intent);//开始动作
-                //设置动作属性
+                
-                intent.putExtra(Intent.EXTRA_UID, mNoteId);
-                //实现key-value对
-                //EXTRA_UID为key；mNoteId为键
-                startActivity(intent);
-                //开始动作
                 break;
             default:
                 //这是确定操作
@@ -191,18 +171,14 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
 
     public void onDismiss(DialogInterface dialog) {
         //忽略
-        stopAlarmSound();
+        stopAlarmSound();//停止闹钟声音
-        //停止闹钟声音
+        finish();//完成该动作
-        finish();
-        //完成该动作
     }
 
     private void stopAlarmSound() {
         if (mPlayer != null) {
-            mPlayer.stop();
+            mPlayer.stop();//停止播放
-            //停止播放
+            mPlayer.release();//释放MediaPlayer对象
-            mPlayer.release();
-            //释放MediaPlayer对象
             mPlayer = null;
         }
     }