zhushi2

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

@@ -41,19 +41,26 @@ import java.io.IOException;
 
 
 public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener {
+    // 定义笔记ID和笔记摘要
     private long mNoteId;
     private String mSnippet;
+    // 定义笔记摘要的最大预览长度
     private static final int SNIPPET_PREW_MAX_LEN = 60;
+    // 定义MediaPlayer对象用于播放闹钟声音
     MediaPlayer mPlayer;
 
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
+        // 去掉标题栏
         requestWindowFeature(Window.FEATURE_NO_TITLE);
 
+        // 获取当前窗口对象
         final Window win = getWindow();
+        // 设置窗口标志，使应用在锁屏时也能显示
         win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED);
 
+        // 如果屏幕未亮，则设置窗口标志以保持屏幕常亮并点亮屏幕
         if (!isScreenOn()) {
             win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON
                     | WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON
@@ -61,11 +68,15 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
                     | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);
         }
 
+        // 获取启动当前Activity的Intent
         Intent intent = getIntent();
 
         try {
+            // 从Intent中获取笔记ID
             mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));
+            // 根据笔记ID获取笔记摘要
             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;
@@ -74,35 +85,47 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
             return;
         }
 
+        // 初始化MediaPlayer对象
         mPlayer = new MediaPlayer();
+        // 如果笔记在数据库中可见，则显示操作对话框并播放闹钟声音
         if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
             showActionDialog();
             playAlarmSound();
         } else {
+            // 否则结束当前Activity
             finish();
         }
     }
 
+    // 判断屏幕是否亮起
     private boolean isScreenOn() {
         PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
         return pm.isScreenOn();
     }
 
+    // 播放闹钟声音
     private void playAlarmSound() {
+        // 获取默认闹钟铃声的Uri
         Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);
 
+        // 获取当前静音模式下的音频流设置
         int silentModeStreams = Settings.System.getInt(getContentResolver(),
                 Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0);
 
+        // 如果闹钟音频流在静音模式下受影响，则设置MediaPlayer的音频流类型为静音模式下的音频流类型
         if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM)) != 0) {
             mPlayer.setAudioStreamType(silentModeStreams);
         } else {
             mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM);
         }
         try {
+            // 设置MediaPlayer的数据源
             mPlayer.setDataSource(this, url);
+            // 准备MediaPlayer
             mPlayer.prepare();
+            // 设置MediaPlayer循环播放
             mPlayer.setLooping(true);
+            // 开始播放
             mPlayer.start();
         } catch (IllegalArgumentException e) {
             // TODO Auto-generated catch block
@@ -119,39 +142,63 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
         }
     }
 
+    // 定义一个私有方法showActionDialog，用于显示一个操作对话框
     private void showActionDialog() {
+        // 创建一个AlertDialog.Builder对象，用于构建对话框
         AlertDialog.Builder dialog = new AlertDialog.Builder(this);
+        // 设置对话框的标题，使用资源文件中的app_name字符串
         dialog.setTitle(R.string.app_name);
+        // 设置对话框的消息内容，使用成员变量mSnippet的值
         dialog.setMessage(mSnippet);
+        // 设置对话框的确定按钮，按钮文本使用资源文件中的notealert_ok字符串，点击事件监听器为当前对象
         dialog.setPositiveButton(R.string.notealert_ok, this);
+        // 检查屏幕是否处于开启状态
         if (isScreenOn()) {
+            // 如果屏幕开启，则设置对话框的取消按钮，按钮文本使用资源文件中的notealert_enter字符串，点击事件监听器为当前对象
             dialog.setNegativeButton(R.string.notealert_enter, this);
         }
+        // 显示对话框，并设置对话框消失时的监听器为当前对象
         dialog.show().setOnDismissListener(this);
     }
 
+    // 定义一个方法来处理对话框点击事件
     public void onClick(DialogInterface dialog, int which) {
+        // 使用switch语句根据点击的按钮类型进行不同的处理
         switch (which) {
+            // 如果点击的是否定按钮（例如“取消”或“否”）
             case DialogInterface.BUTTON_NEGATIVE:
+                // 创建一个新的Intent对象，用于启动NoteEditActivity
                 Intent intent = new Intent(this, NoteEditActivity.class);
+                // 设置Intent的动作类型为查看（ACTION_VIEW）
                 intent.setAction(Intent.ACTION_VIEW);
+                // 向Intent中添加一个额外的数据，即笔记的ID
                 intent.putExtra(Intent.EXTRA_UID, mNoteId);
+                // 启动NoteEditActivity，传递Intent对象
                 startActivity(intent);
                 break;
+            // 默认情况下，不进行任何操作
             default:
                 break;
         }
     }
 
+    // 定义一个方法，当对话框被取消或关闭时调用
     public void onDismiss(DialogInterface dialog) {
+        // 调用stopAlarmSound方法，停止报警声音
         stopAlarmSound();
+        // 调用finish方法，结束当前Activity
         finish();
     }
 
+    // 停止报警声音的方法
     private void stopAlarmSound() {
+        // 检查mPlayer对象是否不为空，以避免空指针异常
         if (mPlayer != null) {
+            // 调用mPlayer的stop方法停止播放声音
             mPlayer.stop();
+            // 调用mPlayer的release方法释放资源
             mPlayer.release();
+            // 将mPlayer对象设置为null，表示不再使用
             mPlayer = null;
         }
     }

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

@@ -30,35 +30,51 @@ import net.micode.notes.data.Notes.NoteColumns;
 
 public class AlarmInitReceiver extends BroadcastReceiver {
 
+    // 定义查询所需的列
     private static final String [] PROJECTION = new String [] {
-        NoteColumns.ID,
+        NoteColumns.ID,            // 笔记的ID
-        NoteColumns.ALERTED_DATE
+        NoteColumns.ALERTED_DATE   // 笔记的提醒日期
     };
 
-    private static final int COLUMN_ID                = 0;
+
-    private static final int COLUMN_ALERTED_DATE      = 1;
+
+    // 定义列的索引
+    private static final int COLUMN_ID                = 0;    // ID列的索引
+    private static final int COLUMN_ALERTED_DATE      = 1;    // 提醒日期列的索引
 
     @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) },
+                new String[] { String.valueOf(currentDate) }, // 查询条件参数
-                null);
+                null); // 排序参数
 
+        // 如果查询结果不为空
         if (c != null) {
+            // 如果有记录
             if (c.moveToFirst()) {
+                // 遍历所有记录
                 do {
+                    // 获取提醒日期
                     long alertDate = c.getLong(COLUMN_ALERTED_DATE);
+                    // 创建一个新的Intent，用于启动AlarmReceiver
                     Intent sender = new Intent(context, AlarmReceiver.class);
+                    // 设置Intent的数据URI，包含笔记的ID
                     sender.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, c.getLong(COLUMN_ID)));
+                    // 创建PendingIntent，用于延迟执行Intent
                     PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, sender, 0);
+                    // 获取AlarmManager服务
                     AlarmManager alermManager = (AlarmManager) context
                             .getSystemService(Context.ALARM_SERVICE);
+                    // 设置闹钟，在指定时间唤醒设备并执行Intent
                     alermManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent);
-                } while (c.moveToNext());
+                } while (c.moveToNext()); // 移动到下一条记录
             }
+            // 关闭Cursor
             c.close();
         }
     }

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

@@ -20,11 +20,16 @@ import android.content.BroadcastReceiver;
 import android.content.Context;
 import android.content.Intent;
 
+// 定义一个名为AlarmReceiver的类，继承自BroadcastReceiver，用于接收广播消息
 public class AlarmReceiver extends BroadcastReceiver {
+    // 重写onReceive方法，该方法会在接收到广播时被调用
     @Override
     public void onReceive(Context context, Intent intent) {
+        // 将Intent的目标组件设置为AlarmAlertActivity类，即指定广播接收后要启动的Activity
         intent.setClass(context, AlarmAlertActivity.class);
+        // 向Intent中添加FLAG_ACTIVITY_NEW_TASK标志，表示启动一个新的任务来承载该Activity
         intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        // 使用上下文context启动Activity，传入设置好的Intent对象
         context.startActivity(intent);
     }
 }

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

@@ -30,40 +30,66 @@ 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;
+    // 一天的小时数
     private static final int HOURS_IN_ALL_DAY = 24;
+    // 一周的天数
     private static final int DAYS_IN_ALL_WEEK = 7;
+    // 日期选择器的最小值
     private static final int DATE_SPINNER_MIN_VAL = 0;
+    // 日期选择器的最大值
     private static final int DATE_SPINNER_MAX_VAL = DAYS_IN_ALL_WEEK - 1;
+    // 24小时制小时选择器的最小值
     private static final int HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW = 0;
+    // 24小时制小时选择器的最大值
     private static final int HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW = 23;
+    // 12小时制小时选择器的最小值
     private static final int HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW = 1;
+    // 12小时制小时选择器的最大值
     private static final int HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW = 12;
+    // 分钟选择器的最小值
     private static final int MINUT_SPINNER_MIN_VAL = 0;
+    // 分钟选择器的最大值
     private static final int MINUT_SPINNER_MAX_VAL = 59;
+    // AM/PM选择器的最小值
     private static final int AMPM_SPINNER_MIN_VAL = 0;
+    // AM/PM选择器的最大值
     private static final int AMPM_SPINNER_MAX_VAL = 1;
 
+    // 日期选择器
     private final NumberPicker mDateSpinner;
+    // 小时选择器
     private final NumberPicker mHourSpinner;
+    // 分钟选择器
     private final NumberPicker mMinuteSpinner;
+    // AM/PM选择器
     private final NumberPicker mAmPmSpinner;
+    // 日期对象
     private Calendar mDate;
 
+    // 日期显示值数组
     private String[] mDateDisplayValues = new String[DAYS_IN_ALL_WEEK];
 
+    // 是否为AM
     private boolean mIsAm;
 
+    // 是否为24小时制
     private boolean mIs24HourView;
 
+    // 是否启用
     private boolean mIsEnabled = DEFAULT_ENABLE_STATE;
 
+    // 是否正在初始化
     private boolean mInitialising;
 
+    // 日期时间变化监听器
     private OnDateTimeChangedListener mOnDateTimeChangedListener;
 
+    // 日期变化监听器
     private NumberPicker.OnValueChangeListener mOnDateChangedListener = new NumberPicker.OnValueChangeListener() {
         @Override
         public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
@@ -73,6 +99,7 @@ public class DateTimePicker extends FrameLayout {
         }
     };
 
+    // 小时变化监听器
     private NumberPicker.OnValueChangeListener mOnHourChangedListener = new NumberPicker.OnValueChangeListener() {
         @Override
         public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
@@ -115,6 +142,7 @@ public class DateTimePicker extends FrameLayout {
         }
     };
 
+    // 分钟变化监听器
     private NumberPicker.OnValueChangeListener mOnMinuteChangedListener = new NumberPicker.OnValueChangeListener() {
         @Override
         public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
@@ -144,6 +172,7 @@ public class DateTimePicker extends FrameLayout {
         }
     };
 
+    // AM/PM变化监听器
     private NumberPicker.OnValueChangeListener mOnAmPmChangedListener = new NumberPicker.OnValueChangeListener() {
         @Override
         public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
@@ -158,39 +187,62 @@ public class DateTimePicker extends FrameLayout {
         }
     };
 
+    // 日期时间变化监听器接口
     public interface OnDateTimeChangedListener {
         void onDateTimeChanged(DateTimePicker view, int year, int month,
                 int dayOfMonth, int hourOfDay, int minute);
     }
 
+    // 构造函数
+    // 构造函数，用于创建DateTimePicker对象
+    // 参数context：上下文对象，用于获取应用环境和资源
     public DateTimePicker(Context context) {
+        // 调用另一个构造函数，传入当前系统时间作为默认时间
+        // System.currentTimeMillis()：获取当前系统时间的毫秒值
         this(context, System.currentTimeMillis());
     }
 
+    // 构造函数，用于创建DateTimePicker对象
+    // 参数context：上下文对象，用于获取系统资源和配置
+    // 参数date：初始日期时间，以毫秒为单位的长整型数值
     public DateTimePicker(Context context, long date) {
+        // 调用另一个构造函数，传入上下文对象、初始日期时间和是否使用24小时制
+        // DateFormat.is24HourFormat(context)方法用于判断当前系统是否使用24小时制
         this(context, date, DateFormat.is24HourFormat(context));
     }
 
