[ui]

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

@@ -64,45 +64,53 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
         Intent intent = getIntent();
 
         try {
+            // 获取传递过来的NoteId和Snippet
             mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));
             mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId);
+            // 处理提醒信息的文本长度和显示方式
             mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet.substring(0,
                     SNIPPET_PREW_MAX_LEN) + getResources().getString(R.string.notelist_string_info)
-                    : mSnippet;
+                    : mSnippet;// 如果文本过长则截取前60个字符，加上一个显示“…”的标识
         } catch (IllegalArgumentException e) {
             e.printStackTrace();
             return;
         }
 
         mPlayer = new MediaPlayer();
+        // 从数据源中查询记录是否存在，如果存在则显示提醒菜单和播放提醒声音，否则结束Activity
         if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
-            showActionDialog();
-            playAlarmSound();
+            showActionDialog();// 显示提醒菜单
+            playAlarmSound();// 播放提醒声音
         } else {
-            finish();
+            finish();// Note不存在，结束Activity
         }
     }
 
-    private boolean isScreenOn() {
+    private boolean isScreenOn() {// 检测屏幕是否点亮
         PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
-        return pm.isScreenOn();
+        return pm.isScreenOn();// 返回屏幕是否点亮的状态
     }
 
     private void playAlarmSound() {
+        // 获取系统设置中的闹钟铃声
         Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);
-
+        // 获取当前系统模式下是否与闹钟声音相应
         int silentModeStreams = Settings.System.getInt(getContentResolver(),
                 Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0);
-
+        // 设置播放器的音频串流类型
         if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM)) != 0) {
             mPlayer.setAudioStreamType(silentModeStreams);
         } else {
             mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM);
         }
         try {
+            // 设置播放器的数据源
             mPlayer.setDataSource(this, url);
+            // 缓冲播放器的媒体源数据
             mPlayer.prepare();
+            // 设置播放器循环播放
             mPlayer.setLooping(true);
+            // 播放闹钟声音
             mPlayer.start();
         } catch (IllegalArgumentException e) {
             // TODO Auto-generated catch block
@@ -118,25 +126,25 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
             e.printStackTrace();
         }
     }
-
+    // 显示提醒菜单Dialog，包括Note的文本信息、确认键和选择键(如果屏幕是点亮的)
     private void showActionDialog() {
-        AlertDialog.Builder dialog = new AlertDialog.Builder(this);
-        dialog.setTitle(R.string.app_name);
+        AlertDialog.Builder dialog = new AlertDialog.Builder(this);// 设置Dialog的标题为应用名称
+        dialog.setTitle(R.string.app_name);// 设置Dialog的信息为Note的文本信息
         dialog.setMessage(mSnippet);
-        dialog.setPositiveButton(R.string.notealert_ok, this);
-        if (isScreenOn()) {
+        dialog.setPositiveButton(R.string.notealert_ok, this);// 设置确认键，点击后执行onClick()方法
+        if (isScreenOn()) {// 如果屏幕是点亮的，设置选择键 “进入笔记”， 点击后执行onClick()方法
             dialog.setNegativeButton(R.string.notealert_enter, this);
         }
-        dialog.show().setOnDismissListener(this);
+        dialog.show().setOnDismissListener(this);// 显示Dialog，并设置当Dialog消失时的监听器
     }
-
+    // Dialog按键点击响应函数, which为点击的按键的序号
     public void onClick(DialogInterface dialog, int which) {
         switch (which) {
-            case DialogInterface.BUTTON_NEGATIVE:
+            case DialogInterface.BUTTON_NEGATIVE:// 如果按下了选择键”进入笔记“
                 Intent intent = new Intent(this, NoteEditActivity.class);
                 intent.setAction(Intent.ACTION_VIEW);
                 intent.putExtra(Intent.EXTRA_UID, mNoteId);
-                startActivity(intent);
+                startActivity(intent);// 打开Note编辑界面
                 break;
             default:
                 break;
@@ -144,15 +152,15 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
     }
 
     public void onDismiss(DialogInterface dialog) {
-        stopAlarmSound();
-        finish();
+        stopAlarmSound();// 停止播放闹钟声音
+        finish();// 结束Activity
     }
 
     private void stopAlarmSound() {
-        if (mPlayer != null) {
-            mPlayer.stop();
-            mPlayer.release();
-            mPlayer = null;
+        if (mPlayer != null) {// 如果播放器存在
+            mPlayer.stop();// 停止播放
+            mPlayer.release();// 释放播放器占用的资源
+            mPlayer = null;// 将播放器设为空
         }
     }
 }

app/src/main/java/net/micode/notes/ui/AlarmInitReceiver.java

@@ -27,9 +27,8 @@ import android.database.Cursor;
 import net.micode.notes.data.Notes;
 import net.micode.notes.data.Notes.NoteColumns;
 
-
+// 定义接收闹钟初始化的广播接收器
 public class AlarmInitReceiver extends BroadcastReceiver {
-
     private static final String [] PROJECTION = new String [] {
         NoteColumns.ID,
         NoteColumns.ALERTED_DATE
@@ -37,29 +36,32 @@ public class AlarmInitReceiver extends BroadcastReceiver {
 
     private static final int COLUMN_ID                = 0;
     private static final int COLUMN_ALERTED_DATE      = 1;
-
+    // 查询提醒时间比当前时间更晚的Note记录，并将它们转为闹钟事件
     @Override
     public void onReceive(Context context, Intent intent) {
+        // 获取当前时间
         long currentDate = System.currentTimeMillis();
         Cursor c = context.getContentResolver().query(Notes.CONTENT_NOTE_URI,
                 PROJECTION,
-                NoteColumns.ALERTED_DATE + ">? AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE,
-                new String[] { String.valueOf(currentDate) },
+                NoteColumns.ALERTED_DATE + ">? AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE,// 查询条件，提醒时间比当前时间更晚且类型为Note
+                new String[] { String.valueOf(currentDate) }, // 查询参数，当前时间
                 null);
-
+// 查询所有提醒时间晚于当前时间的Note记录
         if (c != null) {
             if (c.moveToFirst()) {
                 do {
+                    // 获取提醒时间和Note的ID，以创建相应的PendingInten
                     long alertDate = c.getLong(COLUMN_ALERTED_DATE);
                     Intent sender = new Intent(context, AlarmReceiver.class);
                     sender.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, c.getLong(COLUMN_ID)));
                     PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, sender, 0);
+                    // 将提醒时间设置为对应的闹钟时间，并创建相应的闹钟事件
                     AlarmManager alermManager = (AlarmManager) context
                             .getSystemService(Context.ALARM_SERVICE);
                     alermManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent);
                 } while (c.moveToNext());
             }
-            c.close();
+            c.close();// 关闭游标
         }
     }
 }

