Squashed commit of the following:

commit 148a3c3784
Author: 秦骁男 <860289024@qq.com>
Date:   Tue Dec 26 19:25:59 2023 +0800

    1

commit 32d9844272
Merge: cde081b d83102a
Author: zcx <1078327420@qq.com>
Date:   Sun Dec 24 21:18:16 2023 +0800

    Merge branch 'main' of https://bdgit.educoder.net/pq3fnjual/Minotes into qxn-test

commit cde081b96b
Author: zcx <1078327420@qq.com>
Date:   Sun Dec 24 21:17:43 2023 +0800

    1

# Conflicts:
#	src/Notes-master/src/net/micode/notes/ui/NoteEditText.java

src/Notes-master/src/net/micode/notes/ui/NoteEditText.java

@@ -49,33 +49,31 @@ public class NoteEditText extends EditText {
     
     //功能：建立一个字符和整数的hash表，用于链接电话，网站，还有邮箱
     private static final Map<String, Integer> sSchemaActionResMap = new HashMap<String, Integer>();
-    static {
+    static {//一个Map对象，用于储存URI方案和对应的ID，在静态代码中初始化
         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);
     }
  
     /**
-     * Call by the {@link NoteEditActivity} to delete or add edit text
+     * 调用来删除或者添加编辑文本
      */
    //在NoteEditActivity中删除或添加文本的操作，可以看做是一个文本是否被变的标记，英文注释已说明的很清楚
     public interface OnTextViewChangeListener {
         /**
-         * Delete current edit text when {@link KeyEvent#KEYCODE_DEL} happens
-         * and the text is null
+         * 删除文本
          */
     	//处理删除按键时的操作
         void onEditTextDelete(int index, String text);
  
         /**
-         * Add edit text after current edit text when {@link KeyEvent#KEYCODE_ENTER}
-         * happen
+         * 添加编辑文本
          */
         //处理进入按键时的操作
         void onEditTextEnter(int index, String text);
  
         /**
-         * Hide or show item option when text change
+         * 文本更改时隐藏或者显示项目选项
          */
         void onTextChange(int index, boolean hasText);
     }
@@ -83,7 +81,7 @@ public class NoteEditText extends EditText {
     private OnTextViewChangeListener mOnTextViewChangeListener;
  
     //根据context设置文本
-    public NoteEditText(Context context) {
+    public NoteEditText(Context context) {//当前光标位置是文本开头
         super(context, null);//用super引用父类变量
         mIndex = 0;
     }
@@ -94,6 +92,9 @@ public class NoteEditText extends EditText {
     }
     
     //初始化文本修改标记
+    /**
+     * 设置文本视图监视器
+     */
     public void setOnTextViewChangeListener(OnTextViewChangeListener listener) {
         mOnTextViewChangeListener = listener;
     }
@@ -107,9 +108,12 @@ public class NoteEditText extends EditText {
     // 根据defstyle自动初始化
     public NoteEditText(Context context, AttributeSet attrs, int defStyle) {
         super(context, attrs, defStyle);
-        // TODO Auto-generated construct or stub
+        // 自动生成代码函数存根
     }
 
+    /**
+     * 根据触摸屏幕的位置，将光标定位到文本对应位置
+     */
     @Override
     //功能：处理手机屏幕的所有事件
     public boolean onTouchEvent(MotionEvent event) {
@@ -137,6 +141,9 @@ public class NoteEditText extends EditText {
         return super.onTouchEvent(event);
     }
  
+    /**
+     *按下按键时对回车键和删除键的实现
+     */
     @Override
     //函数功能：处理用户按下一个键盘按键时会触发 的事件
     public boolean onKeyDown(int keyCode, KeyEvent event) {
@@ -159,6 +166,9 @@ public class NoteEditText extends EditText {
         return super.onKeyDown(keyCode, event);
     }
  
+    /**
+     * 抬起按键时，队回车键和删除键的特殊处理
+     */
     @Override
     //函数功能：处理用户松开一个键盘按键时会触发 的事件
     public boolean onKeyUp(int keyCode, KeyEvent event) {
@@ -201,6 +211,9 @@ public class NoteEditText extends EditText {
         return super.onKeyUp(keyCode, event);
     }
  
+    /**
+     * 处理焦点改变事件，根据焦点状态和文本内容触发相应的回调方法。
+     */
     @Override
     //函数功能：当焦点发生变化时，会自动调用该方法来处理焦点改变的事件
     protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) {
@@ -219,6 +232,9 @@ public class NoteEditText extends EditText {
         super.onFocusChanged(focused, direction, previouslyFocusedRect);
     }
  
+    /**
+     * 根据选中的URLSpan对象创建上下文菜单，并实现了点击菜单项跳转到对应链接的功能。
+     */
     @Override
     //函数功能：生成上下文菜单
     protected void onCreateContextMenu(ContextMenu menu) {

src/Notes-master/src/net/micode/notes/ui/NoteItemData.java

@@ -27,7 +27,7 @@ import net.micode.notes.tool.DataUtils;
 
 
 public class NoteItemData {
-    static final String [] PROJECTION = new String [] {
+    static final String [] PROJECTION = new String [] {//备注的项目
         NoteColumns.ID,
         NoteColumns.ALERTED_DATE,
         NoteColumns.BG_COLOR_ID,
@@ -41,7 +41,9 @@ public class NoteItemData {
         NoteColumns.WIDGET_ID,
         NoteColumns.WIDGET_TYPE,
     };
-
+    /**
+     * 备注项目的编号
+     */
     private static final int ID_COLUMN                    = 0;
     private static final int ALERTED_DATE_COLUMN          = 1;
     private static final int BG_COLOR_ID_COLUMN           = 2;
@@ -76,6 +78,9 @@ public class NoteItemData {
     private boolean mIsOneNoteFollowingFolder;
     private boolean mIsMultiNotesFollowingFolder;
 
+    /**
+     * 根据数据库游标初始化NoteItemData对象的各个属性值，包括ID、创建日期、背景颜色、小部件ID、小部件类型等。
+     */
     public NoteItemData(Context context, Cursor cursor) {
         mId = cursor.getLong(ID_COLUMN);
         mAlertDate = cursor.getLong(ALERTED_DATE_COLUMN);
@@ -109,6 +114,9 @@ public class NoteItemData {
         checkPostion(cursor);
     }
 
+    /**
+     * 根据当前游标的位置和类型设置一些标志位属性，用于在后续的逻辑中判断当前笔记的位置和类型。
+     */
     private void checkPostion(Cursor cursor) {
         mIsLastItem = cursor.isLast() ? true : false;
         mIsFirstItem = cursor.isFirst() ? true : false;

src/Notes-master/src/net/micode/notes/ui/NotesListActivity.java

@@ -78,6 +78,11 @@ import java.io.InputStream;
 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;
 
@@ -126,7 +131,9 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
     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 "
@@ -142,11 +149,16 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         initResources();
 
         /**
-         * Insert an introduction when user firstly use this application
+         * 首次使用时插入介绍
          */
         setAppInfoFromRawRes();
     }
 
+    /**
+     * 检查结果是否正常
+     * 正常则重新加载数据
+     * 否则调用结果函数
+     */
     @Override
     protected void onActivityResult(int requestCode, int resultCode, Intent data) {
         if (resultCode == RESULT_OK
@@ -157,6 +169,12 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         }
     }
 
+    /**
+     * 检查布尔值是否为错误
+     * 如果遇到错误，记录错误信息并返回
+     * 在首次运行时将文本保存到程序中
+     * 在后续运行中不重复保存
+     */
     private void setAppInfoFromRawRes() {
         SharedPreferences sp = PreferenceManager.getDefaultSharedPreferences(this);
         if (!sp.getBoolean(PREFERENCE_ADD_INTRODUCTION, false)) {
@@ -184,7 +202,7 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
                     try {
                         in.close();
                     } catch (IOException e) {
-                        // TODO Auto-generated catch block
+                        // 自动生成的catch块
                         e.printStackTrace();
                     }
                 }
@@ -269,6 +287,9 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
             return true;
         }
 
+        /**
+         * 用于更新下拉菜单的显示内容，根据选择的笔记数量更新菜单标题和选项状态
+         */
         private void updateMenu() {
             int selectedCount = mNotesListAdapter.getSelectedCount();
             // Update dropdown menu
@@ -286,32 +307,46 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
             }
         }
 
+        /**
+         * 与操作模式相关的回调方法，用于处理操作模式的准备和点击事件。
+         */
         public boolean onPrepareActionMode(ActionMode mode, Menu menu) {
-            // TODO Auto-generated method stub
+            // 自动生成的方法存根
             return false;
         }
 
         public boolean onActionItemClicked(ActionMode mode, MenuItem item) {
-            // TODO Auto-generated method stub
+
             return false;
         }
 
+        /**
+         * 在操作模式销毁时被调用，用于恢复界面状态。
+         */
         public void onDestroyActionMode(ActionMode mode) {
             mNotesListAdapter.setChoiceMode(false);
             mNotesListView.setLongClickable(true);
             mAddNewNote.setVisibility(View.VISIBLE);
         }
 
-        public void finishActionMode() {
+        public void finishActionMode() {//用于结束操作模式。
             mActionMode.finish();
         }
 
+        /**
+         * 处理笔记项选中状态改变的事件，并更新菜单。
+         */
         public void onItemCheckedStateChanged(ActionMode mode, int position, long id,
                 boolean checked) {
             mNotesListAdapter.setCheckedItem(position, checked);
             updateMenu();
         }
 
+        /**
+         *处理菜单项点击事件
+         * 根据点击的菜单项执行相应的操作
+         * 比如删除或移动笔记。
+         */
         public boolean onMenuItemClick(MenuItem item) {
             if (mNotesListAdapter.getSelectedCount() == 0) {
                 Toast.makeText(NotesListActivity.this, getString(R.string.menu_select_none),
@@ -346,6 +381,11 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         }
     }
 
+    /**
+     * 实现了一个触摸监听器
+     * 处理了新建笔记按钮的触摸事件
+     * 包括点击透明部分时将事件传递
+     */
     private class NewNoteOnTouchListener implements OnTouchListener {
 
         public boolean onTouch(View v, MotionEvent event) {
@@ -408,6 +448,11 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
 
     };
 
+    /**
+     * 用于开始异步笔记列表查询
+     * 根据当前文件夹的不同选择不同的查询条件
+     * 并使用后台查询处理程序执行查询操作。
+     */
     private void startAsyncNotesListQuery() {
         String selection = (mCurrentFolderId == Notes.ID_ROOT_FOLDER) ? ROOT_FOLDER_SELECTION
                 : NORMAL_SELECTION;
@@ -417,6 +462,12 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
                 }, NoteColumns.TYPE + " DESC," + NoteColumns.MODIFIED_DATE + " DESC");
     }
 
+    /**
+     * 类继承自 AsyncQueryHandler
+     * 用于处理后台查询的结果
+     * 根据查询的不同类型执行相应的操作
+     * 比如更新笔记列表或显示文件夹菜单。
+     */
     private final class BackgroundQueryHandler extends AsyncQueryHandler {
         public BackgroundQueryHandler(ContentResolver contentResolver) {
             super(contentResolver);
@@ -441,6 +492,9 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         }
     }
 
+    /**
+     * 用于显示文件夹列表菜单，根据传入的游标数据构建对话框，并处理用户选择文件夹的操作。
+     */
     private void showFolderListMenu(Cursor cursor) {
         AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
         builder.setTitle(R.string.menu_title_select_folder);
@@ -462,6 +516,10 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         builder.show();
     }
 
+    /**
+     * 用于创建新的笔记，构建一个新的笔记编辑界面
+     * 并传递文件夹 ID 及请求码进行处理。
+     */
     private void createNewNote() {
         Intent intent = new Intent(this, NoteEditActivity.class);
         intent.setAction(Intent.ACTION_INSERT_OR_EDIT);
@@ -469,6 +527,11 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         this.startActivityForResult(intent, REQUEST_CODE_NEW_NODE);
     }
 
+    /**
+     * 用于批量删除笔记
+     * 根据同步模式的不同执行直接删除或移动到垃圾箱
+     * 并在后台执行异步任务。
+     */
     private void batchDelete() {
         new AsyncTask<Void, Void, HashSet<AppWidgetAttribute>>() {
             protected HashSet<AppWidgetAttribute> doInBackground(Void... unused) {
@@ -506,6 +569,9 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         }.execute();
     }
 
+    /**
+     * 用于删除文件夹，根据同步模式的不同执行直接删除或移动到垃圾箱，并更新相关的小部件。
+     */
     private void deleteFolder(long folderId) {
         if (folderId == Notes.ID_ROOT_FOLDER) {
             Log.e(TAG, "Wrong folder id, should not happen " + folderId);
@@ -533,13 +599,20 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         }
     }
 
+    /**
+     * 用于打开笔记，构建一个笔记查看界面
+     * 并传递笔记 ID 进行处理。
+     */
     private void openNode(NoteItemData data) {
         Intent intent = new Intent(this, NoteEditActivity.class);
         intent.setAction(Intent.ACTION_VIEW);
         intent.putExtra(Intent.EXTRA_UID, data.getId());
         this.startActivityForResult(intent, REQUEST_CODE_OPEN_NODE);
     }
-
+    /**
+     * 用于打开文件夹，根据文件夹的不同执行异步笔记列表查询
+     * 并更新界面状态和标题栏的显示。
+     */
     private void openFolder(NoteItemData data) {
         mCurrentFolderId = data.getId();
         startAsyncNotesListQuery();
@@ -567,6 +640,10 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         }
     }
 
+    /**
+     * 显示软键盘
+     */
+
     private void showSoftInput() {
         InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
         if (inputMethodManager != null) {
@@ -574,11 +651,20 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         }
     }
 
+    /**
+     * 隐藏软键盘
+     */
     private void hideSoftInput(View view) {
         InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
         inputMethodManager.hideSoftInputFromWindow(view.getWindowToken(), 0);
     }
 
+    /**
+     * 用于显示创建或修改文件夹的对话框
+     * 根据传入的布尔值决定是创建还是修改文件夹
+     * 对话框中包含了编辑文本框和确认/取消按钮
+     * 并根据用户输入进行相应的操作。
+     */
     private void showCreateOrModifyFolderDialog(final boolean create) {
         final AlertDialog.Builder builder = new AlertDialog.Builder(this);
         View view = LayoutInflater.from(this).inflate(R.layout.dialog_edit_text, null);
@@ -664,6 +750,10 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         });
     }
 
+    /**
+     * 用于处理返回按钮的操作，根据当前状态执行不同的操作
+     * 包括返回上一级文件夹、返回笔记列表或者执行默认的返回操作。
+     */
     @Override
     public void onBackPressed() {
         switch (mState) {
@@ -688,6 +778,9 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         }
     }
 
+    /**
+     * 用于更新小部件，根据传入的小部件 ID 和小部件类型创建相应的意图，并发送广播来更新小部件。
+     */
     private void updateWidget(int appWidgetId, int appWidgetType) {
         Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE);
         if (appWidgetType == Notes.TYPE_WIDGET_2X) {
@@ -707,6 +800,10 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         setResult(RESULT_OK, intent);
     }
 
+    /**
+     * 是一个上下文菜单的创建监听器，用于创建文件夹的上下文菜单
+     * 包括查看文件夹、删除文件夹和修改文件夹名称等选项。
+     */
     private final OnCreateContextMenuListener mFolderOnCreateContextMenuListener = new OnCreateContextMenuListener() {
         public void onCreateContextMenu(ContextMenu menu, View v, ContextMenuInfo menuInfo) {
             if (mFocusNoteDataItem != null) {
@@ -718,6 +815,10 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         }
     };
 
+    /**
+     * 用于在上下文菜单关闭时执行操作
+     * 它会在菜单关闭时将上下文菜单的创建监听器设置为null。
+     */
     @Override
     public void onContextMenuClosed(Menu menu) {
         if (mNotesListView != null) {
@@ -726,6 +827,10 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         super.onContextMenuClosed(menu);
     }
 
+    /**
+     * 用于处理上下文菜单中的菜单项选择操作，根据用户选择执行相应的操作
+     * 包括打开文件夹、删除文件夹和修改文件夹名称等。
+     */
     @Override
     public boolean onContextItemSelected(MenuItem item) {
         if (mFocusNoteDataItem == null) {
@@ -760,6 +865,10 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         return true;
     }
 
+    /**
+     * 用于准备选项菜单，根据当前状态加载不同的菜单项
+     * 包括笔记列表、子文件夹、通话记录文件夹等状态下的菜单项。
+     */
     @Override
     public boolean onPrepareOptionsMenu(Menu menu) {
         menu.clear();
@@ -778,6 +887,10 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         return true;
     }
 
+    /**
+     * 用于处理选项菜单中的菜单项选择操作，根据用户选择执行相应的操作
+     * 包括创建新文件夹、导出笔记到文本、同步、设置、创建新笔记和搜索等。
+     */
     @Override
     public boolean onOptionsItemSelected(MenuItem item) {
         switch (item.getItemId()) {
@@ -818,12 +931,18 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         return true;
     }
 
+    /**
+     * 用于处理搜索请求，启动搜索功能。
+     */
     @Override
     public boolean onSearchRequested() {
         startSearch(null, false, null /* appData */, false);
         return true;
     }
 
+    /**
+     * 用于将笔记导出为文本文件，在后台执行导出操作
+     */
     private void exportNoteToText() {
         final BackupUtils backup = BackupUtils.getInstance(NotesListActivity.this);
         new AsyncTask<Void, Void, Integer>() {
@@ -866,16 +985,25 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         }.execute();
     }
 
+    /**
+     * 用于检查是否处于同步模式，它会获取同步账户名称并检查其长度是否大于0，如果大于0则表示处于同步模式。
+     */
     private boolean isSyncMode() {
         return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0;
     }
 
+    /**
+     * 用于启动偏好设置活动，它会创建一个意图并启动偏好设置活动。
+     */
     private void startPreferenceActivity() {
         Activity from = getParent() != null ? getParent() : this;
         Intent intent = new Intent(from, NotesPreferenceActivity.class);
         from.startActivityIfNeeded(intent, -1);
     }
 
+    /**
+     * 用于处理列表项的点击操作。根据当前状态和列表项的类型执行相应的操作，包括打开文件夹、打开笔记等。
+     */
     private class OnListItemClickListener implements OnItemClickListener {
 
         public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
@@ -917,6 +1045,9 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
 
     }
 
+    /**
+     * 用于开始查询目标文件夹，它构建了查询条件并使用后台查询处理程序执行查询操作
+     */
     private void startQueryDestinationFolders() {
         String selection = NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>? AND " + NoteColumns.ID + "<>?";
         selection = (mState == ListEditState.NOTE_LIST) ? selection:
@@ -935,6 +1066,10 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
                 NoteColumns.MODIFIED_DATE + " DESC");
     }
 
+    /**
+     * 用于处理列表项的长按操作，根据列表项的类型执行相应的操作，包括进入选择模式、执行长按操作等。
+     * @return
+     */
     public boolean onItemLongClick(AdapterView<?> parent, View view, int position, long id) {
         if (view instanceof NotesListItem) {
             mFocusNoteDataItem = ((NotesListItem) view).getItemData();

src/Notes-master/src/net/micode/notes/ui/NotesListAdapter.java

@@ -30,7 +30,9 @@ import java.util.HashMap;
 import java.util.HashSet;
 import java.util.Iterator;
 
-
+/**
+ * 继承自 CursorAdapter，用于管理笔记列表的显示和选择操作
+ */
 public class NotesListAdapter extends CursorAdapter {
     private static final String TAG = "NotesListAdapter";
     private Context mContext;
@@ -38,11 +40,14 @@ public class NotesListAdapter extends CursorAdapter {
     private int mNotesCount;
     private boolean mChoiceMode;
 
-    public static class AppWidgetAttribute {
+    public static class AppWidgetAttribute {//用于表示小部件的属性，包括小部件的ID和类型。
         public int widgetId;
         public int widgetType;
     };
 
+    /**
+     * 用于初始化适配器，包括初始化上下文、选择索引等。
+     */
     public NotesListAdapter(Context context) {
         super(context, null);
         mSelectedIndex = new HashMap<Integer, Boolean>();
@@ -50,11 +55,17 @@ public class NotesListAdapter extends CursorAdapter {
         mNotesCount = 0;
     }
 
+    /**
+     * 用于创建新的列表项视图。
+     */
     @Override
     public View newView(Context context, Cursor cursor, ViewGroup parent) {
         return new NotesListItem(context);
     }
 
+    /**
+     * 用于绑定数据到列表项视图。
+     */
     @Override
     public void bindView(View view, Context context, Cursor cursor) {
         if (view instanceof NotesListItem) {
@@ -64,20 +75,32 @@ public class NotesListAdapter extends CursorAdapter {
         }
     }
 
+    /**
+     * 用于设置指定位置的列表项的选择状态，并刷新视图。
+     */
     public void setCheckedItem(final int position, final boolean checked) {
         mSelectedIndex.put(position, checked);
         notifyDataSetChanged();
     }
 
+    /**
+     * 用于检查是否处于选择模式。
+     */
     public boolean isInChoiceMode() {
         return mChoiceMode;
     }
 
+    /**
+     * 用于设置选择模式。
+     */
     public void setChoiceMode(boolean mode) {
         mSelectedIndex.clear();
         mChoiceMode = mode;
     }
 
+    /**
+     * 用于选择或取消选择所有列表项。
+     */
     public void selectAll(boolean checked) {
         Cursor cursor = getCursor();
         for (int i = 0; i < getCount(); i++) {
@@ -89,6 +112,9 @@ public class NotesListAdapter extends CursorAdapter {
         }
     }
 
+    /**
+     * 用于获取选择的列表项的ID集合。
+     */
     public HashSet<Long> getSelectedItemIds() {
         HashSet<Long> itemSet = new HashSet<Long>();
         for (Integer position : mSelectedIndex.keySet()) {
@@ -105,6 +131,9 @@ public class NotesListAdapter extends CursorAdapter {
         return itemSet;
     }
 
+    /**
+     * 用于获取选择的小部件集合。
+     */
     public HashSet<AppWidgetAttribute> getSelectedWidget() {
         HashSet<AppWidgetAttribute> itemSet = new HashSet<AppWidgetAttribute>();
         for (Integer position : mSelectedIndex.keySet()) {
@@ -128,6 +157,9 @@ public class NotesListAdapter extends CursorAdapter {
         return itemSet;
     }
 
+    /**
+     * 用于获取当前选中的列表项数量。
+     */
     public int getSelectedCount() {
         Collection<Boolean> values = mSelectedIndex.values();
         if (null == values) {
@@ -143,11 +175,17 @@ public class NotesListAdapter extends CursorAdapter {
         return count;
     }
 
+    /**
+     * 用于检查是否所有列表项都被选中。
+     */
     public boolean isAllSelected() {
         int checkedCount = getSelectedCount();
         return (checkedCount != 0 && checkedCount == mNotesCount);
     }
 
+    /**
+     * 用于检查指定位置的列表项是否被选中。
+     */
     public boolean isSelectedItem(final int position) {
         if (null == mSelectedIndex.get(position)) {
             return false;
@@ -155,18 +193,28 @@ public class NotesListAdapter extends CursorAdapter {
         return mSelectedIndex.get(position);
     }
 
+    /**
+     * 在数据内容发生变化时被调用
+     * 用于重新计算笔记数量
+     */
     @Override
     protected void onContentChanged() {
         super.onContentChanged();
         calcNotesCount();
     }
-
+    /**
+     * 在切换数据源时被调用
+     * 用于重新计算笔记数量
+     */
     @Override
     public void changeCursor(Cursor cursor) {
         super.changeCursor(cursor);
         calcNotesCount();
     }
 
+    /**
+     *用于计算笔记的数量，它遍历所有的列表项并统计笔记的数量。
+     */
     private void calcNotesCount() {
         mNotesCount = 0;
         for (int i = 0; i < getCount(); i++) {