+    // 构造函数，用于初始化DateTimePicker对象
     public DateTimePicker(Context context, long date, boolean is24HourView) {
+        // 调用父类的构造函数，传入上下文
         super(context);
+        // 初始化Calendar对象，用于存储日期和时间
         mDate = Calendar.getInstance();
+        // 设置初始化标志为true，表示正在初始化
         mInitialising = true;
+        // 判断当前时间是上午还是下午
         mIsAm = getCurrentHourOfDay() >= HOURS_IN_HALF_DAY;
+        // 加载布局文件datetime_picker.xml，并将其添加到当前视图
         inflate(context, R.layout.datetime_picker, this);
 
+        // 获取日期选择器NumberPicker，并设置其最小值和最大值
         mDateSpinner = (NumberPicker) findViewById(R.id.date);
         mDateSpinner.setMinValue(DATE_SPINNER_MIN_VAL);
         mDateSpinner.setMaxValue(DATE_SPINNER_MAX_VAL);
+        // 设置日期选择器的值变化监听器
         mDateSpinner.setOnValueChangedListener(mOnDateChangedListener);
 
+        // 获取小时选择器NumberPicker，并设置其值变化监听器
         mHourSpinner = (NumberPicker) findViewById(R.id.hour);
         mHourSpinner.setOnValueChangedListener(mOnHourChangedListener);
+        // 获取分钟选择器NumberPicker，并设置其最小值、最大值和长按更新间隔
         mMinuteSpinner =  (NumberPicker) findViewById(R.id.minute);
         mMinuteSpinner.setMinValue(MINUT_SPINNER_MIN_VAL);
         mMinuteSpinner.setMaxValue(MINUT_SPINNER_MAX_VAL);
         mMinuteSpinner.setOnLongPressUpdateInterval(100);
+        // 设置分钟选择器的值变化监听器
         mMinuteSpinner.setOnValueChangedListener(mOnMinuteChangedListener);
 
+        // 获取上午/下午选择器NumberPicker，并设置其显示值和值变化监听器
         String[] stringsForAmPm = new DateFormatSymbols().getAmPmStrings();
         mAmPmSpinner = (NumberPicker) findViewById(R.id.amPm);
         mAmPmSpinner.setMinValue(AMPM_SPINNER_MIN_VAL);
@@ -216,19 +268,28 @@ public class DateTimePicker extends FrameLayout {
 
     @Override
     public void setEnabled(boolean enabled) {
+        // 检查当前状态是否与要设置的状态相同，如果相同则直接返回，避免重复设置
         if (mIsEnabled == enabled) {
             return;
         }
+        // 调用父类的setEnabled方法，设置组件的基本启用状态
         super.setEnabled(enabled);
+        // 设置日期选择器的启用状态
         mDateSpinner.setEnabled(enabled);
+        // 设置分钟选择器的启用状态
         mMinuteSpinner.setEnabled(enabled);
+        // 设置小时选择器的启用状态
         mHourSpinner.setEnabled(enabled);
+        // 设置上午/下午选择器的启用状态
         mAmPmSpinner.setEnabled(enabled);
+        // 更新当前组件的启用状态标志
         mIsEnabled = enabled;
     }
 
+    // 重写父类或接口中的isEnabled方法
     @Override
     public boolean isEnabled() {
+        // 返回成员变量mIsEnabled的值，表示当前对象是否启用
         return mIsEnabled;
     }
 
@@ -246,9 +307,13 @@ public class DateTimePicker extends FrameLayout {
      *
      * @param date The current date in millis
      */
+    // 定义一个方法用于设置当前日期和时间
     public void setCurrentDate(long date) {
+        // 获取一个Calendar实例
         Calendar cal = Calendar.getInstance();
+        // 将传入的日期（以毫秒为单位）设置到Calendar对象中
         cal.setTimeInMillis(date);
+        // 调用另一个重载的setCurrentDate方法，传入年、月、日、小时和分钟
         setCurrentDate(cal.get(Calendar.YEAR), cal.get(Calendar.MONTH), cal.get(Calendar.DAY_OF_MONTH),
                 cal.get(Calendar.HOUR_OF_DAY), cal.get(Calendar.MINUTE));
     }
@@ -262,12 +327,18 @@ public class DateTimePicker extends FrameLayout {
      * @param hourOfDay The current hourOfDay
      * @param minute The current minute
      */
+    // 定义一个方法用于设置当前日期和时间
     public void setCurrentDate(int year, int month,
             int dayOfMonth, int hourOfDay, int minute) {
+        // 调用设置年份的方法，传入年份参数
         setCurrentYear(year);
+        // 调用设置月份的方法，传入月份参数
         setCurrentMonth(month);
+        // 调用设置日期的方法，传入日期参数
         setCurrentDay(dayOfMonth);
+        // 调用设置小时的方法，传入小时参数
         setCurrentHour(hourOfDay);
+        // 调用设置分钟的方法，传入分钟参数
         setCurrentMinute(minute);
     }
 
@@ -276,7 +347,9 @@ public class DateTimePicker extends FrameLayout {
      *
      * @return The current year
      */
+    // 定义一个公共方法，用于获取当前年份
     public int getCurrentYear() {
+        // 调用mDate对象的get方法，传入Calendar.YEAR常量，获取当前年份
         return mDate.get(Calendar.YEAR);
     }
 
@@ -285,12 +358,17 @@ public class DateTimePicker extends FrameLayout {
      *
      * @param year The current year
      */
+    // 设置当前年份的方法
     public void setCurrentYear(int year) {
+        // 检查是否正在初始化且年份与当前年份相同，如果是则直接返回，不进行任何操作
         if (!mInitialising && year == getCurrentYear()) {
             return;
         }
+        // 使用Calendar对象设置日期的年份为传入的年份
         mDate.set(Calendar.YEAR, year);
+        // 更新日期控件，以反映新的年份
         updateDateControl();
+        // 调用方法处理日期时间变化，可能触发相关事件或更新UI
         onDateTimeChanged();
     }
 
@@ -299,7 +377,10 @@ public class DateTimePicker extends FrameLayout {
      *
      * @return The current month in the year
      */
+    // 定义一个公共方法，用于获取当前月份
     public int getCurrentMonth() {
+        // 调用mDate对象的get方法，传入Calendar.MONTH常量，获取当前月份
+        // Calendar.MONTH的值是从0开始的，即0代表一月，1代表二月，依此类推
         return mDate.get(Calendar.MONTH);
     }
 
@@ -308,12 +389,18 @@ public class DateTimePicker extends FrameLayout {
      *
      * @param month The month in the year
      */
+    // 设置当前月份的方法
     public void setCurrentMonth(int month) {
+        // 检查是否正在初始化以及传入的月份是否与当前月份相同
+        // 如果是，则直接返回，不进行任何操作
         if (!mInitialising && month == getCurrentMonth()) {
             return;
         }
+        // 使用Calendar对象设置日期的月份
         mDate.set(Calendar.MONTH, month);
+        // 更新日期控件，以反映新的月份设置
         updateDateControl();
+        // 调用方法处理日期时间变化，可能触发相关事件或更新UI
         onDateTimeChanged();
     }
 
@@ -322,7 +409,9 @@ public class DateTimePicker extends FrameLayout {
      *
      * @return The day of the month
      */
+    // 定义一个公共方法，用于获取当前日期的天数
     public int getCurrentDay() {
+        // 调用Calendar对象的get方法，传入Calendar.DAY_OF_MONTH常量，获取当前日期的天数
         return mDate.get(Calendar.DAY_OF_MONTH);
     }
 
@@ -331,12 +420,17 @@ public class DateTimePicker extends FrameLayout {
      *
      * @param dayOfMonth The day of the month
      */
+    // 设置当前日期的天数
     public void setCurrentDay(int dayOfMonth) {
+        // 检查是否正在初始化并且传入的天数与当前天数相同，如果是则直接返回
         if (!mInitialising && dayOfMonth == getCurrentDay()) {
             return;
         }
+        // 使用Calendar对象设置日期的天数
         mDate.set(Calendar.DAY_OF_MONTH, dayOfMonth);
+        // 更新日期控件
         updateDateControl();
+        // 触发日期时间变化事件
         onDateTimeChanged();
     }
 
@@ -344,18 +438,28 @@ public class DateTimePicker extends FrameLayout {
      * Get current hour in 24 hour mode, in the range (0~23)
      * @return The current hour in 24 hour mode
      */
+    // 定义一个公共方法，用于获取当前的小时数（24小时制）
     public int getCurrentHourOfDay() {
+        // 调用Calendar对象的get方法，传入Calendar.HOUR_OF_DAY常量，获取当前的小时数
         return mDate.get(Calendar.HOUR_OF_DAY);
     }
 
+    // 获取当前小时数的私有方法
     private int getCurrentHour() {
+        // 检查是否使用24小时制
         if (mIs24HourView){
+            // 如果是24小时制，直接返回当前的小时数
             return getCurrentHourOfDay();
         } else {
+            // 如果不是24小时制，先获取当前的小时数
             int hour = getCurrentHourOfDay();
+            // 检查当前小时数是否超过半天（12小时）
             if (hour > HOURS_IN_HALF_DAY) {
+                // 如果超过半天，返回当前小时数减去半天的小时数（转换为下午的小时数）
                 return hour - HOURS_IN_HALF_DAY;
             } else {
+                // 如果当前小时数是0（表示午夜12点），则返回半天的小时数（12）
+                // 否则，直接返回当前小时数（表示上午的小时数）
                 return hour == 0 ? HOURS_IN_HALF_DAY : hour;
             }
         }
@@ -366,26 +470,37 @@ public class DateTimePicker extends FrameLayout {
      *
      * @param hourOfDay
      */
+    // 设置当前小时的方法
     public void setCurrentHour(int hourOfDay) {
+        // 检查是否正在初始化并且小时数是否与当前小时相同，如果是则直接返回
         if (!mInitialising && hourOfDay == getCurrentHourOfDay()) {
             return;
         }
+        // 使用Calendar对象设置小时数
         mDate.set(Calendar.HOUR_OF_DAY, hourOfDay);
+        // 检查是否为24小时制
         if (!mIs24HourView) {
+            // 如果小时数大于等于半天的小时数（12小时），则设置为下午
             if (hourOfDay >= HOURS_IN_HALF_DAY) {
                 mIsAm = false;
+                // 如果小时数大于半天的小时数（12小时），则减去半天的小时数
                 if (hourOfDay > HOURS_IN_HALF_DAY) {
                     hourOfDay -= HOURS_IN_HALF_DAY;
                 }
             } else {
+                // 否则设置为上午
                 mIsAm = true;
+                // 如果小时数为0，则设置为半天的小时数（12小时）
                 if (hourOfDay == 0) {
                     hourOfDay = HOURS_IN_HALF_DAY;
                 }
             }
+            // 更新上午/下午控件
             updateAmPmControl();
         }
+        // 设置小时选择器的值
         mHourSpinner.setValue(hourOfDay);
+        // 触发时间变化事件
         onDateTimeChanged();
     }
 
@@ -394,26 +509,36 @@ public class DateTimePicker extends FrameLayout {
      *
      * @return The Current Minute
      */
+    // 定义一个公共方法，用于获取当前分钟数
     public int getCurrentMinute() {
+        // 调用mDate对象的get方法，传入Calendar.MINUTE常量，获取当前时间的分钟数
         return mDate.get(Calendar.MINUTE);
     }
 
     /**
      * Set current minute
      */
+    // 设置当前分钟的方法
     public void setCurrentMinute(int minute) {
+        // 检查是否正在初始化并且分钟值是否与当前分钟相同
         if (!mInitialising && minute == getCurrentMinute()) {
+            // 如果是，则直接返回，不做任何操作
             return;
         }
+        // 设置分钟选择器的值为传入的分钟值
         mMinuteSpinner.setValue(minute);
+        // 更新日期对象的分钟字段为传入的分钟值
         mDate.set(Calendar.MINUTE, minute);
+        // 调用方法通知时间已更改
         onDateTimeChanged();
     }
 
     /**
      * @return true if this is in 24 hour view else false.
      */
+    // 定义一个公共的方法，用于判断是否为24小时制视图
     public boolean is24HourView () {
+        // 返回成员变量mIs24HourView的值，该变量用于存储是否为24小时制的状态
         return mIs24HourView;
     }
 
@@ -422,48 +547,80 @@ public class DateTimePicker extends FrameLayout {
      *
      * @param is24HourView True for 24 hour mode. False for AM/PM mode.
      */
+    // 设置24小时制视图
     public void set24HourView(boolean is24HourView) {
+        // 如果当前24小时制视图状态与传入的参数相同，则直接返回，不做任何操作
         if (mIs24HourView == is24HourView) {
             return;
         }
+        // 更新24小时制视图状态
         mIs24HourView = is24HourView;
+        // 根据是否为24小时制视图，设置上午/下午选择器的可见性
+        // 如果是24小时制，则隐藏上午/下午选择器；否则显示
         mAmPmSpinner.setVisibility(is24HourView ? View.GONE : View.VISIBLE);
+        // 获取当前的小时数
         int hour = getCurrentHourOfDay();
+        // 更新小时控制部分
         updateHourControl();
+        // 设置当前小时数
         setCurrentHour(hour);
+        // 更新上午/下午控制部分
         updateAmPmControl();
     }
 
+    // 更新日期控件的方法
     private void updateDateControl() {
+        // 获取当前时间的Calendar实例
         Calendar cal = Calendar.getInstance();
+        // 将Calendar实例的时间设置为mDate的时间
         cal.setTimeInMillis(mDate.getTimeInMillis());
+        // 将日期向前调整一周的一半再加一天，即调整到当前周的起始日期
         cal.add(Calendar.DAY_OF_YEAR, -DAYS_IN_ALL_WEEK / 2 - 1);
+        // 清除日期选择器的显示值
         mDateSpinner.setDisplayedValues(null);
+        // 遍历一周的每一天
         for (int i = 0; i < DAYS_IN_ALL_WEEK; ++i) {
+            // 每次循环将日期加一天
             cal.add(Calendar.DAY_OF_YEAR, 1);
+            // 将格式化后的日期字符串存储到mDateDisplayValues数组中
             mDateDisplayValues[i] = (String) DateFormat.format("MM.dd EEEE", cal);
         }
+        // 设置日期选择器的显示值为更新后的日期数组
         mDateSpinner.setDisplayedValues(mDateDisplayValues);
+        // 设置日期选择器的当前值为一周的中间日期
         mDateSpinner.setValue(DAYS_IN_ALL_WEEK / 2);
+        // 刷新日期选择器，使其显示最新的值
         mDateSpinner.invalidate();
     }
 
+    // 定义一个私有方法updateAmPmControl，用于更新上午/下午选择控件的状态
     private void updateAmPmControl() {
+        // 检查是否为24小时制视图
         if (mIs24HourView) {
+            // 如果是24小时制视图，隐藏上午/下午选择控件
             mAmPmSpinner.setVisibility(View.GONE);
         } else {
+            // 如果不是24小时制视图，根据当前是上午还是下午设置选择控件的值
             int index = mIsAm ? Calendar.AM : Calendar.PM;
+            // 设置上午/下午选择控件的值为index
             mAmPmSpinner.setValue(index);
+            // 显示上午/下午选择控件
             mAmPmSpinner.setVisibility(View.VISIBLE);
         }
     }
 
+    // 定义一个私有方法updateHourControl，用于更新小时选择器的范围
     private void updateHourControl() {
+        // 检查是否是24小时制视图
         if (mIs24HourView) {
+            // 如果是24小时制视图，设置小时选择器的最小值为HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW
             mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW);
+            // 设置小时选择器的最大值为HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW
             mHourSpinner.setMaxValue(HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW);
         } else {
+            // 如果不是24小时制视图，设置小时选择器的最小值为HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW
             mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW);
+            // 设置小时选择器的最大值为HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW
             mHourSpinner.setMaxValue(HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW);
         }
     }
@@ -472,12 +629,18 @@ public class DateTimePicker extends FrameLayout {
      * Set the callback that indicates the 'Set' button has been pressed.
      * @param callback the callback, if null will do nothing
      */
+    // 定义一个方法用于设置日期时间变化监听器
     public void setOnDateTimeChangedListener(OnDateTimeChangedListener callback) {
+        // 将传入的监听器对象赋值给类的成员变量mOnDateTimeChangedListener
         mOnDateTimeChangedListener = callback;
     }
 
+    // 定义一个私有方法，用于处理日期时间变化事件
     private void onDateTimeChanged() {
+        // 检查是否已经设置了日期时间变化监听器
         if (mOnDateTimeChangedListener != null) {
+            // 如果监听器不为空，则调用监听器的onDateTimeChanged方法
+            // 传递当前对象以及当前的年、月、日、小时和分钟
             mOnDateTimeChangedListener.onDateTimeChanged(this, getCurrentYear(),
                     getCurrentMonth(), getCurrentDay(), getCurrentHourOfDay(), getCurrentMinute());
         }

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

@@ -31,30 +31,42 @@ import android.text.format.DateUtils;
 
 public class DateTimePickerDialog extends AlertDialog implements OnClickListener {
 
+    // 定义一个日历对象，用于存储日期和时间
     private Calendar mDate = Calendar.getInstance();
+    // 是否使用24小时制
     private boolean mIs24HourView;
+    // 日期时间设置监听器
     private OnDateTimeSetListener mOnDateTimeSetListener;
+    // 日期时间选择器
     private DateTimePicker mDateTimePicker;
 
+    // 定义一个接口，用于监听日期时间的设置
     public interface OnDateTimeSetListener {
         void OnDateTimeSet(AlertDialog dialog, long date);
     }
 
+    // 构造函数，初始化对话框
     public DateTimePickerDialog(Context context, long date) {
         super(context);
+        // 创建日期时间选择器
         mDateTimePicker = new DateTimePicker(context);
+        // 设置对话框的视图为日期时间选择器
         setView(mDateTimePicker);
+        // 设置日期时间选择器的监听器
         mDateTimePicker.setOnDateTimeChangedListener(new OnDateTimeChangedListener() {
             public void onDateTimeChanged(DateTimePicker view, int year, int month,
                     int dayOfMonth, int hourOfDay, int minute) {
+                // 更新日历对象的日期和时间
                 mDate.set(Calendar.YEAR, year);
                 mDate.set(Calendar.MONTH, month);
                 mDate.set(Calendar.DAY_OF_MONTH, dayOfMonth);
                 mDate.set(Calendar.HOUR_OF_DAY, hourOfDay);
                 mDate.set(Calendar.MINUTE, minute);
+                // 更新对话框标题
                 updateTitle(mDate.getTimeInMillis());
             }
         });
+        // 设置日历对象的时间
         mDate.setTimeInMillis(date);
         mDate.set(Calendar.SECOND, 0);
         mDateTimePicker.setCurrentDate(mDate.getTimeInMillis());
@@ -64,25 +76,44 @@ public class DateTimePickerDialog extends AlertDialog implements OnClickListener
         updateTitle(mDate.getTimeInMillis());
     }
 
+    // 定义一个公共方法，用于设置是否使用24小时制视图
     public void set24HourView(boolean is24HourView) {
+        // 将传入的布尔值参数is24HourView赋值给成员变量mIs24HourView
         mIs24HourView = is24HourView;
     }
 
+    // 定义一个方法用于设置日期时间设置监听器
     public void setOnDateTimeSetListener(OnDateTimeSetListener callBack) {
+        // 将传入的监听器对象赋值给成员变量mOnDateTimeSetListener
         mOnDateTimeSetListener = callBack;
     }
 
+    // 定义一个私有方法updateTitle，用于更新标题，接收一个长整型参数date表示日期时间
     private void updateTitle(long date) {
+        // 定义一个整型变量flag，用于存储日期时间的格式标志
         int flag =
+            // 使用位或运算符将FORMAT_SHOW_YEAR标志添加到flag中，表示显示年份
             DateUtils.FORMAT_SHOW_YEAR |
+            // 使用位或运算符将FORMAT_SHOW_DATE标志添加到flag中，表示显示日期
             DateUtils.FORMAT_SHOW_DATE |
+            // 使用位或运算符将FORMAT_SHOW_TIME标志添加到flag中，表示显示时间
             DateUtils.FORMAT_SHOW_TIME;
+        // 使用位或运算符将FORMAT_24HOUR标志添加到flag中
+        // 如果mIs24HourView为true，则添加FORMAT_24HOUR标志，表示使用24小时制
+        // 如果mIs24HourView为false，则也添加FORMAT_24HOUR标志，这里可能是一个逻辑错误，应该根据mIs24HourView的值决定是否添加该标志
         flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_24HOUR;
+        // 调用DateUtils的formatDateTime方法，将日期时间格式化为字符串
+        // this.getContext()获取当前上下文
+        // date为要格式化的日期时间
+        // flag为格式标志
         setTitle(DateUtils.formatDateTime(this.getContext(), date, flag));
     }
 
+    // 定义一个方法，当对话框被点击时触发
     public void onClick(DialogInterface arg0, int arg1) {
+        // 检查mOnDateTimeSetListener是否不为空，确保有监听器注册
         if (mOnDateTimeSetListener != null) {
+            // 调用mOnDateTimeSetListener的OnDateTimeSet方法，传递当前对象和日期的毫秒值
             mOnDateTimeSetListener.OnDateTimeSet(this, mDate.getTimeInMillis());
         }
     }

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

@@ -28,34 +28,61 @@ import android.widget.PopupMenu.OnMenuItemClickListener;
 import net.micode.notes.R;
 
 public class DropdownMenu {
+    // 声明一个Button对象，用于显示下拉菜单的按钮
     private Button mButton;
+    // 声明一个PopupMenu对象，用于创建和管理下拉菜单
     private PopupMenu mPopupMenu;
+    // 声明一个Menu对象，用于获取菜单项
     private Menu mMenu;
 
+    // 构造方法，初始化DropdownMenu对象
     public DropdownMenu(Context context, Button button, int menuId) {
+        // 将传入的Button对象赋值给mButton
         mButton = button;
+        // 设置按钮的背景资源为下拉图标
         mButton.setBackgroundResource(R.drawable.dropdown_icon);
+        // 创建一个PopupMenu对象，传入上下文和按钮对象
         mPopupMenu = new PopupMenu(context, mButton);
+        // 获取PopupMenu的Menu对象
         mMenu = mPopupMenu.getMenu();
+        // 使用PopupMenu的MenuInflater对象加载菜单布局文件
         mPopupMenu.getMenuInflater().inflate(menuId, mMenu);
+        // 设置按钮的点击监听器
         mButton.setOnClickListener(new OnClickListener() {
+            // 点击按钮时显示PopupMenu
             public void onClick(View v) {
                 mPopupMenu.show();
             }
         });
     }
 
+    // 设置下拉菜单项的点击监听器
+    // 定义一个方法用于设置下拉菜单项的点击监听器
     public void setOnDropdownMenuItemClickListener(OnMenuItemClickListener listener) {
+        // 如果PopupMenu对象不为空，则设置菜单项点击监听器
         if (mPopupMenu != null) {
             mPopupMenu.setOnMenuItemClickListener(listener);
         }
     }
 
+    // 根据菜单项的ID查找菜单项
     public MenuItem findItem(int id) {
+
+        // 调用mMenu对象的findItem方法，传入菜单项的id
+        // mMenu是一个菜单对象，用于管理菜单项
+        // findItem方法用于在菜单中查找指定id的菜单项
+        // id是菜单项的唯一标识符，通常是一个整型常量
+        // 返回找到的菜单项对象，如果未找到则返回null
         return mMenu.findItem(id);
     }
 
+    // 设置按钮的标题
     public void setTitle(CharSequence title) {
+        // 将传入的标题设置给按钮
+        // 参数说明：
+        // CharSequence title - 要设置的标题文本
+        // 功能说明：
+        // 该方法用于将传入的标题文本设置给成员变量mButton，即按钮的文本内容
         mButton.setText(title);
     }
 }

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

@@ -30,50 +30,63 @@ import net.micode.notes.data.Notes.NoteColumns;
 
 
 public class FoldersListAdapter extends CursorAdapter {
+    // 定义查询的列
     public static final String [] PROJECTION = {
-        NoteColumns.ID,
+        NoteColumns.ID, // 笔记ID
-        NoteColumns.SNIPPET
+        NoteColumns.SNIPPET // 笔记摘要
     };
 
-    public static final int ID_COLUMN   = 0;
-    public static final int NAME_COLUMN = 1;
 
+
+    // 定义列的索引
+    public static final int ID_COLUMN   = 0; // ID列的索引
+    public static final int NAME_COLUMN = 1; // 名称列的索引
+
+    // 构造函数
     public FoldersListAdapter(Context context, Cursor c) {
         super(context, c);
         // TODO Auto-generated constructor stub
     }
 
+    // 创建新的视图
     @Override
     public View newView(Context context, Cursor cursor, ViewGroup parent) {
-        return new FolderListItem(context);
+        return new FolderListItem(context); // 返回一个新的FolderListItem视图
     }
 
+    // 绑定数据到视图
     @Override
     public void bindView(View view, Context context, Cursor cursor) {
-        if (view instanceof FolderListItem) {
+        if (view instanceof FolderListItem) { // 如果视图是FolderListItem类型
+            // 获取文件夹名称，如果是根文件夹则显示特定的字符串
             String folderName = (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context
                     .getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN);
-            ((FolderListItem) view).bind(folderName);
+            ((FolderListItem) view).bind(folderName); // 绑定文件夹名称到视图
         }
     }
 
+    // 获取指定位置的文件夹名称
     public String getFolderName(Context context, int position) {
-        Cursor cursor = (Cursor) getItem(position);
+        Cursor cursor = (Cursor) getItem(position); // 获取指定位置的Cursor
+        // 如果是根文件夹则显示特定的字符串
         return (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context
                 .getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN);
     }
 
+    // 内部类FolderListItem，继承自LinearLayout
     private class FolderListItem extends LinearLayout {
-        private TextView mName;
+        private TextView mName; // 文本视图，用于显示文件夹名称
 
+        // 构造函数
         public FolderListItem(Context context) {
             super(context);
-            inflate(context, R.layout.folder_list_item, this);
+            inflate(context, R.layout.folder_list_item, this); // 加载布局文件
-            mName = (TextView) findViewById(R.id.tv_folder_name);
+            mName = (TextView) findViewById(R.id.tv_folder_name); // 获取布局中的文本视图
         }
 
+        // 绑定文件夹名称到文本视图
         public void bind(String name) {
-            mName.setText(name);
+            mName.setText(name); // 设置文本视图的文本
         }
     }
 

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

@@ -74,16 +74,18 @@ import java.util.regex.Pattern;
 
 public class NoteEditActivity extends Activity implements OnClickListener,
         NoteSettingChangedListener, OnTextViewChangeListener {
+    // 定义一个内部类，用于保存头部视图的引用
     private class HeadViewHolder {
-        public TextView tvModified;
+        public TextView tvModified; // 显示修改日期的TextView
 
-        public ImageView ivAlertIcon;
+        public ImageView ivAlertIcon; // 显示提醒图标的ImageView
 
-        public TextView tvAlertDate;
+        public TextView tvAlertDate; // 显示提醒日期的TextView
 
-        public ImageView ibSetBgColor;
+        public ImageView ibSetBgColor; // 设置背景颜色的ImageView
     }
 
+    // 定义背景颜色选择按钮与背景颜色值的映射
     private static final Map<Integer, Integer> sBgSelectorBtnsMap = new HashMap<Integer, Integer>();
     static {
         sBgSelectorBtnsMap.put(R.id.iv_bg_yellow, ResourceParser.YELLOW);
@@ -93,6 +95,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         sBgSelectorBtnsMap.put(R.id.iv_bg_white, ResourceParser.WHITE);
     }
 
+    // 定义背景颜色值与选中状态的映射
     private static final Map<Integer, Integer> sBgSelectorSelectionMap = new HashMap<Integer, Integer>();
     static {
         sBgSelectorSelectionMap.put(ResourceParser.YELLOW, R.id.iv_bg_yellow_select);
@@ -102,6 +105,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         sBgSelectorSelectionMap.put(ResourceParser.WHITE, R.id.iv_bg_white_select);
     }
 
+    // 定义字体大小选择按钮与字体大小值的映射
     private static final Map<Integer, Integer> sFontSizeBtnsMap = new HashMap<Integer, Integer>();
     static {
         sFontSizeBtnsMap.put(R.id.ll_font_large, ResourceParser.TEXT_LARGE);
@@ -110,6 +114,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         sFontSizeBtnsMap.put(R.id.ll_font_super, ResourceParser.TEXT_SUPER);
     }
 
+    // 定义字体大小值与选中状态的映射
     private static final Map<Integer, Integer> sFontSelectorSelectionMap = new HashMap<Integer, Integer>();
     static {
         sFontSelectorSelectionMap.put(ResourceParser.TEXT_LARGE, R.id.iv_large_select);
@@ -118,47 +123,55 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         sFontSelectorSelectionMap.put(ResourceParser.TEXT_SUPER, R.id.iv_super_select);
     }
 
-    private static final String TAG = "NoteEditActivity";
+    private static final String TAG = "NoteEditActivity"; // 日志标签
 
-    private HeadViewHolder mNoteHeaderHolder;
+    private HeadViewHolder mNoteHeaderHolder; // 头部视图持有者
 
-    private View mHeadViewPanel;
+    private View mHeadViewPanel; // 头部视图面板
 
-    private View mNoteBgColorSelector;
+    private View mNoteBgColorSelector; // 背景颜色选择器
 
-    private View mFontSizeSelector;
+    private View mFontSizeSelector; // 字体大小选择器
 
-    private EditText mNoteEditor;
+    private EditText mNoteEditor; // 笔记编辑器
 
-    private View mNoteEditorPanel;
+    private View mNoteEditorPanel; // 笔记编辑器面板
 
-    private WorkingNote mWorkingNote;
+    private WorkingNote mWorkingNote; // 当前正在编辑的笔记
 
-    private SharedPreferences mSharedPrefs;
+    private SharedPreferences mSharedPrefs; // 共享偏好设置
-    private int mFontSizeId;
+    private int mFontSizeId; // 当前字体大小ID
 
-    private static final String PREFERENCE_FONT_SIZE = "pref_font_size";
+    private static final String PREFERENCE_FONT_SIZE = "pref_font_size"; // 字体大小偏好设置键
 
-    private static final int SHORTCUT_ICON_TITLE_MAX_LEN = 10;
+    private static final int SHORTCUT_ICON_TITLE_MAX_LEN = 10; // 快捷方式图标标题最大长度
 
-    public static final String TAG_CHECKED = String.valueOf('\u221A');
+    public static final String TAG_CHECKED = String.valueOf('\u221A'); // 已选中标签
-    public static final String TAG_UNCHECKED = String.valueOf('\u25A1');
+    public static final String TAG_UNCHECKED = String.valueOf('\u25A1'); // 未选中标签
 
-    private LinearLayout mEditTextList;
+    private LinearLayout mEditTextList; // 编辑文本列表
 
-    private String mUserQuery;
+    private String mUserQuery; // 用户查询字符串
-    private Pattern mPattern;
+    private Pattern mPattern; // 正则表达式模式
 
     @Override
+    // 重写父类的方法，用于在Activity创建时调用
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
+        // 调用父类的onCreate方法，进行Activity的基本初始化
         this.setContentView(R.layout.note_edit);
 
+        // 设置当前Activity的布局文件为R.layout.note_edit
         if (savedInstanceState == null && !initActivityState(getIntent())) {
+            // 检查savedInstanceState是否为null（即Activity是否是第一次创建）
+            // 并且调用initActivityState方法初始化Activity状态，如果返回false
             finish();
+            // 结束当前Activity
             return;
+            // 结束方法执行，不再继续向下执行
         }
         initResources();
+        // 调用initResources方法，进行资源的初始化
     }
 
     /**
@@ -167,14 +180,21 @@ public class NoteEditActivity extends Activity implements OnClickListener,
      */
     @Override
     protected void onRestoreInstanceState(Bundle savedInstanceState) {
+        // 调用父类的onRestoreInstanceState方法，确保父类的恢复逻辑得以执行
         super.onRestoreInstanceState(savedInstanceState);
+        // 检查savedInstanceState是否不为空，并且包含特定的键(Intent.EXTRA_UID)
         if (savedInstanceState != null && savedInstanceState.containsKey(Intent.EXTRA_UID)) {
+            // 创建一个新的Intent对象，指定动作为查看(Intent.ACTION_VIEW)
             Intent intent = new Intent(Intent.ACTION_VIEW);
+            // 将savedInstanceState中存储的UID值取出，并放入Intent的额外数据中
             intent.putExtra(Intent.EXTRA_UID, savedInstanceState.getLong(Intent.EXTRA_UID));
+            // 调用initActivityState方法，传入intent，尝试初始化活动状态
+            // 如果初始化失败，则调用finish()方法结束当前活动
             if (!initActivityState(intent)) {
                 finish();
                 return;
             }
+            // 使用Log.d输出调试信息，表示正在从被杀死的活动中恢复
             Log.d(TAG, "Restoring from killed activity");
         }
     }
@@ -263,26 +283,41 @@ public class NoteEditActivity extends Activity implements OnClickListener,
     }
 
     @Override
+    // 重写父类的方法，表示这个方法是一个覆盖方法
     protected void onResume() {
+        // 调用父类的onResume方法，确保父类的逻辑得以执行
         super.onResume();
+        // 调用initNoteScreen方法，初始化笔记屏幕
         initNoteScreen();
     }
 
+    // 初始化笔记屏幕的显示
     private void initNoteScreen() {
+        // 设置笔记编辑器的文本外观，根据字体大小ID获取对应的文本外观资源
         mNoteEditor.setTextAppearance(this, TextAppearanceResources
                 .getTexAppearanceResource(mFontSizeId));
+        // 检查当前笔记是否为待办事项模式
         if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {
+            // 如果是待办事项模式，则切换到列表模式，并设置内容
             switchToListMode(mWorkingNote.getContent());
         } else {
+            // 如果不是待办事项模式，则设置笔记编辑器的文本内容
+            // 高亮显示用户查询结果
             mNoteEditor.setText(getHighlightQueryResult(mWorkingNote.getContent(), mUserQuery));
+            // 将光标移动到文本末尾
             mNoteEditor.setSelection(mNoteEditor.getText().length());
         }
+        // 遍历背景选择器的选择映射，将所有背景选择器的视图设置为不可见
         for (Integer id : sBgSelectorSelectionMap.keySet()) {
             findViewById(sBgSelectorSelectionMap.get(id)).setVisibility(View.GONE);
         }
+        // 设置笔记标题栏的背景资源
         mHeadViewPanel.setBackgroundResource(mWorkingNote.getTitleBgResId());
+        // 设置笔记编辑器面板的背景资源
         mNoteEditorPanel.setBackgroundResource(mWorkingNote.getBgColorResId());
 
+        // 设置笔记头部视图的修改时间文本
+        // 使用DateUtils格式化日期时间，显示日期、时间、年份
         mNoteHeaderHolder.tvModified.setText(DateUtils.formatDateTime(this,
                 mWorkingNote.getModifiedDate(), DateUtils.FORMAT_SHOW_DATE
                         | DateUtils.FORMAT_NUMERIC_DATE | DateUtils.FORMAT_SHOW_TIME
@@ -295,31 +330,48 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         showAlertHeader();
     }
 
+    // 定义一个私有方法用于显示提醒头部信息
     private void showAlertHeader() {
+        // 检查当前工作笔记是否有闹钟提醒
         if (mWorkingNote.hasClockAlert()) {
+            // 获取当前系统时间
             long time = System.currentTimeMillis();
+            // 比较当前时间与提醒时间
             if (time > mWorkingNote.getAlertDate()) {
+                // 如果当前时间大于提醒时间，说明提醒已过期
+                // 设置提醒日期文本为“提醒已过期”
                 mNoteHeaderHolder.tvAlertDate.setText(R.string.note_alert_expired);
             } else {
+                // 如果当前时间小于提醒时间，说明提醒还未到
+                // 使用DateUtils工具类获取相对时间字符串
                 mNoteHeaderHolder.tvAlertDate.setText(DateUtils.getRelativeTimeSpanString(
                         mWorkingNote.getAlertDate(), time, DateUtils.MINUTE_IN_MILLIS));
             }
+            // 显示提醒日期文本视图
             mNoteHeaderHolder.tvAlertDate.setVisibility(View.VISIBLE);
+            // 显示提醒图标视图
             mNoteHeaderHolder.ivAlertIcon.setVisibility(View.VISIBLE);
         } else {
+            // 如果当前工作笔记没有闹钟提醒
+            // 隐藏提醒日期文本视图
             mNoteHeaderHolder.tvAlertDate.setVisibility(View.GONE);
+            // 隐藏提醒图标视图
             mNoteHeaderHolder.ivAlertIcon.setVisibility(View.GONE);
         };
     }
 
     @Override
+    // 重写父类的方法，当Activity接收到新的Intent时调用
     protected void onNewIntent(Intent intent) {
         super.onNewIntent(intent);
+        // 调用父类的onNewIntent方法，确保父类的逻辑得以执行
         initActivityState(intent);
+        // 调用initActivityState方法，传入新的Intent，用于初始化或更新Activity的状态
     }
 
     @Override
     protected void onSaveInstanceState(Bundle outState) {
+        // 调用父类的onSaveInstanceState方法，保存当前Activity的状态
         super.onSaveInstanceState(outState);
         /**
          * For new note without note id, we should firstly save it to
@@ -335,24 +387,36 @@ public class NoteEditActivity extends Activity implements OnClickListener,
 
     @Override
     public boolean dispatchTouchEvent(MotionEvent ev) {
+        // 检查笔记背景颜色选择器的可见性，并且判断触摸事件是否发生在选择器之外
         if (mNoteBgColorSelector.getVisibility() == View.VISIBLE
                 && !inRangeOfView(mNoteBgColorSelector, ev)) {
+            // 如果选择器可见且触摸事件发生在选择器之外，则隐藏选择器
             mNoteBgColorSelector.setVisibility(View.GONE);
+            // 返回true表示事件已处理，不再传递
             return true;
         }
 
+        // 检查字体大小选择器的可见性，并且判断触摸事件是否发生在选择器之外
         if (mFontSizeSelector.getVisibility() == View.VISIBLE
                 && !inRangeOfView(mFontSizeSelector, ev)) {
+            // 如果选择器可见且触摸事件发生在选择器之外，则隐藏选择器
             mFontSizeSelector.setVisibility(View.GONE);
+            // 返回true表示事件已处理，不再传递
             return true;
         }
+        // 如果上述条件都不满足，则调用父类的dispatchTouchEvent方法继续处理事件
         return super.dispatchTouchEvent(ev);
     }
 
+    // 定义一个私有方法，用于判断给定的MotionEvent是否在指定View的可见范围内
     private boolean inRangeOfView(View view, MotionEvent ev) {
+        // 创建一个整型数组，用于存储View在屏幕上的坐标位置
         int []location = new int[2];
+        // 获取View在屏幕上的绝对坐标位置，结果存储在location数组中
         view.getLocationOnScreen(location);
+        // 从location数组中获取View的左上角x坐标
         int x = location[0];
+        // 从location数组中获取View的左上角y坐标
         int y = location[1];
         if (ev.getX() < x
                 || ev.getX() > (x + view.getWidth())
@@ -363,28 +427,44 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         return true;
     }
 
+    // 初始化资源的方法
     private void initResources() {
+        // 获取标题面板的视图
         mHeadViewPanel = findViewById(R.id.note_title);
+        // 创建一个HeadViewHolder对象来保存标题部分的视图
         mNoteHeaderHolder = new HeadViewHolder();
+        // 获取修改日期的TextView
         mNoteHeaderHolder.tvModified = (TextView) findViewById(R.id.tv_modified_date);
+        // 获取提醒图标的ImageView
         mNoteHeaderHolder.ivAlertIcon = (ImageView) findViewById(R.id.iv_alert_icon);
+        // 获取提醒日期的TextView
         mNoteHeaderHolder.tvAlertDate = (TextView) findViewById(R.id.tv_alert_date);
+        // 获取设置背景颜色的ImageView
         mNoteHeaderHolder.ibSetBgColor = (ImageView) findViewById(R.id.btn_set_bg_color);
+        // 为设置背景颜色的ImageView设置点击监听器
         mNoteHeaderHolder.ibSetBgColor.setOnClickListener(this);
+        // 获取笔记编辑器的EditText
         mNoteEditor = (EditText) findViewById(R.id.note_edit_view);
+        // 获取笔记编辑面板的视图
         mNoteEditorPanel = findViewById(R.id.sv_note_edit);
+        // 获取背景颜色选择器的视图
         mNoteBgColorSelector = findViewById(R.id.note_bg_color_selector);
+        // 遍历背景颜色选择器的按钮ID集合，并为每个按钮设置点击监听器
         for (int id : sBgSelectorBtnsMap.keySet()) {
             ImageView iv = (ImageView) findViewById(id);
             iv.setOnClickListener(this);
         }
 
+        // 获取字体大小选择器的视图
         mFontSizeSelector = findViewById(R.id.font_size_selector);
+        // 遍历字体大小选择器的按钮ID集合，并为每个按钮设置点击监听器
         for (int id : sFontSizeBtnsMap.keySet()) {
             View view = findViewById(id);
             view.setOnClickListener(this);
         };
+        // 获取默认的SharedPreferences
         mSharedPrefs = PreferenceManager.getDefaultSharedPreferences(this);
+        // 从SharedPreferences中获取保存的字体大小ID，如果没有则使用默认值
         mFontSizeId = mSharedPrefs.getInt(PREFERENCE_FONT_SIZE, ResourceParser.BG_DEFAULT_FONT_SIZE);
         /**
          * HACKME: Fix bug of store the resource id in shared preference.
@@ -398,168 +478,256 @@ public class NoteEditActivity extends Activity implements OnClickListener,
     }
 
     @Override
+    // 重写父类中的onPause方法，该方法在Activity暂停时被调用
     protected void onPause() {
         super.onPause();
+        // 调用父类的onPause方法，确保父类的逻辑得以执行
         if(saveNote()) {
+            // 调用saveNote方法保存笔记，如果保存成功（返回true），则执行以下代码
             Log.d(TAG, "Note data was saved with length:" + mWorkingNote.getContent().length());
+            // 使用Log.d方法记录调试信息，TAG为日志标签，内容为"Note data was saved with length:"加上笔记内容的长度
         }
         clearSettingState();
+        // 调用clearSettingState方法清除设置状态，确保在暂停时不会保留不必要的设置
     }
 
+    // 更新小部件的方法
     private void updateWidget() {
+        // 创建一个意图，用于发送广播，更新小部件
         Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE);
+        // 根据当前工作笔记的小部件类型，设置对应的意图类
         if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_2X) {
+            // 如果是小部件类型2x2，则设置意图类为NoteWidgetProvider_2x
             intent.setClass(this, NoteWidgetProvider_2x.class);
         } else if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_4X) {
+            // 如果是小部件类型4x4，则设置意图类为NoteWidgetProvider_4x
             intent.setClass(this, NoteWidgetProvider_4x.class);
         } else {
+            // 如果是小部件类型不支持，则记录错误日志并返回
             Log.e(TAG, "Unspported widget type");
             return;
         }
 
+        // 将小部件ID作为额外数据添加到意图中
         intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS, new int[] {
             mWorkingNote.getWidgetId()
         });
 
+        // 发送广播，通知系统更新小部件
         sendBroadcast(intent);
+        // 设置结果码和意图，以便调用者知道操作成功
         setResult(RESULT_OK, intent);
     }
 
+    // 定义一个方法来处理点击事件
     public void onClick(View v) {
+        // 获取点击的视图的ID
         int id = v.getId();
+        // 如果点击的是设置背景颜色的按钮
         if (id == R.id.btn_set_bg_color) {
+            // 显示背景颜色选择器
             mNoteBgColorSelector.setVisibility(View.VISIBLE);
+            // 隐藏当前背景颜色选择器的选中状态
             findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility(
                     -                    View.VISIBLE);
         } else if (sBgSelectorBtnsMap.containsKey(id)) {
+            // 隐藏当前背景颜色选择器的选中状态
             findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility(
                     View.GONE);
+            // 设置新的背景颜色ID
             mWorkingNote.setBgColorId(sBgSelectorBtnsMap.get(id));
+            // 隐藏背景颜色选择器
             mNoteBgColorSelector.setVisibility(View.GONE);
         } else if (sFontSizeBtnsMap.containsKey(id)) {
+            // 隐藏当前字体大小选择器的选中状态
             findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.GONE);
+            // 设置新的字体大小ID
             mFontSizeId = sFontSizeBtnsMap.get(id);
+            // 将新的字体大小ID保存到SharedPreferences
             mSharedPrefs.edit().putInt(PREFERENCE_FONT_SIZE, mFontSizeId).commit();
+            // 显示新的字体大小选择器的选中状态
             findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.VISIBLE);
+            // 如果当前笔记是检查列表模式
             if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {
+                // 获取当前笔记的内容
                 getWorkingText();
+                // 切换到检查列表模式
                 switchToListMode(mWorkingNote.getContent());
             } else {
+                // 设置笔记编辑器的文本外观
                 mNoteEditor.setTextAppearance(this,
                         TextAppearanceResources.getTexAppearanceResource(mFontSizeId));
             }
+            // 隐藏字体大小选择器
             mFontSizeSelector.setVisibility(View.GONE);
         }
     }
 
     @Override
+    // 重写父类的方法，当用户按下返回键时调用
     public void onBackPressed() {
+        // 调用clearSettingState方法，检查是否需要清除设置状态
         if(clearSettingState()) {
+            // 如果clearSettingState返回true，表示需要清除设置状态，直接返回，不执行后续操作
             return;
         }
 
+        // 调用saveNote方法，保存当前笔记
         saveNote();
+        // 调用父类的onBackPressed方法，执行默认的返回键操作
         super.onBackPressed();
     }
 
+    // 定义一个私有方法clearSettingState，用于清除设置状态
     private boolean clearSettingState() {
+        // 检查笔记背景颜色选择器的可见性
         if (mNoteBgColorSelector.getVisibility() == View.VISIBLE) {
+            // 如果笔记背景颜色选择器是可见的，将其设置为不可见
             mNoteBgColorSelector.setVisibility(View.GONE);
+            // 返回true，表示成功隐藏了笔记背景颜色选择器
             return true;
         } else if (mFontSizeSelector.getVisibility() == View.VISIBLE) {
+            // 如果字体大小选择器是可见的，将其设置为不可见
             mFontSizeSelector.setVisibility(View.GONE);
+            // 返回true，表示成功隐藏了字体大小选择器
             return true;
         }
+        // 如果笔记背景颜色选择器和字体大小选择器都不可见，返回false
         return false;
     }
 
+    // 定义一个方法，当背景颜色发生变化时调用
     public void onBackgroundColorChanged() {
+        // 通过查找当前工作笔记的背景颜色ID，获取对应的视图，并将其设置为可见
         findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility(
                 View.VISIBLE);
+        // 设置笔记编辑面板的背景资源为当前工作笔记的背景颜色资源ID
         mNoteEditorPanel.setBackgroundResource(mWorkingNote.getBgColorResId());
+        // 设置头部视图面板的背景资源为当前工作笔记的标题背景资源ID
         mHeadViewPanel.setBackgroundResource(mWorkingNote.getTitleBgResId());
     }
 
     @Override
     public boolean onPrepareOptionsMenu(Menu menu) {
+        // 检查当前Activity是否正在 finishing（销毁中）
         if (isFinishing()) {
+            // 如果Activity正在销毁，则不执行后续操作，直接返回true
             return true;
         }
+        // 清除设置状态
         clearSettingState();
+        // 清空菜单
         menu.clear();
+        // 根据当前工作笔记的文件夹ID，决定加载哪个菜单布局
         if (mWorkingNote.getFolderId() == Notes.ID_CALL_RECORD_FOLDER) {
+            // 如果是通话记录文件夹，则加载通话笔记编辑菜单
             getMenuInflater().inflate(R.menu.call_note_edit, menu);
         } else {
+            // 否则加载普通笔记编辑菜单
             getMenuInflater().inflate(R.menu.note_edit, menu);
         }
+        // 根据当前工作笔记的清单模式，设置菜单项的标题
         if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {
+            // 如果是清单模式，则将清单模式菜单项标题设置为“普通模式”
             menu.findItem(R.id.menu_list_mode).setTitle(R.string.menu_normal_mode);
         } else {
+            // 否则将清单模式菜单项标题设置为“清单模式”
             menu.findItem(R.id.menu_list_mode).setTitle(R.string.menu_list_mode);
         }
+        // 根据当前工作笔记是否有闹钟提醒，设置菜单项的可见性
         if (mWorkingNote.hasClockAlert()) {
+            // 如果有闹钟提醒，则隐藏“添加提醒”菜单项
             menu.findItem(R.id.menu_alert).setVisible(false);
         } else {
+            // 如果没有闹钟提醒，则隐藏“删除提醒”菜单项
             menu.findItem(R.id.menu_delete_remind).setVisible(false);
         }
+        // 返回true表示菜单已准备好
         return true;
     }
 
     @Override
     public boolean onOptionsItemSelected(MenuItem item) {
+        // 根据菜单项的ID进行不同的操作
         switch (item.getItemId()) {
             case R.id.menu_new_note:
+                // 创建新笔记
                 createNewNote();
                 break;
             case R.id.menu_delete:
+                // 删除当前笔记
                 AlertDialog.Builder builder = new AlertDialog.Builder(this);
+                // 设置对话框标题
                 builder.setTitle(getString(R.string.alert_title_delete));
+                // 设置对话框图标
                 builder.setIcon(android.R.drawable.ic_dialog_alert);
+                // 设置对话框消息
                 builder.setMessage(getString(R.string.alert_message_delete_note));
+                // 设置对话框的确定按钮及其点击事件
                 builder.setPositiveButton(android.R.string.ok,
                         new DialogInterface.OnClickListener() {
                             public void onClick(DialogInterface dialog, int which) {
+                                // 删除当前笔记
                                 deleteCurrentNote();
+                                // 结束当前Activity
                                 finish();
                             }
                         });
+                // 设置对话框的取消按钮
                 builder.setNegativeButton(android.R.string.cancel, null);
+                // 显示对话框
                 builder.show();
                 break;
             case R.id.menu_font_size:
+                // 显示字体大小选择器
                 mFontSizeSelector.setVisibility(View.VISIBLE);
+                // 显示当前字体大小选项
                 findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.VISIBLE);
                 break;
             case R.id.menu_list_mode:
+                // 切换笔记的列表模式
                 mWorkingNote.setCheckListMode(mWorkingNote.getCheckListMode() == 0 ?
                         TextNote.MODE_CHECK_LIST : 0);
                 break;
             case R.id.menu_share:
+                // 获取当前笔记的内容
                 getWorkingText();
+                // 分享笔记内容
                 sendTo(this, mWorkingNote.getContent());
                 break;
             case R.id.menu_send_to_desktop:
+                // 将笔记发送到桌面
                 sendToDesktop();
                 break;
             case R.id.menu_alert:
+                // 设置提醒
                 setReminder();
                 break;
             case R.id.menu_delete_remind:
+                // 删除提醒
                 mWorkingNote.setAlertDate(0, false);
                 break;
             default:
+                // 默认操作
                 break;
         }
+        // 返回true表示事件已处理
         return true;
     }
 
+    // 定义一个私有方法setReminder，用于设置提醒
     private void setReminder() {
+        // 创建一个DateTimePickerDialog对象d，传入当前上下文和当前系统时间
         DateTimePickerDialog d = new DateTimePickerDialog(this, System.currentTimeMillis());
+        // 为DateTimePickerDialog对象设置一个时间设置监听器
         d.setOnDateTimeSetListener(new OnDateTimeSetListener() {
+            // 当用户设置时间时，会调用此方法
             public void OnDateTimeSet(AlertDialog dialog, long date) {
+                // 将设置的时间赋值给工作笔记的提醒日期，并标记为已设置
                 mWorkingNote.setAlertDate(date	, true);
             }
         });
+        // 显示DateTimePickerDialog对话框
         d.show();
     }
 
@@ -567,10 +735,15 @@ public class NoteEditActivity extends Activity implements OnClickListener,
      * Share note to apps that support {@link Intent#ACTION_SEND} action
      * and {@text/plain} type
      */
+    // 定义一个私有方法sendTo，用于发送信息
     private void sendTo(Context context, String info) {
+        // 创建一个Intent对象，指定动作类型为ACTION_SEND，表示发送
         Intent intent = new Intent(Intent.ACTION_SEND);
+        // 将要发送的信息添加到Intent中，使用EXTRA_TEXT键，info为要发送的文本内容
         intent.putExtra(Intent.EXTRA_TEXT, info);
+        // 设置Intent的数据类型为"text/plain"，表示发送的是纯文本
         intent.setType("text/plain");
+        // 使用传入的Context对象启动Activity，将Intent传递给系统，系统会根据Intent的类型选择合适的Activity来处理发送操作
         context.startActivity(intent);
     }
 
@@ -586,28 +759,41 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         startActivity(intent);
     }
 
+    // 删除当前笔记的方法
     private void deleteCurrentNote() {
+        // 检查当前笔记是否存在于数据库中
         if (mWorkingNote.existInDatabase()) {
+            // 创建一个HashSet用于存储要删除的笔记ID
             HashSet<Long> ids = new HashSet<Long>();
+            // 获取当前笔记的ID
             long id = mWorkingNote.getNoteId();
+            // 检查笔记ID是否为根文件夹ID，如果不是则添加到HashSet中
             if (id != Notes.ID_ROOT_FOLDER) {
                 ids.add(id);
             } else {
+                // 如果笔记ID为根文件夹ID，则记录错误日志
                 Log.d(TAG, "Wrong note id, should not happen");
             }
+            // 检查当前是否处于同步模式
             if (!isSyncMode()) {
+                // 如果不是同步模式，则批量删除笔记
                 if (!DataUtils.batchDeleteNotes(getContentResolver(), ids)) {
+                    // 如果删除失败，则记录错误日志
                     Log.e(TAG, "Delete Note error");
                 }
             } else {
+                // 如果是同步模式，则将笔记移动到垃圾文件夹
                 if (!DataUtils.batchMoveToFolder(getContentResolver(), ids, Notes.ID_TRASH_FOLER)) {
+                    // 如果移动失败，则记录错误日志
                     Log.e(TAG, "Move notes to trash folder error, should not happens");
                 }
             }
         }
+        // 标记当前笔记为已删除
         mWorkingNote.markDeleted(true);
     }
 
+    // 定义一个私有方法isSyncMode，用于判断当前是否处于同步模式
     private boolean isSyncMode() {
         return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0;
     }
@@ -642,33 +828,47 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         }
     }
 
+    // 定义一个公共方法，当小部件发生变化时调用
     public void onWidgetChanged() {
+        // 调用updateWidget方法来更新小部件
         updateWidget();
     }
 
+    // 定义一个方法，用于处理编辑文本框的删除操作
     public void onEditTextDelete(int index, String text) {
+        // 获取当前编辑文本框列表中的子视图数量
         int childCount = mEditTextList.getChildCount();
+        // 如果只有一个编辑文本框，则直接返回，不做任何操作
         if (childCount == 1) {
             return;
         }
 
+        // 从被删除的编辑文本框的下一个开始，遍历所有后续的编辑文本框
         for (int i = index + 1; i < childCount; i++) {
+            // 获取当前编辑文本框的子视图，并设置其索引为当前索引减1
             ((NoteEditText) mEditTextList.getChildAt(i).findViewById(R.id.et_edit_text))
                     .setIndex(i - 1);
         }
 
+        // 从列表中移除被删除的编辑文本框
         mEditTextList.removeViewAt(index);
         NoteEditText edit = null;
+        // 如果被删除的编辑文本框是第一个，则获取新的第一个编辑文本框
         if(index == 0) {
             edit = (NoteEditText) mEditTextList.getChildAt(0).findViewById(
                     R.id.et_edit_text);
         } else {
+            // 否则获取被删除的编辑文本框的前一个编辑文本框
             edit = (NoteEditText) mEditTextList.getChildAt(index - 1).findViewById(
                     R.id.et_edit_text);
         }
+        // 获取当前编辑文本框的文本长度
         int length = edit.length();
+        // 将被删除的编辑文本框的文本追加到当前编辑文本框
         edit.append(text);
+        // 请求焦点
         edit.requestFocus();
+        // 设置光标位置为文本末尾
         edit.setSelection(length);
     }
 
@@ -691,31 +891,52 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         }
     }
 
+    // 定义一个私有方法，用于将文本转换为列表模式
     private void switchToListMode(String text) {
+        // 清除mEditTextList中的所有视图
         mEditTextList.removeAllViews();
+        // 将输入的文本按换行符分割成字符串数组
         String[] items = text.split("\n");
+        // 初始化索引变量
         int index = 0;
+        // 遍历分割后的字符串数组
         for (String item : items) {
+            // 检查当前字符串是否为空
             if(!TextUtils.isEmpty(item)) {
+                // 如果不为空，将当前字符串作为列表项添加到mEditTextList中
                 mEditTextList.addView(getListItem(item, index));
+                // 索引加1
                 index++;
             }
         }
+        // 添加一个空列表项到mEditTextList中
         mEditTextList.addView(getListItem("", index));
+        // 获取刚刚添加的空列表项，并请求其内部的编辑文本视图获得焦点
         mEditTextList.getChildAt(index).findViewById(R.id.et_edit_text).requestFocus();
 
+        // 隐藏笔记编辑器视图
         mNoteEditor.setVisibility(View.GONE);
+        // 显示编辑文本列表视图
         mEditTextList.setVisibility(View.VISIBLE);
     }
 
+    // 定义一个私有方法，用于获取高亮显示用户查询结果的可变字符串
     private Spannable getHighlightQueryResult(String fullText, String userQuery) {
+        // 创建一个SpannableString对象，如果fullText为null，则使用空字符串
         SpannableString spannable = new SpannableString(fullText == null ? "" : fullText);
+        // 检查用户查询字符串是否为空
         if (!TextUtils.isEmpty(userQuery)) {
+            // 编译用户查询字符串为正则表达式模式
             mPattern = Pattern.compile(userQuery);
+            // 创建一个匹配器，用于在fullText中查找匹配的用户查询字符串
             Matcher m = mPattern.matcher(fullText);
+            // 初始化匹配的起始位置
             int start = 0;
+            // 循环查找匹配的用户查询字符串
             while (m.find(start)) {
+                // 在匹配的起始和结束位置之间设置背景颜色，以高亮显示查询结果
                 spannable.setSpan(
+                        // 创建一个BackgroundColorSpan对象，设置高亮背景颜色
                         new BackgroundColorSpan(this.getResources().getColor(
                                 R.color.user_query_highlight)), m.start(), m.end(),
                         Spannable.SPAN_INCLUSIVE_EXCLUSIVE);
@@ -725,55 +946,88 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         return spannable;
     }
 
+    // 定义一个私有方法，用于获取列表项的视图
     private View getListItem(String item, int index) {
+        // 使用LayoutInflater从当前上下文中加载note_edit_list_item布局文件，并返回一个View对象
         View view = LayoutInflater.from(this).inflate(R.layout.note_edit_list_item, null);
+        // 从视图中找到id为et_edit_text的NoteEditText控件
         final NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text);
+        // 设置edit文本的样式，使用TextAppearanceResources类获取对应的样式资源ID
         edit.setTextAppearance(this, TextAppearanceResources.getTexAppearanceResource(mFontSizeId));
+        // 从视图中找到id为cb_edit_item的CheckBox控件
         CheckBox cb = ((CheckBox) view.findViewById(R.id.cb_edit_item));
+        // 为CheckBox设置一个OnCheckedChangeListener监听器，用于处理选中状态变化
         cb.setOnCheckedChangeListener(new OnCheckedChangeListener() {
             public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
+                // 如果CheckBox被选中
                 if (isChecked) {
+                    // 设置edit文本的画笔标志，添加删除线效果
                     edit.setPaintFlags(edit.getPaintFlags() | Paint.STRIKE_THRU_TEXT_FLAG);
                 } else {
+                    // 如果CheckBox未被选中，设置edit文本的画笔标志，去除删除线效果
                     edit.setPaintFlags(Paint.ANTI_ALIAS_FLAG | Paint.DEV_KERN_TEXT_FLAG);
                 }
             }
         });
 
+        // 检查item字符串是否以TAG_CHECKED开头
         if (item.startsWith(TAG_CHECKED)) {
+            // 如果是，设置CheckBox为选中状态
             cb.setChecked(true);
+            // 设置edit文本的画笔标志，添加删除线效果
             edit.setPaintFlags(edit.getPaintFlags() | Paint.STRIKE_THRU_TEXT_FLAG);
+            // 去除TAG_CHECKED部分，并去除首尾空格
             item = item.substring(TAG_CHECKED.length(), item.length()).trim();
         } else if (item.startsWith(TAG_UNCHECKED)) {
+            // 如果item字符串以TAG_UNCHECKED开头
             cb.setChecked(false);
+            // 设置edit文本的画笔标志，去除删除线效果
             edit.setPaintFlags(Paint.ANTI_ALIAS_FLAG | Paint.DEV_KERN_TEXT_FLAG);
+            // 去除TAG_UNCHECKED部分，并去除首尾空格
             item = item.substring(TAG_UNCHECKED.length(), item.length()).trim();
         }
 
+        // 设置edit控件的文本内容，并高亮显示用户查询的关键词
         edit.setOnTextViewChangeListener(this);
+        // 设置edit控件的索引
         edit.setIndex(index);
+        // 设置edit控件的文本内容，并高亮显示用户查询的关键词
         edit.setText(getHighlightQueryResult(item, mUserQuery));
+        // 返回加载的视图对象
         return view;
     }
 
+    // 定义一个方法，当文本内容发生变化时调用
     public void onTextChange(int index, boolean hasText) {
+        // 检查传入的索引是否超出子视图列表的范围
         if (index >= mEditTextList.getChildCount()) {
+            // 如果索引超出范围，记录错误日志
             Log.e(TAG, "Wrong index, should not happen");
+            // 结束方法执行
             return;
         }
+        // 如果有文本内容
         if(hasText) {
+            // 获取指定索引位置的子视图，并找到其中的 R.id.cb_edit_item 视图，设置为可见
             mEditTextList.getChildAt(index).findViewById(R.id.cb_edit_item).setVisibility(View.VISIBLE);
         } else {
+            // 如果没有文本内容，获取指定索引位置的子视图，并找到其中的 R.id.cb_edit_item 视图，设置为不可见
             mEditTextList.getChildAt(index).findViewById(R.id.cb_edit_item).setVisibility(View.GONE);
         }
     }
 
+    // 当检查列表模式改变时调用的方法
     public void onCheckListModeChanged(int oldMode, int newMode) {
+        // 如果新的模式是检查列表模式
         if (newMode == TextNote.MODE_CHECK_LIST) {
+            // 将编辑器的内容转换为列表模式
             switchToListMode(mNoteEditor.getText().toString());
         } else {
+            // 如果获取工作文本失败
             if (!getWorkingText()) {
-                mWorkingNote.setWorkingText(mWorkingNote.getContent().replace(TAG_UNCHECKED + " ",
+
+                // 将工作笔记的文本中的未选中标签移除
+                mWorkingNote.setWorkingText(mWorkingNote.getContent().replace(TAG_UNCHECKED + " ", ""));
                         ""));
             }
             mNoteEditor.setText(getHighlightQueryResult(mWorkingNote.getContent(), mUserQuery));
@@ -782,32 +1036,50 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         }
     }
 
+    // 定义一个私有方法getWorkingText，用于获取工作文本并返回是否有已选中的项
     private boolean getWorkingText() {
+        // 初始化一个布尔变量hasChecked，用于标记是否有已选中的项
         boolean hasChecked = false;
+        // 检查当前工作笔记是否处于清单模式
         if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {
+            // 创建一个StringBuilder对象，用于构建工作文本
             StringBuilder sb = new StringBuilder();
+            // 遍历mEditTextList中的所有子视图
             for (int i = 0; i < mEditTextList.getChildCount(); i++) {
+                // 获取当前子视图
                 View view = mEditTextList.getChildAt(i);
+                // 从子视图中找到NoteEditText控件
                 NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text);
+                // 检查edit文本是否为空
                 if (!TextUtils.isEmpty(edit.getText())) {
+                    // 检查子视图中的CheckBox是否被选中
                     if (((CheckBox) view.findViewById(R.id.cb_edit_item)).isChecked()) {
+                        // 如果被选中，将选中标记和文本添加到StringBuilder中，并设置hasChecked为true
                         sb.append(TAG_CHECKED).append(" ").append(edit.getText()).append("\n");
                         hasChecked = true;
                     } else {
+                        // 如果未被选中，将未选中标记和文本添加到StringBuilder中
                         sb.append(TAG_UNCHECKED).append(" ").append(edit.getText()).append("\n");
                     }
                 }
             }
+            // 将构建好的字符串设置为工作笔记的工作文本
             mWorkingNote.setWorkingText(sb.toString());
         } else {
+            // 如果不是清单模式，直接将NoteEditor中的文本设置为工作笔记的工作文本
             mWorkingNote.setWorkingText(mNoteEditor.getText().toString());
         }
+        // 返回是否有已选中的项
         return hasChecked;
     }
 
+    // 定义一个私有方法saveNote，用于保存笔记
     private boolean saveNote() {
+        // 调用getWorkingText方法获取当前正在编辑的文本内容
         getWorkingText();
+        // 调用mWorkingNote对象的saveNote方法保存笔记，并将返回的布尔值赋给变量saved
         boolean saved = mWorkingNote.saveNote();
+        // 如果笔记保存成功（saved为true）
         if (saved) {
             /**
              * There are two modes from List view to edit view, open one note,
@@ -816,8 +1088,10 @@ public class NoteEditActivity extends Activity implements OnClickListener,
              * new node requires to the top of the list. This code
              * {@link #RESULT_OK} is used to identify the create/edit state
              */
+            // 设置结果为RESULT_OK，表示操作成功
             setResult(RESULT_OK);
         }
+        // 返回保存操作的结果
         return saved;
     }
 
@@ -856,18 +1130,29 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         }
     }
 
+    // 定义一个私有方法，用于生成快捷图标标题
     private String makeShortcutIconTitle(String content) {
+        // 移除字符串中的已选中标签
         content = content.replace(TAG_CHECKED, "");
+        // 移除字符串中的未选中标签
         content = content.replace(TAG_UNCHECKED, "");
         return content.length() > SHORTCUT_ICON_TITLE_MAX_LEN ? content.substring(0,
                 SHORTCUT_ICON_TITLE_MAX_LEN) : content;
     }
 
+    // 定义一个私有方法showToast，用于显示一个简短的Toast消息
     private void showToast(int resId) {
+        // 调用另一个重载的showToast方法，传入resId和Toast.LENGTH_SHORT作为参数
+        // resId是字符串资源的ID，Toast.LENGTH_SHORT表示Toast显示的时长为短时间
         showToast(resId, Toast.LENGTH_SHORT);
     }
 
+    // 定义一个私有方法showToast，用于显示一个Toast消息
     private void showToast(int resId, int duration) {
+        // 调用Toast类的静态方法makeText，创建一个Toast对象
+        // this：当前上下文，通常是Activity
+        // resId：要显示的消息字符串的资源ID
+        // duration：Toast显示的时长，可以是Toast.LENGTH_SHORT或Toast.LENGTH_LONG
         Toast.makeText(this, resId, duration).show();
     }
 }

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

@@ -38,16 +38,22 @@ import java.util.HashMap;
 import java.util.Map;
 
 public class NoteEditText extends EditText {
+    // 日志标签，用于调试和日志输出
     private static final String TAG = "NoteEditText";
+    // 当前编辑框的索引
     private int mIndex;
+    // 删除操作前的光标位置
     private int mSelectionStartBeforeDelete;
 
+    // 定义支持的链接方案
     private static final String SCHEME_TEL = "tel:" ;
     private static final String SCHEME_HTTP = "http:" ;
     private static final String SCHEME_EMAIL = "mailto:" ;
 
+    // 链接方案与对应的操作资源ID映射
     private static final Map<String, Integer> sSchemaActionResMap = new HashMap<String, Integer>();
     static {
+        // 初始化映射
         sSchemaActionResMap.put(SCHEME_TEL, R.string.note_link_tel);
         sSchemaActionResMap.put(SCHEME_HTTP, R.string.note_link_web);
         sSchemaActionResMap.put(SCHEME_EMAIL, R.string.note_link_email);
@@ -77,131 +83,191 @@ public class NoteEditText extends EditText {
 
     private OnTextViewChangeListener mOnTextViewChangeListener;
 
+    // 构造函数，用于创建一个NoteEditText对象
     public NoteEditText(Context context) {
+        // 调用父类的构造函数，传入当前上下文和null作为参数
         super(context, null);
+        // 初始化成员变量mIndex，将其设置为0
         mIndex = 0;
     }
 
+    // 定义一个公共方法，用于设置索引值
     public void setIndex(int index) {
+        // 将传入的索引值赋值给成员变量mIndex
         mIndex = index;
     }
 
+    // 定义一个方法用于设置TextView内容变化的监听器
     public void setOnTextViewChangeListener(OnTextViewChangeListener listener) {
+        // 将传入的监听器对象赋值给成员变量mOnTextViewChangeListener
         mOnTextViewChangeListener = listener;
     }
 
+    // 构造函数，用于创建NoteEditText对象
     public NoteEditText(Context context, AttributeSet attrs) {
+        // 调用父类的构造函数，传入上下文对象和属性集，同时指定默认样式为android.R.attr.editTextStyle
+        // 这里的super关键字表示调用父类（可能是TextView或EditText）的构造函数
+        // context: 上下文对象，用于获取资源和系统服务
+        // attrs: 属性集，包含在XML布局文件中定义的属性
+        // android.R.attr.editTextStyle: 指定默认的EditText样式
         super(context, attrs, android.R.attr.editTextStyle);
     }
 
+    // 构造函数，用于创建NoteEditText对象
     public NoteEditText(Context context, AttributeSet attrs, int defStyle) {
+        // 调用父类（可能是TextView或EditText）的构造函数，传入上下文、属性集和样式资源ID
         super(context, attrs, defStyle);
         // TODO Auto-generated constructor stub
     }
 
     @Override
     public boolean onTouchEvent(MotionEvent event) {
+        // 根据触摸事件的类型进行处理
         switch (event.getAction()) {
             case MotionEvent.ACTION_DOWN:
 
+                // 获取触摸点的x坐标
                 int x = (int) event.getX();
+                // 获取触摸点的y坐标
                 int y = (int) event.getY();
+                // 调整x坐标，减去左侧的内边距
                 x -= getTotalPaddingLeft();
+                // 调整y坐标，减去顶部的内边距
                 y -= getTotalPaddingTop();
+                // 调整x坐标，加上视图的滚动偏移量
                 x += getScrollX();
+                // 调整y坐标，加上视图的滚动偏移量
                 y += getScrollY();
 
+                // 获取当前文本的布局
                 Layout layout = getLayout();
+                // 根据y坐标获取触摸点所在的行
                 int line = layout.getLineForVertical(y);
+                // 根据x坐标和行号获取触摸点在该行中的偏移量
                 int off = layout.getOffsetForHorizontal(line, x);
+                // 设置文本的选中位置为触摸点所在的偏移量
                 Selection.setSelection(getText(), off);
                 break;
         }
 
+        // 调用父类的onTouchEvent方法，继续处理触摸事件
         return super.onTouchEvent(event);
     }
 
     @Override
+    // 重写 onKeyDown 方法，用于处理按键按下事件
     public boolean onKeyDown(int keyCode, KeyEvent event) {
+        // 根据按键代码进行不同的处理
         switch (keyCode) {
             case KeyEvent.KEYCODE_ENTER:
+                // 如果按键是回车键
                 if (mOnTextViewChangeListener != null) {
-                    return false;
+
+                    // 如果存在文本视图内容变化监听器
+                    return false; // 返回 false，表示不处理该按键事件
                 }
-                break;
+                break; // 跳出 switch 语句
             case KeyEvent.KEYCODE_DEL:
+                // 如果按键是删除键
                 mSelectionStartBeforeDelete = getSelectionStart();
-                break;
+
+                // 记录删除操作前的光标位置
+                break; // 跳出 switch 语句
             default:
-                break;
+
+                // 如果是其他按键
+                break; // 跳出 switch 语句
         }
+        // 调用父类的 onKeyDown 方法，处理其他按键事件
         return super.onKeyDown(keyCode, event);
     }
 
     @Override
     public boolean onKeyUp(int keyCode, KeyEvent event) {
+        // 根据按键代码进行不同的处理
         switch(keyCode) {
-            case KeyEvent.KEYCODE_DEL:
+            case KeyEvent.KEYCODE_DEL: // 处理删除键
-                if (mOnTextViewChangeListener != null) {
+                if (mOnTextViewChangeListener != null) { // 检查是否有设置文本变化监听器
-                    if (0 == mSelectionStartBeforeDelete && mIndex != 0) {
+                    if (0 == mSelectionStartBeforeDelete && mIndex != 0) { // 检查删除位置是否在文本开始且不是第一个编辑框
+                        // 调用监听器的删除方法，传递当前编辑框索引和文本内容
                         mOnTextViewChangeListener.onEditTextDelete(mIndex, getText().toString());
-                        return true;
+                        return true; // 返回true表示事件已处理
                     }
                 } else {
+                    // 如果没有设置监听器，记录日志
                     Log.d(TAG, "OnTextViewChangeListener was not seted");
                 }
                 break;
-            case KeyEvent.KEYCODE_ENTER:
+            case KeyEvent.KEYCODE_ENTER: // 处理回车键
-                if (mOnTextViewChangeListener != null) {
+                if (mOnTextViewChangeListener != null) { // 检查是否有设置文本变化监听器
-                    int selectionStart = getSelectionStart();
+                    int selectionStart = getSelectionStart(); // 获取当前光标位置
-                    String text = getText().subSequence(selectionStart, length()).toString();
+                    String text = getText().subSequence(selectionStart, length()).toString(); // 获取光标后的文本
-                    setText(getText().subSequence(0, selectionStart));
+                    setText(getText().subSequence(0, selectionStart)); // 清除光标后的文本
+                    // 调用监听器的回车方法，传递下一个编辑框索引和光标后的文本内容
                     mOnTextViewChangeListener.onEditTextEnter(mIndex + 1, text);
                 } else {
+                    // 如果没有设置监听器，记录日志
                     Log.d(TAG, "OnTextViewChangeListener was not seted");
                 }
                 break;
-            default:
+            default: // 其他按键不做处理
                 break;
         }
+        // 调用父类方法处理其他按键事件
         return super.onKeyUp(keyCode, event);
     }
 
     @Override
+    // 重写父类的方法，当视图焦点状态改变时调用
     protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) {
+        // 检查是否有文本变化监听器
         if (mOnTextViewChangeListener != null) {
+            // 如果当前视图失去焦点且文本为空
             if (!focused && TextUtils.isEmpty(getText())) {
+                // 调用监听器的onTextChange方法，通知文本为空
                 mOnTextViewChangeListener.onTextChange(mIndex, false);
             } else {
+                // 否则，调用监听器的onTextChange方法，通知文本不为空
                 mOnTextViewChangeListener.onTextChange(mIndex, true);
             }
         }
+        // 调用父类的onFocusChanged方法，确保父类的逻辑也被执行
         super.onFocusChanged(focused, direction, previouslyFocusedRect);
     }
 
     @Override
     protected void onCreateContextMenu(ContextMenu menu) {
+        // 检查当前文本是否为Spanned类型
         if (getText() instanceof Spanned) {
+            // 获取当前选中的文本的起始和结束位置
             int selStart = getSelectionStart();
             int selEnd = getSelectionEnd();
 
+            // 确定选中文本的起始和结束位置
             int min = Math.min(selStart, selEnd);
             int max = Math.max(selStart, selEnd);
 
+            // 获取选中文本中的URLSpan对象数组
             final URLSpan[] urls = ((Spanned) getText()).getSpans(min, max, URLSpan.class);
+            // 如果只有一个URLSpan对象
             if (urls.length == 1) {
                 int defaultResId = 0;
+                // 遍历预定义的URL模式映射表
                 for(String schema: sSchemaActionResMap.keySet()) {
+                    // 检查URL是否包含当前模式
                     if(urls[0].getURL().indexOf(schema) >= 0) {
+                        // 如果匹配，获取对应的资源ID
                         defaultResId = sSchemaActionResMap.get(schema);
                         break;
                     }
                 }
 
+                // 如果没有匹配的模式，使用默认的资源ID
                 if (defaultResId == 0) {
                     defaultResId = R.string.note_link_other;
                 }
 
+                // 向上下文菜单中添加一个菜单项
                 menu.add(0, 0, 0, defaultResId).setOnMenuItemClickListener(
                         new OnMenuItemClickListener() {
                             public boolean onMenuItemClick(MenuItem item) {

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

@@ -27,21 +27,23 @@ import net.micode.notes.tool.DataUtils;
 
 
 public class NoteItemData {
+    // 定义一个静态常量数组，用于查询数据库时使用的列名
     static final String [] PROJECTION = new String [] {
-        NoteColumns.ID,
+        NoteColumns.ID,                    // 笔记ID
-        NoteColumns.ALERTED_DATE,
+        NoteColumns.ALERTED_DATE,          // 提醒日期
-        NoteColumns.BG_COLOR_ID,
+        NoteColumns.BG_COLOR_ID,           // 背景颜色ID
-        NoteColumns.CREATED_DATE,
+        NoteColumns.CREATED_DATE,          // 创建日期
-        NoteColumns.HAS_ATTACHMENT,
+        NoteColumns.HAS_ATTACHMENT,        // 是否有附件
-        NoteColumns.MODIFIED_DATE,
+        NoteColumns.MODIFIED_DATE,         // 修改日期
-        NoteColumns.NOTES_COUNT,
+        NoteColumns.NOTES_COUNT,           // 笔记数量
-        NoteColumns.PARENT_ID,
+        NoteColumns.PARENT_ID,             // 父ID
-        NoteColumns.SNIPPET,
+        NoteColumns.SNIPPET,               // 笔记摘要
-        NoteColumns.TYPE,
+        NoteColumns.TYPE,                  // 笔记类型
-        NoteColumns.WIDGET_ID,
+        NoteColumns.WIDGET_ID,             // 小部件ID
-        NoteColumns.WIDGET_TYPE,
+        NoteColumns.WIDGET_TYPE,           // 小部件类型
     };
 
+    // 定义各个列在PROJECTION数组中的索引
     private static final int ID_COLUMN                    = 0;
     private static final int ALERTED_DATE_COLUMN          = 1;
     private static final int BG_COLOR_ID_COLUMN           = 2;
@@ -55,6 +57,7 @@ public class NoteItemData {
     private static final int WIDGET_ID_COLUMN             = 10;
     private static final int WIDGET_TYPE_COLUMN           = 11;
 
+    // 定义笔记项的数据成员变量
     private long mId;
     private long mAlertDate;
     private int mBgColorId;
@@ -70,12 +73,14 @@ public class NoteItemData {
     private String mName;
     private String mPhoneNumber;
 
+    // 定义笔记项的位置相关标志
     private boolean mIsLastItem;
     private boolean mIsFirstItem;
     private boolean mIsOnlyOneItem;
     private boolean mIsOneNoteFollowingFolder;
     private boolean mIsMultiNotesFollowingFolder;
 
+    // 构造函数，从Cursor中读取数据并初始化NoteItemData对象
     public NoteItemData(Context context, Cursor cursor) {
         mId = cursor.getLong(ID_COLUMN);
         mAlertDate = cursor.getLong(ALERTED_DATE_COLUMN);
@@ -93,6 +98,7 @@ public class NoteItemData {
         mWidgetType = cursor.getInt(WIDGET_TYPE_COLUMN);
 
         mPhoneNumber = "";
+        // 如果父ID是通话记录文件夹，则获取通话号码和联系人名称
         if (mParentId == Notes.ID_CALL_RECORD_FOLDER) {
             mPhoneNumber = DataUtils.getCallNumberByNoteId(context.getContentResolver(), mId);
             if (!TextUtils.isEmpty(mPhoneNumber)) {
@@ -106,9 +112,11 @@ public class NoteItemData {
         if (mName == null) {
             mName = "";
         }
+        // 检查笔记项的位置
         checkPostion(cursor);
     }
 
+    // 检查笔记项在Cursor中的位置，并设置相应的标志
     private void checkPostion(Cursor cursor) {
         mIsLastItem = cursor.isLast() ? true : false;
         mIsFirstItem = cursor.isFirst() ? true : false;
@@ -116,6 +124,7 @@ public class NoteItemData {
         mIsMultiNotesFollowingFolder = false;
         mIsOneNoteFollowingFolder = false;
 
+        // 如果笔记类型是普通笔记且不是第一个笔记，则检查前一个笔记的类型
         if (mType == Notes.TYPE_NOTE && !mIsFirstItem) {
             int position = cursor.getPosition();
             if (cursor.moveToPrevious()) {
@@ -134,90 +143,112 @@ public class NoteItemData {
         }
     }
 
+    // 判断是否只有一个笔记跟随文件夹
     public boolean isOneFollowingFolder() {
         return mIsOneNoteFollowingFolder;
     }
 
+    // 判断是否有多个笔记跟随文件夹
     public boolean isMultiFollowingFolder() {
         return mIsMultiNotesFollowingFolder;
     }
 
+    // 判断是否是最后一个笔记项
     public boolean isLast() {
         return mIsLastItem;
     }
 
+    // 获取通话记录的联系人名称
     public String getCallName() {
         return mName;
     }
 
+    // 判断是否是第一个笔记项
     public boolean isFirst() {
         return mIsFirstItem;
     }
 
+    // 判断是否只有一个笔记项
     public boolean isSingle() {
         return mIsOnlyOneItem;
     }
 
+    // 获取笔记ID
     public long getId() {
         return mId;
     }
 
+    // 获取提醒日期
     public long getAlertDate() {
         return mAlertDate;
     }
 
+    // 获取创建日期
     public long getCreatedDate() {
         return mCreatedDate;
     }
 
+    // 判断是否有附件
     public boolean hasAttachment() {
         return mHasAttachment;
     }
 
+    // 获取修改日期
     public long getModifiedDate() {
         return mModifiedDate;
     }
 
+    // 获取背景颜色ID
     public int getBgColorId() {
         return mBgColorId;
     }
 
+    // 获取父ID
     public long getParentId() {
         return mParentId;
     }
 
+    // 获取笔记数量
     public int getNotesCount() {
         return mNotesCount;
     }
 
+    // 获取文件夹ID
     public long getFolderId () {
         return mParentId;
     }
 
+    // 获取笔记类型
     public int getType() {
         return mType;
     }
 
+    // 获取小部件类型
     public int getWidgetType() {
         return mWidgetType;
     }
 
+    // 获取小部件ID
     public int getWidgetId() {
         return mWidgetId;
     }
 
+    // 获取笔记摘要
     public String getSnippet() {
         return mSnippet;
     }
 
+    // 判断是否有提醒
     public boolean hasAlert() {
         return (mAlertDate > 0);
     }
 
+    // 判断是否是通话记录
     public boolean isCallRecord() {
         return (mParentId == Notes.ID_CALL_RECORD_FOLDER && !TextUtils.isEmpty(mPhoneNumber));
     }
 
+    // 静态方法，从Cursor中获取笔记类型
     public static int getNoteType(Cursor cursor) {
         return cursor.getInt(TYPE_COLUMN);
     }

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

@@ -79,107 +79,155 @@ import java.io.InputStreamReader;
 import java.util.HashSet;
 
 public class NotesListActivity extends Activity implements OnClickListener, OnItemLongClickListener {
+    // 定义查询文件夹笔记列表的令牌
     private static final int FOLDER_NOTE_LIST_QUERY_TOKEN = 0;
 
+    // 定义查询文件夹列表的令牌
     private static final int FOLDER_LIST_QUERY_TOKEN      = 1;
 
+    // 定义文件夹菜单的删除选项
     private static final int MENU_FOLDER_DELETE = 0;
 
+    // 定义文件夹菜单的查看选项
     private static final int MENU_FOLDER_VIEW = 1;
 
+    // 定义文件夹菜单的更改名称选项
     private static final int MENU_FOLDER_CHANGE_NAME = 2;
 
+    // 定义首选项中添加介绍的键
     private static final String PREFERENCE_ADD_INTRODUCTION = "net.micode.notes.introduction";
 
+    // 定义列表编辑状态枚举
     private enum ListEditState {
         NOTE_LIST, SUB_FOLDER, CALL_RECORD_FOLDER
     };
 
+    // 当前列表编辑状态
     private ListEditState mState;
 
+    // 后台查询处理器
     private BackgroundQueryHandler mBackgroundQueryHandler;
 
+    // 笔记列表适配器
     private NotesListAdapter mNotesListAdapter;
 
+    // 笔记列表视图
     private ListView mNotesListView;
 
+    // 添加新笔记按钮
     private Button mAddNewNote;
 
+    // 是否分发事件
     private boolean mDispatch;
 
+    // 原始Y坐标
     private int mOriginY;
 
+    // 分发Y坐标
     private int mDispatchY;
 
+    // 标题栏
     private TextView mTitleBar;
 
+    // 当前文件夹ID
     private long mCurrentFolderId;
 
+    // 内容解析器
     private ContentResolver mContentResolver;
 
+    // 多选模式回调
     private ModeCallback mModeCallBack;
 
+    // 日志标签
     private static final String TAG = "NotesListActivity";
 
+    // 笔记列表视图滚动速率
     public static final int NOTES_LISTVIEW_SCROLL_RATE = 30;
 
+    // 焦点笔记数据项
     private NoteItemData mFocusNoteDataItem;
 
+    // 正常选择条件
     private static final String NORMAL_SELECTION = NoteColumns.PARENT_ID + "=?";
 
+    // 根文件夹选择条件
     private static final String ROOT_FOLDER_SELECTION = "(" + NoteColumns.TYPE + "<>"
             + Notes.TYPE_SYSTEM + " AND " + NoteColumns.PARENT_ID + "=?)" + " OR ("
             + NoteColumns.ID + "=" + Notes.ID_CALL_RECORD_FOLDER + " AND "
             + NoteColumns.NOTES_COUNT + ">0)";
 
+    // 打开笔记的请求代码
     private final static int REQUEST_CODE_OPEN_NODE = 102;
+    // 新建笔记的请求代码
     private final static int REQUEST_CODE_NEW_NODE  = 103;
 
     @Override
+    // 重写父类的方法，这里是重写Activity类的onCreate方法
     protected void onCreate(Bundle savedInstanceState) {
+        // 调用父类的onCreate方法，确保Activity正常创建
         super.onCreate(savedInstanceState);
+        // 设置当前Activity的布局文件为note_list.xml
         setContentView(R.layout.note_list);
+        // 初始化资源，具体实现可能在initResources方法中定义
         initResources();
 
         /**
          * Insert an introduction when user firstly use this application
          */
+        // 从原始资源文件中设置应用信息，可能是首次使用应用时的引导信息
         setAppInfoFromRawRes();
     }
 
     @Override
+    // 重写父类的方法，处理从其他Activity返回的结果
     protected void onActivityResult(int requestCode, int resultCode, Intent data) {
+        // 检查返回结果是否为RESULT_OK，并且请求码为打开节点或新建节点
         if (resultCode == RESULT_OK
                 && (requestCode == REQUEST_CODE_OPEN_NODE || requestCode == REQUEST_CODE_NEW_NODE)) {
+            // 如果条件满足，调用适配器的changeCursor方法，传入null，刷新数据
             mNotesListAdapter.changeCursor(null);
         } else {
+            // 如果条件不满足，调用父类的onActivityResult方法，继续处理结果
             super.onActivityResult(requestCode, resultCode, data);
         }
     }
 
+    // 从原始资源文件中设置应用信息的方法
     private void setAppInfoFromRawRes() {
+        // 获取SharedPreferences实例，用于存储和读取应用偏好设置
         SharedPreferences sp = PreferenceManager.getDefaultSharedPreferences(this);
+        // 检查是否已经添加了介绍信息，如果没有则进行添加
         if (!sp.getBoolean(PREFERENCE_ADD_INTRODUCTION, false)) {
+            // 创建StringBuilder用于构建读取的文本内容
             StringBuilder sb = new StringBuilder();
             InputStream in = null;
             try {
+                // 打开原始资源文件，文件名为introduction
                  in = getResources().openRawResource(R.raw.introduction);
+                // 检查输入流是否为空
                 if (in != null) {
+                    // 创建InputStreamReader和BufferedReader用于读取文件内容
                     InputStreamReader isr = new InputStreamReader(in);
                     BufferedReader br = new BufferedReader(isr);
+                    // 创建字符数组用于存储读取的字符
                     char [] buf = new char[1024];
                     int len = 0;
+                    // 循环读取文件内容，直到读取完毕
                     while ((len = br.read(buf)) > 0) {
+                        // 将读取的字符追加到StringBuilder中
                         sb.append(buf, 0, len);
                     }
                 } else {
+                    // 如果输入流为空，则记录错误日志并返回
                     Log.e(TAG, "Read introduction file error");
                     return;
                 }
             } catch (IOException e) {
+                // 捕获IO异常并打印堆栈信息，然后返回
                 e.printStackTrace();
                 return;
             } finally {
+                // 确保输入流被正确关闭
                 if(in != null) {
                     try {
                         in.close();
@@ -190,13 +238,18 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
                 }
             }
 
+            // 创建一个空的WorkingNote对象
             WorkingNote note = WorkingNote.createEmptyNote(this, Notes.ID_ROOT_FOLDER,
                     AppWidgetManager.INVALID_APPWIDGET_ID, Notes.TYPE_WIDGET_INVALIDE,
                     ResourceParser.RED);
+            // 设置工作文本为读取的介绍信息
             note.setWorkingText(sb.toString());
+            // 保存工作笔记
             if (note.saveNote()) {
+                // 如果保存成功，更新SharedPreferences标记为已添加介绍信息
                 sp.edit().putBoolean(PREFERENCE_ADD_INTRODUCTION, true).commit();
             } else {
+                // 如果保存失败，记录错误日志并返回
                 Log.e(TAG, "Save introduction note error");
                 return;
             }
@@ -204,42 +257,70 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
     }
 
     @Override
+    // 重写父类的方法，表示这个方法是一个覆盖方法
     protected void onStart() {
+        // 调用父类的onStart方法，确保父类的逻辑得以执行
         super.onStart();
+        // 调用startAsyncNotesListQuery方法，开始异步查询笔记列表
         startAsyncNotesListQuery();
     }
 
+    // 初始化资源的方法
     private void initResources() {
+        // 获取当前Activity的内容解析器
         mContentResolver = this.getContentResolver();
+        // 创建一个后台查询处理器，用于在后台线程中执行查询操作
         mBackgroundQueryHandler = new BackgroundQueryHandler(this.getContentResolver());
+        // 设置当前文件夹ID为根文件夹ID
         mCurrentFolderId = Notes.ID_ROOT_FOLDER;
+        // 获取笔记列表视图
         mNotesListView = (ListView) findViewById(R.id.notes_list);
+        // 向笔记列表视图添加一个页脚视图
         mNotesListView.addFooterView(LayoutInflater.from(this).inflate(R.layout.note_list_footer, null),
                 null, false);
+        // 设置笔记列表项的点击监听器
         mNotesListView.setOnItemClickListener(new OnListItemClickListener());
+        // 设置笔记列表项的长按监听器
         mNotesListView.setOnItemLongClickListener(this);
+        // 创建并设置笔记列表适配器
         mNotesListAdapter = new NotesListAdapter(this);
         mNotesListView.setAdapter(mNotesListAdapter);
+        // 获取添加新笔记的按钮
         mAddNewNote = (Button) findViewById(R.id.btn_new_note);
+        // 设置添加新笔记按钮的点击监听器
         mAddNewNote.setOnClickListener(this);
+        // 设置添加新笔记按钮的触摸监听器
         mAddNewNote.setOnTouchListener(new NewNoteOnTouchListener());
+        // 初始化触摸事件相关的变量
         mDispatch = false;
         mDispatchY = 0;
         mOriginY = 0;
+        // 获取标题栏文本视图
         mTitleBar = (TextView) findViewById(R.id.tv_title_bar);
+        // 设置当前状态为笔记列表状态
         mState = ListEditState.NOTE_LIST;
+        // 创建并设置模式回调
         mModeCallBack = new ModeCallback();
     }
 
+    // 定义一个内部类ModeCallback，实现ListView.MultiChoiceModeListener和OnMenuItemClickListener接口
     private class ModeCallback implements ListView.MultiChoiceModeListener, OnMenuItemClickListener {
+        // 声明DropdownMenu对象，用于显示下拉菜单
         private DropdownMenu mDropDownMenu;
+        // 声明ActionMode对象，用于多选模式
         private ActionMode mActionMode;
+        // 声明MenuItem对象，用于移动菜单项
         private MenuItem mMoveMenu;
 
+        // 当ActionMode创建时调用，初始化菜单和视图
         public boolean onCreateActionMode(ActionMode mode, Menu menu) {
+            // 加载菜单布局
             getMenuInflater().inflate(R.menu.note_list_options, menu);
+            // 设置删除菜单项的点击监听器
             menu.findItem(R.id.delete).setOnMenuItemClickListener(this);
+            // 获取移动菜单项
             mMoveMenu = menu.findItem(R.id.move);
+            // 根据条件设置移动菜单项的可见性
             if (mFocusNoteDataItem.getParentId() == Notes.ID_CALL_RECORD_FOLDER
                     || DataUtils.getUserFolderCount(mContentResolver) == 0) {
                 mMoveMenu.setVisible(false);
@@ -247,20 +328,30 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
                 mMoveMenu.setVisible(true);
                 mMoveMenu.setOnMenuItemClickListener(this);
             }
+            // 保存当前的ActionMode对象
             mActionMode = mode;
+            // 设置笔记列表适配器为选择模式
             mNotesListAdapter.setChoiceMode(true);
+            // 设置笔记列表不可长按
             mNotesListView.setLongClickable(false);
+            // 隐藏添加新笔记的按钮
             mAddNewNote.setVisibility(View.GONE);
 
+            // 加载自定义视图
             View customView = LayoutInflater.from(NotesListActivity.this).inflate(
                     R.layout.note_list_dropdown_menu, null);
+            // 设置ActionMode的自定义视图
             mode.setCustomView(customView);
+            // 初始化下拉菜单
             mDropDownMenu = new DropdownMenu(NotesListActivity.this,
                     (Button) customView.findViewById(R.id.selection_menu),
                     R.menu.note_list_dropdown);
+            // 设置下拉菜单项的点击监听器
             mDropDownMenu.setOnDropdownMenuItemClickListener(new PopupMenu.OnMenuItemClickListener(){
                 public boolean onMenuItemClick(MenuItem item) {
+                    // 切换全选/取消全选状态
                     mNotesListAdapter.selectAll(!mNotesListAdapter.isAllSelected());
+                    // 更新菜单
                     updateMenu();
                     return true;
                 }
@@ -269,7 +360,10 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
             return true;
         }
 
+        // 更新菜单标题和选项状态
+        // 更新菜单项的方法
         private void updateMenu() {
+            // 获取当前选中的笔记数量
             int selectedCount = mNotesListAdapter.getSelectedCount();
             // Update dropdown menu
             String format = getResources().getString(R.string.menu_select_title, selectedCount);
@@ -286,80 +380,120 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
             }
         }
 
+        // 定义一个方法，用于在ActionMode准备就绪时进行一些操作
         public boolean onPrepareActionMode(ActionMode mode, Menu menu) {
             // TODO Auto-generated method stub
+            // 这是一个自动生成的代码注释，提示开发者这里可以添加自定义逻辑
+            // 返回false，表示没有对菜单进行任何修改
             return false;
         }
 
+        // 定义一个方法，用于处理ActionMode中的菜单项点击事件
         public boolean onActionItemClicked(ActionMode mode, MenuItem item) {
             // TODO Auto-generated method stub
+            // 这是一个自动生成的代码注释，提示开发者此处需要实现具体的功能
+            // 返回false，表示该点击事件未被处理
             return false;
         }
 
+        // 当操作模式被销毁时调用的方法
         public void onDestroyActionMode(ActionMode mode) {
+            // 设置笔记列表适配器的选择模式为false，即取消选择模式
             mNotesListAdapter.setChoiceMode(false);
+            // 设置笔记列表视图的长按可点击性为true，即允许长按操作
             mNotesListView.setLongClickable(true);
+            // 设置添加新笔记按钮的可见性为VISIBLE，即显示按钮
             mAddNewNote.setVisibility(View.VISIBLE);
         }
 
+        // 定义一个公共方法，用于结束操作模式
         public void finishActionMode() {
+            // 调用mActionMode对象的finish方法，结束当前的操作模式
             mActionMode.finish();
         }
 
+        // 定义一个方法，当列表项的选中状态发生变化时被调用
         public void onItemCheckedStateChanged(ActionMode mode, int position, long id,
                 boolean checked) {
+            // 调用适配器的方法，设置指定位置项的选中状态
             mNotesListAdapter.setCheckedItem(position, checked);
+            // 更新菜单，可能是为了根据选中状态显示或隐藏某些菜单项
             updateMenu();
         }
 
+        // 定义一个方法来处理菜单项点击事件
         public boolean onMenuItemClick(MenuItem item) {
+            // 检查当前选中的笔记数量是否为0
             if (mNotesListAdapter.getSelectedCount() == 0) {
+                // 如果没有选中任何笔记，显示一个提示信息
                 Toast.makeText(NotesListActivity.this, getString(R.string.menu_select_none),
                         Toast.LENGTH_SHORT).show();
+                // 返回true表示事件已处理
                 return true;
             }
 
+            // 根据点击的菜单项ID进行不同的处理
             switch (item.getItemId()) {
                 case R.id.delete:
+                    // 创建一个AlertDialog.Builder对象来构建删除确认对话框
                     AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
+                    // 设置对话框标题
                     builder.setTitle(getString(R.string.alert_title_delete));
+                    // 设置对话框图标
                     builder.setIcon(android.R.drawable.ic_dialog_alert);
+                    // 设置对话框消息，显示选中的笔记数量
                     builder.setMessage(getString(R.string.alert_message_delete_notes,
                                              mNotesListAdapter.getSelectedCount()));
+                    // 设置对话框的确定按钮及其点击事件
                     builder.setPositiveButton(android.R.string.ok,
                                              new DialogInterface.OnClickListener() {
                                                  public void onClick(DialogInterface dialog,
                                                          int which) {
+                                                     // 调用批量删除方法
                                                      batchDelete();
                                                  }
                                              });
+                    // 设置对话框的取消按钮
                     builder.setNegativeButton(android.R.string.cancel, null);
+                    // 显示对话框
                     builder.show();
                     break;
                 case R.id.move:
+                    // 调用方法查询目标文件夹
                     startQueryDestinationFolders();
                     break;
                 default:
+                    // 如果点击的菜单项ID不在上述范围内，返回false表示未处理
                     return false;
             }
+            // 返回true表示事件已处理
             return true;
         }
     }
 
+    // 定义一个内部类 NewNoteOnTouchListener，实现 OnTouchListener 接口，用于处理触摸事件
     private class NewNoteOnTouchListener implements OnTouchListener {
 
+        // 重写 onTouch 方法，处理触摸事件
         public boolean onTouch(View v, MotionEvent event) {
+            // 根据触摸事件的类型进行不同的处理
             switch (event.getAction()) {
                 case MotionEvent.ACTION_DOWN: {
+                    // 获取当前窗口的显示对象
                     Display display = getWindowManager().getDefaultDisplay();
+                    // 获取屏幕的高度
                     int screenHeight = display.getHeight();
+                    // 获取“新建笔记”按钮视图的高度
                     int newNoteViewHeight = mAddNewNote.getHeight();
+                    // 计算触摸事件在屏幕中的起始位置
                     int start = screenHeight - newNoteViewHeight;
+                    // 计算触摸事件的 Y 坐标
                     int eventY = start + (int) event.getY();
                     /**
                      * Minus TitleBar's height
                      */
                     if (mState == ListEditState.SUB_FOLDER) {
+                        // 如果当前状态为子文件夹，减去标题栏的高度
                         eventY -= mTitleBar.getHeight();
                         start -= mTitleBar.getHeight();
                     }
@@ -372,43 +506,63 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
                      * Notice that, if the background of the button changes, the formula should
                      * also change. This is very bad, just for the UI designer's strong requirement.
                      */
+                    // 判断触摸点是否在“新建笔记”按钮的透明部分
                     if (event.getY() < (event.getX() * (-0.12) + 94)) {
+                        // 获取列表视图中的最后一个子视图
                         View view = mNotesListView.getChildAt(mNotesListView.getChildCount() - 1
                                 - mNotesListView.getFooterViewsCount());
                         if (view != null && view.getBottom() > start
                                 && (view.getTop() < (start + 94))) {
+                            // 记录原始触摸事件的 Y 坐标
                             mOriginY = (int) event.getY();
+                            // 计算需要分发的 Y 坐标
                             mDispatchY = eventY;
+                            // 设置触摸事件的新位置
                             event.setLocation(event.getX(), mDispatchY);
+                            // 标记需要分发事件
                             mDispatch = true;
+                            // 分发触摸事件到列表视图
                             return mNotesListView.dispatchTouchEvent(event);
                         }
                     }
                     break;
                 }
                 case MotionEvent.ACTION_MOVE: {
+                    // 如果需要分发事件
                     if (mDispatch) {
+                        // 更新需要分发的 Y 坐标
                         mDispatchY += (int) event.getY() - mOriginY;
+                        // 设置触摸事件的新位置
                         event.setLocation(event.getX(), mDispatchY);
+                        // 分发触摸事件到列表视图
                         return mNotesListView.dispatchTouchEvent(event);
                     }
                     break;
                 }
                 default: {
+                    // 如果需要分发事件
                     if (mDispatch) {
+                        // 设置触摸事件的新位置
                         event.setLocation(event.getX(), mDispatchY);
+                        // 取消标记需要分发事件
                         mDispatch = false;
+                        // 分发触摸事件到列表视图
                         return mNotesListView.dispatchTouchEvent(event);
                     }
                     break;
                 }
             }
+            // 默认返回 false，表示未处理该触摸事件
             return false;
         }
 
     };
 
+    // 定义一个私有方法，用于启动异步的笔记列表查询
     private void startAsyncNotesListQuery() {
+        // 根据当前文件夹ID是否为根文件夹，选择不同的查询条件
+        // 如果当前文件夹ID等于根文件夹ID，则使用根文件夹的查询条件
+        // 否则使用普通文件夹的查询条件
         String selection = (mCurrentFolderId == Notes.ID_ROOT_FOLDER) ? ROOT_FOLDER_SELECTION
                 : NORMAL_SELECTION;
         mBackgroundQueryHandler.startQuery(FOLDER_NOTE_LIST_QUERY_TOKEN, null,
@@ -417,62 +571,94 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
                 }, NoteColumns.TYPE + " DESC," + NoteColumns.MODIFIED_DATE + " DESC");
     }
 
+    // 定义一个私有的最终类 BackgroundQueryHandler，继承自 AsyncQueryHandler
     private final class BackgroundQueryHandler extends AsyncQueryHandler {
+        // 构造函数，接收一个 ContentResolver 对象，并调用父类的构造函数
         public BackgroundQueryHandler(ContentResolver contentResolver) {
             super(contentResolver);
         }
 
+        // 重写 onQueryComplete 方法，在查询完成时被调用
         @Override
         protected void onQueryComplete(int token, Object cookie, Cursor cursor) {
+            // 使用 switch 语句根据 token 的值来处理不同的查询结果
             switch (token) {
                 case FOLDER_NOTE_LIST_QUERY_TOKEN:
+                    // 如果 token 是 FOLDER_NOTE_LIST_QUERY_TOKEN，则更新 mNotesListAdapter 的数据源
                     mNotesListAdapter.changeCursor(cursor);
                     break;
                 case FOLDER_LIST_QUERY_TOKEN:
+                    // 如果 token 是 FOLDER_LIST_QUERY_TOKEN，则检查 cursor 是否不为空且包含数据
                     if (cursor != null && cursor.getCount() > 0) {
+                        // 如果有数据，则显示文件夹列表菜单
                         showFolderListMenu(cursor);
                     } else {
+                        // 如果没有数据，则记录错误日志
                         Log.e(TAG, "Query folder failed");
                     }
                     break;
                 default:
+                    // 如果 token 不匹配任何已知值，则直接返回
                     return;
             }
         }
     }
 
+    // 定义一个私有方法showFolderListMenu，用于显示文件夹列表菜单
     private void showFolderListMenu(Cursor cursor) {
+        // 创建一个AlertDialog.Builder对象，用于构建对话框
         AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
+        // 设置对话框的标题，标题内容来自资源文件中的menu_title_select_folder
         builder.setTitle(R.string.menu_title_select_folder);
+        // 创建一个FoldersListAdapter对象，用于适配文件夹列表数据
         final FoldersListAdapter adapter = new FoldersListAdapter(this, cursor);
+        // 设置对话框的适配器，用于显示文件夹列表
         builder.setAdapter(adapter, new DialogInterface.OnClickListener() {
 
+            // 当用户点击对话框中的某个选项时，执行此方法
             public void onClick(DialogInterface dialog, int which) {
+                // 调用DataUtils的batchMoveToFolder方法，将选中的笔记批量移动到指定的文件夹
                 DataUtils.batchMoveToFolder(mContentResolver,
                         mNotesListAdapter.getSelectedItemIds(), adapter.getItemId(which));
+                // 显示一个Toast消息，提示用户笔记已移动到指定文件夹
                 Toast.makeText(
                         NotesListActivity.this,
+                        // 格式化字符串，显示移动的笔记数量和目标文件夹名称
                         getString(R.string.format_move_notes_to_folder,
                                 mNotesListAdapter.getSelectedCount(),
                                 adapter.getFolderName(NotesListActivity.this, which)),
+                        // 设置Toast显示时长为短时间
                         Toast.LENGTH_SHORT).show();
+                // 调用mModeCallBack的finishActionMode方法，结束当前的操作模式
                 mModeCallBack.finishActionMode();
             }
         });
+        // 显示对话框
         builder.show();
     }
 
+    // 定义一个私有方法用于创建新笔记
     private void createNewNote() {
+        // 创建一个Intent对象，用于从当前Activity跳转到NoteEditActivity
         Intent intent = new Intent(this, NoteEditActivity.class);
+        // 设置Intent的动作类型为插入或编辑
         intent.setAction(Intent.ACTION_INSERT_OR_EDIT);
+        // 向Intent中添加一个额外的数据，表示当前文件夹的ID
         intent.putExtra(Notes.INTENT_EXTRA_FOLDER_ID, mCurrentFolderId);
+        // 调用startActivityForResult方法启动NoteEditActivity，并传递Intent和请求码
+        // 请求码用于在NoteEditActivity返回结果时标识这次请求
         this.startActivityForResult(intent, REQUEST_CODE_NEW_NODE);
     }
 
+    // 定义一个私有方法batchDelete，用于批量删除选中的笔记
     private void batchDelete() {
+        // 创建一个新的AsyncTask，用于在后台执行删除操作
         new AsyncTask<Void, Void, HashSet<AppWidgetAttribute>>() {
+            // 在后台执行删除操作
             protected HashSet<AppWidgetAttribute> doInBackground(Void... unused) {
+                // 获取选中的笔记对应的AppWidgetAttribute集合
                 HashSet<AppWidgetAttribute> widgets = mNotesListAdapter.getSelectedWidget();
+                // 检查当前是否处于同步模式
                 if (!isSyncMode()) {
                     // if not synced, delete notes directly
                     if (DataUtils.batchDeleteNotes(mContentResolver, mNotesListAdapter