app/src/main/java/net/micode/notes/ui/AlarmReceiver.java

@@ -21,10 +21,13 @@ import android.content.Context;
 import android.content.Intent;
 
 public class AlarmReceiver extends BroadcastReceiver {
+    // 监听AlarmManager的闹钟事件，接收到事件后启动提醒界面
     @Override
     public void onReceive(Context context, Intent intent) {
+        // 指定启动的Activity为AlarmAlertActivity，并添加NEW_TASK标志，使其在新的任务栈上启动
         intent.setClass(context, AlarmAlertActivity.class);
         intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        // 启动指定Activity
         context.startActivity(intent);
     }
 }

app/src/main/java/net/micode/notes/ui/DateTimePicker.java

@@ -29,7 +29,7 @@ import android.widget.FrameLayout;
 import android.widget.NumberPicker;
 
 public class DateTimePicker extends FrameLayout {
-
+    // 定义一些常量，包括默认开启状态、半天和一天的小时数、一周的天数、各个数字选择器的取值范围等
     private static final boolean DEFAULT_ENABLE_STATE = true;
 
     private static final int HOURS_IN_HALF_DAY = 12;
@@ -46,29 +46,33 @@ public class DateTimePicker extends FrameLayout {
     private static final int AMPM_SPINNER_MIN_VAL = 0;
     private static final int AMPM_SPINNER_MAX_VAL = 1;
 
-    private final NumberPicker mDateSpinner;
-    private final NumberPicker mHourSpinner;
-    private final NumberPicker mMinuteSpinner;
-    private final NumberPicker mAmPmSpinner;
-    private Calendar mDate;
+    private final NumberPicker mDateSpinner;// 日期选择器
+    private final NumberPicker mHourSpinner;// 小时选择器
+    private final NumberPicker mMinuteSpinner;// 分钟选择器
+    private final NumberPicker mAmPmSpinner;// 上午/下午选择器
+    private Calendar mDate;// 日期对象
 
     private String[] mDateDisplayValues = new String[DAYS_IN_ALL_WEEK];
 
-    private boolean mIsAm;
-
-    private boolean mIs24HourView;
+    private boolean mIsAm;// 当前是上午还是下午
 
-    private boolean mIsEnabled = DEFAULT_ENABLE_STATE;
+    private boolean mIs24HourView;// 是否以24小时制显示时间
 
-    private boolean mInitialising;
+    private boolean mIsEnabled = DEFAULT_ENABLE_STATE;// 当前是否处于开启状态
 
-    private OnDateTimeChangedListener mOnDateTimeChangedListener;
+    private boolean mInitialising;// 是否正在初始化
 
+    private OnDateTimeChangedListener mOnDateTimeChangedListener; // 日期时间变化监听器
+    // 定义一个日期选择监听器，用于在用户调整日期选择器后更新日期值，并回调日期时间变化监听器
     private NumberPicker.OnValueChangeListener mOnDateChangedListener = new NumberPicker.OnValueChangeListener() {
+        // 当日期选择器的值改变时，更新日历的日期，更新日期显示，触发日期时间变化监听器
         @Override
         public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
+            // 计算日期变化的天数，并更新日历对象
             mDate.add(Calendar.DAY_OF_YEAR, newVal - oldVal);
+            // 更新日期选择器显示的日期
             updateDateControl();
+            // 通知监听器选择的日期时间发生变化
             onDateTimeChanged();
         }
     };
@@ -76,37 +80,49 @@ public class DateTimePicker extends FrameLayout {
     private NumberPicker.OnValueChangeListener mOnHourChangedListener = new NumberPicker.OnValueChangeListener() {
         @Override
         public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
+            // 默认日期没有变化
             boolean isDateChanged = false;
-            Calendar cal = Calendar.getInstance();
+            Calendar cal = Calendar.getInstance();// 新建一个Calendar对象
+            // 如果不是24小时制
             if (!mIs24HourView) {
+                // 如果之前是PM，并且从“下午12点”切换到“上午1点”，则日期加一
                 if (!mIsAm && oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY) {
                     cal.setTimeInMillis(mDate.getTimeInMillis());
                     cal.add(Calendar.DAY_OF_YEAR, 1);
                     isDateChanged = true;
-                } else if (mIsAm && oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) {
+                }
+                // 如果之前是AM，并且从“上午12点”切换到“下午11点”，则日期减一
+                else if (mIsAm && oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) {
                     cal.setTimeInMillis(mDate.getTimeInMillis());
                     cal.add(Calendar.DAY_OF_YEAR, -1);
                     isDateChanged = true;
                 }
+                // 如果从上午和下午之间切换，则更新AM/PM控件
                 if (oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY ||
                         oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) {
                     mIsAm = !mIsAm;
                     updateAmPmControl();
                 }
-            } else {
+            } else {// 如果是24小时制
+                // 如果从“23点”切换到“0点”，则日期加一
                 if (oldVal == HOURS_IN_ALL_DAY - 1 && newVal == 0) {
                     cal.setTimeInMillis(mDate.getTimeInMillis());
                     cal.add(Calendar.DAY_OF_YEAR, 1);
                     isDateChanged = true;
-                } else if (oldVal == 0 && newVal == HOURS_IN_ALL_DAY - 1) {
+                }
+                // 如果从“0点”切换到“23点”，则日期减一
+                else if (oldVal == 0 && newVal == HOURS_IN_ALL_DAY - 1) {
                     cal.setTimeInMillis(mDate.getTimeInMillis());
                     cal.add(Calendar.DAY_OF_YEAR, -1);
                     isDateChanged = true;
                 }
             }
+            // 根据新选择的时间更新日期时间对象
             int newHour = mHourSpinner.getValue() % HOURS_IN_HALF_DAY + (mIsAm ? 0 : HOURS_IN_HALF_DAY);
             mDate.set(Calendar.HOUR_OF_DAY, newHour);
+            // 回调onDateTimeChanged方法，通知监听器时间发生了变化
             onDateTimeChanged();
+            // 如果日期发生了变化，则更新日期控件
             if (isDateChanged) {
                 setCurrentYear(cal.get(Calendar.YEAR));
                 setCurrentMonth(cal.get(Calendar.MONTH));
@@ -118,14 +134,18 @@ public class DateTimePicker extends FrameLayout {
     private NumberPicker.OnValueChangeListener mOnMinuteChangedListener = new NumberPicker.OnValueChangeListener() {
         @Override
         public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
+            // 获取当前分钟数值选择范围
             int minValue = mMinuteSpinner.getMinValue();
             int maxValue = mMinuteSpinner.getMaxValue();
             int offset = 0;
+            // 如果从59切换到00，则小时数加一
             if (oldVal == maxValue && newVal == minValue) {
                 offset += 1;
+                // 如果从00切换到59，则小时数减一
             } else if (oldVal == minValue && newVal == maxValue) {
                 offset -= 1;
             }
+            // 如果小时数发生变化，则更新日期时间对象
             if (offset != 0) {
                 mDate.add(Calendar.HOUR_OF_DAY, offset);
                 mHourSpinner.setValue(getCurrentHour());
@@ -139,7 +159,9 @@ public class DateTimePicker extends FrameLayout {
                     updateAmPmControl();
                 }
             }
+            // 根据新选择的分钟数值更新日期时间对象
             mDate.set(Calendar.MINUTE, newVal);
+            // 回调onDateTimeChanged方法，通知监听器时间发生了变化
             onDateTimeChanged();
         }
     };
@@ -147,18 +169,23 @@ public class DateTimePicker extends FrameLayout {
     private NumberPicker.OnValueChangeListener mOnAmPmChangedListener = new NumberPicker.OnValueChangeListener() {
         @Override
         public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
+            // 切换am/pm标志位
             mIsAm = !mIsAm;
+            // 根据选择的am/pm更新日期时间对象
             if (mIsAm) {
                 mDate.add(Calendar.HOUR_OF_DAY, -HOURS_IN_HALF_DAY);
             } else {
                 mDate.add(Calendar.HOUR_OF_DAY, HOURS_IN_HALF_DAY);
             }
+            // 更新am/pm控件的状态
             updateAmPmControl();
+            // 回调onDateTimeChanged方法，通知监听器时间发生了变化
             onDateTimeChanged();
         }
     };
 
     public interface OnDateTimeChangedListener {
+        // 定义onDateTimeChanged方法，用于监听日期和时间的变化
         void onDateTimeChanged(DateTimePicker view, int year, int month,
                 int dayOfMonth, int hourOfDay, int minute);
     }