新增注释

NotesListActivity.java

@@ -370,41 +370,58 @@ private class ModeCallback implements ListView.MultiChoiceModeListener, OnMenuIt
 }
 
 
-        public boolean onPrepareActionMode(ActionMode mode, Menu menu) {
+// 这是ActionMode.Callback接口的实现，用于处理上下文操作模式（Contextual Action Mode）中的各种事件。
-            // TODO Auto-generated method stub
+
+// 当准备ActionMode时调用此方法，可以在此方法中初始化菜单。
+public boolean onPrepareActionMode(ActionMode mode, Menu menu) {
+        // 该方法目前未实现具体功能，返回false表示不处理菜单。
     return false;
-        }
+}
 
-        public boolean onActionItemClicked(ActionMode mode, MenuItem item) {
+// 当ActionMode中的菜单项被点击时调用此方法。
-            // TODO Auto-generated method stub
+public boolean onActionItemClicked(ActionMode mode, MenuItem item) {
+        // 该方法目前未实现具体功能，返回false表示不处理点击事件。
     return false;
-        }
+}
 
-        public void onDestroyActionMode(ActionMode mode) {
+// 当ActionMode结束时调用此方法，可以进行清理工作。
+public void onDestroyActionMode(ActionMode mode) {
+    // 关闭列表适配器的选择模式。
     mNotesListAdapter.setChoiceMode(false);
+    // 设置列表视图可长按。
     mNotesListView.setLongClickable(true);
+    // 显示添加新笔记的视图。
     mAddNewNote.setVisibility(View.VISIBLE);
-        }
+}
 
-        public void finishActionMode() {
+// 结束当前的ActionMode。
+public void finishActionMode() {
+    // 调用ActionMode的finish方法来结束模式。
     mActionMode.finish();
-        }
+}
 
-        public void onItemCheckedStateChanged(ActionMode mode, int position, long id,
+// 当列表项的选中状态改变时调用此方法。
+public void onItemCheckedStateChanged(ActionMode mode, int position, long id,
                                       boolean checked) {
+    // 更新列表适配器中指定位置的选中状态。
     mNotesListAdapter.setCheckedItem(position, checked);
+    // 更新菜单。
     updateMenu();
-        }
+}
 
-        public boolean onMenuItemClick(MenuItem item) {
+// 当菜单项被点击时调用此方法。
+public boolean onMenuItemClick(MenuItem item) {
+    // 如果没有选中任何项，显示提示信息并返回true表示已处理点击事件。
     if (mNotesListAdapter.getSelectedCount() == 0) {
         Toast.makeText(NotesListActivity.this, getString(R.string.menu_select_none),
                         Toast.LENGTH_SHORT).show();
         return true;
     }
 
+    // 根据菜单项的ID处理不同的点击事件。
     switch (item.getItemId()) {
         case R.id.delete:
+            // 构建一个对话框，提示用户是否删除选中的笔记。
             AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
             builder.setTitle(getString(R.string.alert_title_delete));
             builder.setIcon(android.R.drawable.ic_dialog_alert);
@@ -414,6 +431,7 @@ private class ModeCallback implements ListView.MultiChoiceModeListener, OnMenuIt
                                       new DialogInterface.OnClickListener() {
                                           public void onClick(DialogInterface dialog,
                                                                int which) {
+                                              // 如果用户确认删除，则调用批量删除方法。
                                               batchDelete();
                                           }
                                       });
@@ -421,15 +439,17 @@ private class ModeCallback implements ListView.MultiChoiceModeListener, OnMenuIt
             builder.show();
             break;
         case R.id.move:
+            // 启动查询目标文件夹的操作。
             startQueryDestinationFolders();
             break;
         default:
+            // 如果不是已知的菜单项，返回false表示未处理点击事件。
             return false;
     }
+    // 返回true表示已处理点击事件。
     return true;
-        }
+}
-    }
+}
-
     private class NewNoteOnTouchListener implements OnTouchListener {
 
         public boolean onTouch(View v, MotionEvent event) {