修改

src/Notes/app/src/main/java/net/micode/notes/ui/NotesListAdapter.java

@@ -1,184 +0,0 @@
-/*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package net.micode.notes.ui;
-
-import android.content.Context;
-import android.database.Cursor;
-import android.util.Log;
-import android.view.View;
-import android.view.ViewGroup;
-import android.widget.CursorAdapter;
-
-import net.micode.notes.data.Notes;
-
-import java.util.Collection;
-import java.util.HashMap;
-import java.util.HashSet;
-import java.util.Iterator;
-
-
-public class NotesListAdapter extends CursorAdapter {
-    private static final String TAG = "NotesListAdapter";
-    private Context mContext;
-    private HashMap<Integer, Boolean> mSelectedIndex;
-    private int mNotesCount;
-    private boolean mChoiceMode;
-
-    public static class AppWidgetAttribute {
-        public int widgetId;
-        public int widgetType;
-    };
-
-    public NotesListAdapter(Context context) {
-        super(context, null);
-        mSelectedIndex = new HashMap<Integer, Boolean>();
-        mContext = context;
-        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) {
-            NoteItemData itemData = new NoteItemData(context, cursor);
-            ((NotesListItem) view).bind(context, itemData, mChoiceMode,
-                    isSelectedItem(cursor.getPosition()));
-        }
-    }
-
-    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++) {
-            if (cursor.moveToPosition(i)) {
-                if (NoteItemData.getNoteType(cursor) == Notes.TYPE_NOTE) {
-                    setCheckedItem(i, checked);
-                }
-            }
-        }
-    }
-
-    public HashSet<Long> getSelectedItemIds() {
-        HashSet<Long> itemSet = new HashSet<Long>();
-        for (Integer position : mSelectedIndex.keySet()) {
-            if (mSelectedIndex.get(position) == true) {
-                Long id = getItemId(position);
-                if (id == Notes.ID_ROOT_FOLDER) {
-                    Log.d(TAG, "Wrong item id, should not happen");
-                } else {
-                    itemSet.add(id);
-                }
-            }
-        }
-
-        return itemSet;
-    }
-
-    public HashSet<AppWidgetAttribute> getSelectedWidget() {
-        HashSet<AppWidgetAttribute> itemSet = new HashSet<AppWidgetAttribute>();
-        for (Integer position : mSelectedIndex.keySet()) {
-            if (mSelectedIndex.get(position) == true) {
-                Cursor c = (Cursor) getItem(position);
-                if (c != null) {
-                    AppWidgetAttribute widget = new AppWidgetAttribute();
-                    NoteItemData item = new NoteItemData(mContext, c);
-                    widget.widgetId = item.getWidgetId();
-                    widget.widgetType = item.getWidgetType();
-                    itemSet.add(widget);
-                    /**
-                     * Don't close cursor here, only the adapter could close it
-                     */
-                } else {
-                    Log.e(TAG, "Invalid cursor");
-                    return null;
-                }
-            }
-        }
-        return itemSet;
-    }
-
-    public int getSelectedCount() {
-        Collection<Boolean> values = mSelectedIndex.values();
-        if (null == values) {
-            return 0;
-        }
-        Iterator<Boolean> iter = values.iterator();
-        int count = 0;
-        while (iter.hasNext()) {
-            if (true == iter.next()) {
-                count++;
-            }
-        }
-        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;
-        }
-        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++) {
-            Cursor c = (Cursor) getItem(i);
-            if (c != null) {
-                if (NoteItemData.getNoteType(c) == Notes.TYPE_NOTE) {
-                    mNotesCount++;
-                }
-            } else {
-                Log.e(TAG, "Invalid cursor");
-                return;
-            }
-        }
-    }
-}

src/Notes/app/src/main/res/values/colors.xml

@@ -1,7 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<resources>
-    <color name="black">#FF000000</color>
-    <color name="white">#FFFFFFFF</color>
-    <color name="user_query_highlight">#335b5b5b</color>
-
-</resources>

src/Notes/build.gradle.kts

@@ -1,6 +0,0 @@
-// Top-level build file where you can add configuration options common to all sub-projects/modules.
-@Suppress("DSL_SCOPE_VIOLATION") // TODO: Remove once KTIJ-19369 is fixed
-plugins {
-    alias(libs.plugins.androidApplication) apply false
-}
-true // Needed to make the Suppress annotation work for the plugins block

src/Notesmaster/.idea/.gitignore

@@ -0,0 +1,3 @@
+# Default ignored files
+/shelf/
+/workspace.xml

src/Notesmaster/.idea/.name

@@ -0,0 +1 @@
+Notes-master

src/Notesmaster/.idea/compiler.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="CompilerConfiguration">
+    <bytecodeTargetLevel target="21" />
+  </component>
+</project>

src/Notesmaster/.idea/deploymentTargetSelector.xml

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="deploymentTargetSelector">
+    <selectionStates>
+      <SelectionState runConfigName="app">
+        <option name="selectionMode" value="DROPDOWN" />
+        <DropdownSelection timestamp="2024-12-20T09:19:31.518867100Z">
+          <Target type="DEFAULT_BOOT">
+            <handle>
+              <DeviceId pluginId="Default" identifier="serial=emulator-5554;connection=13b9b5d6" />
+            </handle>
+          </Target>
+        </DropdownSelection>
+        <DialogSelection>
+          <targets>
+            <Target type="DEFAULT_BOOT">
+              <handle>
+                <DeviceId pluginId="Default" identifier="serial=127.0.0.1:5555;connection=ca5d55c9" />
+              </handle>
+            </Target>
+          </targets>
+        </DialogSelection>
+      </SelectionState>
+      <SelectionState runConfigName="AlarmAlertActivity">
+        <option name="selectionMode" value="DROPDOWN" />
+      </SelectionState>
+      <SelectionState runConfigName="AlarmAlertActivity (1)">
+        <option name="selectionMode" value="DROPDOWN" />
+      </SelectionState>
+    </selectionStates>
+  </component>
+</project>

src/Notesmaster/.idea/gradle.xml

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="GradleMigrationSettings" migrationVersion="1" />
+  <component name="GradleSettings">
+    <option name="linkedExternalProjectsSettings">
+      <GradleProjectSettings>
+        <option name="testRunner" value="CHOOSE_PER_TEST" />
+        <option name="externalProjectPath" value="$PROJECT_DIR$" />
+        <option name="gradleJvm" value="#GRADLE_LOCAL_JAVA_HOME" />
+        <option name="modules">
+          <set>
+            <option value="$PROJECT_DIR$" />
+            <option value="$PROJECT_DIR$/app" />
+          </set>
+        </option>
+        <option name="resolveExternalAnnotations" value="false" />
+      </GradleProjectSettings>
+    </option>
+  </component>
+</project>

src/Notesmaster/.idea/migrations.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectMigrations">
+    <option name="MigrateToGradleLocalJavaHome">
+      <set>
+        <option value="$PROJECT_DIR$" />
+      </set>
+    </option>
+  </component>
+</project>

src/Notesmaster/.idea/misc.xml

@@ -0,0 +1,9 @@
+<project version="4">
+  <component name="ExternalStorageConfigurationManager" enabled="true" />
+  <component name="ProjectRootManager" version="2" languageLevel="JDK_21" default="true" project-jdk-name="jbr-21" project-jdk-type="JavaSDK">
+    <output url="file://$PROJECT_DIR$/build/classes" />
+  </component>
+  <component name="ProjectType">
+    <option name="id" value="Android" />
+  </component>
+</project>

src/Notesmaster/.idea/runConfigurations.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="RunConfigurationProducerService">
+    <option name="ignoredProducers">
+      <set>
+        <option value="com.intellij.execution.junit.AbstractAllInDirectoryConfigurationProducer" />
+        <option value="com.intellij.execution.junit.AllInPackageConfigurationProducer" />
+        <option value="com.intellij.execution.junit.PatternConfigurationProducer" />
+        <option value="com.intellij.execution.junit.TestInClassConfigurationProducer" />
+        <option value="com.intellij.execution.junit.UniqueIdConfigurationProducer" />
+        <option value="com.intellij.execution.junit.testDiscovery.JUnitTestDiscoveryConfigurationProducer" />
+        <option value="org.jetbrains.kotlin.idea.junit.KotlinJUnitRunConfigurationProducer" />
+        <option value="org.jetbrains.kotlin.idea.junit.KotlinPatternConfigurationProducer" />
+      </set>
+    </option>
+  </component>
+</project>

src/Notesmaster/app/build.gradle.kts

@@ -1,9 +1,15 @@
-@Suppress("DSL_SCOPE_VIOLATION") // TODO: Remove once KTIJ-19369 is fixed
 plugins {
-    alias(libs.plugins.androidApplication)
+    alias(libs.plugins.android.application)
 }
 
 android {
+    packaging {
+        resources.excludes.add("META-INF/DEPENDENCIES");
+        resources.excludes.add("META-INF/NOTICE");
+        resources.excludes.add("META-INF/LICENSE");
+        resources.excludes.add("META-INF/LICENSE.txt");
+        resources.excludes.add("META-INF/NOTICE.txt");
+    }
     namespace = "net.micode.notes"
     compileSdk = 34
 
@@ -27,15 +33,8 @@ android {
         }
     }
     compileOptions {
-        sourceCompatibility = JavaVersion.VERSION_1_8
+        sourceCompatibility = JavaVersion.VERSION_11
-        targetCompatibility = JavaVersion.VERSION_1_8
+        targetCompatibility = JavaVersion.VERSION_11
-    }
-    packaging {
-        resources.excludes.add("META-INF/DEPENDENCIES");
-        resources.excludes.add("META-INF/NOTICE");
-        resources.excludes.add("META-INF/LICENSE");
-        resources.excludes.add("META-INF/LICENSE.txt");
-        resources.excludes.add("META-INF/NOTICE.txt");
     }
 }
 
@@ -43,18 +42,19 @@ dependencies {
 
     implementation(libs.appcompat)
     implementation(libs.material)
+    implementation(libs.activity)
     implementation(libs.constraintlayout)
+    //    部分需要重新修改
 //    implementation(fileTree(mapOf(
-//        "dir" to "D:\\AndroidWorkspace\\Notes\\httpcomponents-client-4.5.14-bin\\lib",
+//        "dir" to "D:\\Code\\AndroidCode\\Notesmaster\\httpcomponents-client-4.5.14-bin\\lib",
 //        "include" to listOf("*.aar", "*.jar"),
 //        "exclude" to listOf("")
 //    )))
-    //    部分需要重新修改
     //修改为如下代码：
-    implementation(files("D:\\AndroidWorkspace\\Notes\\httpcomponents-client-4.5.14-bin\\lib\\httpclient-osgi-4.5.14.jar"))
+    implementation(files("C:\\Users\\Zhoo\\AndroidStudioProjects\\Notesmaster\\httpcomponents-client-4.5.14-bin\\lib\\httpclient-osgi-4.5.14.jar"))
-    implementation(files("D:\\AndroidWorkspace\\Notes\\httpcomponents-client-4.5.14-bin\\lib\\httpclient-win-4.5.14.jar"))
+    implementation(files("C:\\Users\\Zhoo\\AndroidStudioProjects\\Notesmaster\\httpcomponents-client-4.5.14-bin\\lib\\httpclient-win-4.5.14.jar"))
-    implementation(files("D:\\AndroidWorkspace\\Notes\\httpcomponents-client-4.5.14-bin\\lib\\httpcore-4.4.16.jar"))
+    implementation(files("C:\\Users\\Zhoo\\AndroidStudioProjects\\Notesmaster\\httpcomponents-client-4.5.14-bin\\lib\\httpcore-4.4.16.jar"))
     testImplementation(libs.junit)
-    androidTestImplementation(libs.androidx.test.ext.junit)
+    androidTestImplementation(libs.ext.junit)
     androidTestImplementation(libs.espresso.core)
 }

src/Notesmaster/app/src/main/AndroidManifest.xml

@@ -13,6 +13,7 @@
     <uses-permission android:name="android.permission.USE_CREDENTIALS" />
     <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
 
+
     <application
         android:allowBackup="true"
         android:dataExtractionRules="@xml/data_extraction_rules"
@@ -21,9 +22,11 @@
         android:label="@string/app_name"
         android:roundIcon="@mipmap/ic_launcher_round"
         android:supportsRtl="true"
-        android:theme="@style/Theme.Notes"
+        android:theme="@style/Theme.Notesmaster"
         tools:targetApi="31">
+
         <activity
+
             android:name=".ui.NotesListActivity"
             android:configChanges="keyboardHidden|orientation|screenSize"
             android:label="@string/app_name"
@@ -37,17 +40,18 @@
                 <action android:name="android.intent.action.MAIN" />
                 <category android:name="android.intent.category.LAUNCHER" />
             </intent-filter>
+
         </activity>
 
         <activity
+
             android:name=".ui.NoteEditActivity"
             android:configChanges="keyboardHidden|orientation|screenSize"
             android:launchMode="singleTop"
             android:theme="@style/NoteTheme"
             android:exported="true">
 
-            <intent-filter android:scheme="http"
+            <intent-filter>
-                tools:ignore="AppLinkUrlError">
                 <action android:name="android.intent.action.VIEW" />
                 <category android:name="android.intent.category.DEFAULT" />
                 <data android:mimeType="vnd.android.cursor.item/text_note" />
@@ -69,10 +73,11 @@
             <meta-data
                 android:name="android.app.searchable"
                 android:resource="@xml/searchable" />
+
         </activity>
 
+
         <provider
-            android:exported="true"
             android:name="net.micode.notes.data.NotesProvider"
             android:authorities="micode_notes"
             android:multiprocess="true" />
@@ -92,9 +97,9 @@
                 android:resource="@xml/widget_2x_info" />
         </receiver>
         <receiver
-            android:exported="true"
             android:name=".widget.NoteWidgetProvider_4x"
-            android:label="@string/app_widget4x4" >
+            android:label="@string/app_widget4x4"
+            android:exported="true">
 
             <intent-filter>
                 <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
@@ -107,9 +112,8 @@
                 android:resource="@xml/widget_4x_info" />
         </receiver>
 
-        <receiver
+        <receiver android:name=".ui.AlarmInitReceiver"
-            android:exported="true"
+            android:exported="true">
-            android:name=".ui.AlarmInitReceiver" >
             <intent-filter>
                 <action android:name="android.intent.action.BOOT_COMPLETED" />
             </intent-filter>
@@ -143,6 +147,16 @@
             android:name="android.app.default_searchable"
             android:value=".ui.NoteEditActivity" />
 
+                <activity
+                    android:name=".MainActivity"
+                    android:exported="true">
+                    <intent-filter>
+                        <action android:name="android.intent.action.MAIN" />
+
+                        <category android:name="android.intent.category.LAUNCHER" />
+                    </intent-filter>
+                </activity>
+
     </application>
 
 </manifest>

src/Notesmaster/app/src/main/java/net/micode/notes/MainActivity.java

@@ -0,0 +1,24 @@
+package net.micode.notes;
+
+import android.os.Bundle;
+
+import androidx.activity.EdgeToEdge;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.core.graphics.Insets;
+import androidx.core.view.ViewCompat;
+import androidx.core.view.WindowInsetsCompat;
+
+public class MainActivity extends AppCompatActivity {
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        EdgeToEdge.enable(this);
+        setContentView(R.layout.activity_main);
+        ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main), (v, insets) -> {
+            Insets systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars());
+            v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom);
+            return insets;
+        });
+    }
+}

src/Notesmaster/app/src/main/java/net/micode/notes/ui/NoteEditActivity.java

@@ -71,19 +71,25 @@ import java.util.Map;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
 
-
+/**
+ * NoteEditActivity 是用于编辑笔记的活动类。它允许用户创建、修改、删除笔记，设置提醒，以及将笔记发送到桌面或分享给他人。
+ */
 public class NoteEditActivity extends Activity implements OnClickListener,
         NoteSettingChangedListener, OnTextViewChangeListener {
-    private class HeadViewHolder {
-        public TextView tvModified;
-
-        public ImageView ivAlertIcon;
-
-        public TextView tvAlertDate;
 
-        public ImageView ibSetBgColor;
+    /**
+     * HeadViewHolder 是一个内部类，用于持有头部的视图组件，如修改日期、提醒图标和日期。
+     */
+    private class HeadViewHolder {
+        public TextView tvModified; // 显示修改日期的 TextView
+        public ImageView ivAlertIcon; // 显示提醒图标的 ImageView
+        public TextView tvAlertDate; // 显示提醒日期的 TextView
+        public ImageView ibSetBgColor; // 设置背景颜色的 ImageView
     }
 
+    /**
+     * sBgSelectorBtnsMap 是一个静态的 HashMap，用于将背景颜色选择按钮的 ID 映射到对应的颜色资源 ID。
+     */
     private static final Map<Integer, Integer> sBgSelectorBtnsMap = new HashMap<Integer, Integer>();
     static {
         sBgSelectorBtnsMap.put(R.id.iv_bg_yellow, ResourceParser.YELLOW);
@@ -93,6 +99,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         sBgSelectorBtnsMap.put(R.id.iv_bg_white, ResourceParser.WHITE);
     }
 
+    /**
+     * sBgSelectorSelectionMap 是一个静态的 HashMap，用于将颜色资源 ID 映射到对应的选中状态按钮的 ID。
+     */
     private static final Map<Integer, Integer> sBgSelectorSelectionMap = new HashMap<Integer, Integer>();
     static {
         sBgSelectorSelectionMap.put(ResourceParser.YELLOW, R.id.iv_bg_yellow_select);
@@ -102,6 +111,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         sBgSelectorSelectionMap.put(ResourceParser.WHITE, R.id.iv_bg_white_select);
     }
 
+    /**
+     * sFontSizeBtnsMap 是一个静态的 HashMap，用于将字体大小选择按钮的 ID 映射到对应的字体大小资源 ID。
+     */
     private static final Map<Integer, Integer> sFontSizeBtnsMap = new HashMap<Integer, Integer>();
     static {
         sFontSizeBtnsMap.put(R.id.ll_font_large, ResourceParser.TEXT_LARGE);
@@ -110,6 +122,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         sFontSizeBtnsMap.put(R.id.ll_font_super, ResourceParser.TEXT_SUPER);
     }
 
+    /**
+     * sFontSelectorSelectionMap 是一个静态的 HashMap，用于将字体大小资源 ID 映射到对应的选中状态按钮的 ID。
+     */
     private static final Map<Integer, Integer> sFontSelectorSelectionMap = new HashMap<Integer, Integer>();
     static {
         sFontSelectorSelectionMap.put(ResourceParser.TEXT_LARGE, R.id.iv_large_select);
@@ -118,37 +133,90 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         sFontSelectorSelectionMap.put(ResourceParser.TEXT_SUPER, R.id.iv_super_select);
     }
 
+    /**
+     * TAG 是一个静态常量，用于日志记录。
+     */
     private static final String TAG = "NoteEditActivity";
 
+    /**
+     * mNoteHeaderHolder 是 HeadViewHolder 的实例，用于持有头部的视图组件。
+     */
     private HeadViewHolder mNoteHeaderHolder;
 
+    /**
+     * mHeadViewPanel 是头部的面板视图。
+     */
     private View mHeadViewPanel;
 
+    /**
+     * mNoteBgColorSelector 是用于选择背景颜色的面板视图。
+     */
     private View mNoteBgColorSelector;
 
+    /**
+     * mFontSizeSelector 是用于选择字体大小的面板视图。
+     */
     private View mFontSizeSelector;
 
+    /**
+     * mNoteEditor 是用于编辑笔记内容的 EditText。
+     */
     private EditText mNoteEditor;
 
+    /**
+     * mNoteEditorPanel 是编辑笔记内容的面板视图。
+     */
     private View mNoteEditorPanel;
 
+    /**
+     * mWorkingNote 是当前正在编辑的 WorkingNote 实例。
+     */
     private WorkingNote mWorkingNote;
 
+    /**
+     * mSharedPrefs 是 SharedPreferences 的实例，用于存储用户偏好设置。
+     */
     private SharedPreferences mSharedPrefs;
+
+    /**
+     * mFontSizeId 是当前选中的字体大小资源 ID。
+     */
     private int mFontSizeId;
 
+    /**
+     * PREFERENCE_FONT_SIZE 是存储字体大小偏好设置的键。
+     */
     private static final String PREFERENCE_FONT_SIZE = "pref_font_size";
 
+    /**
+     * SHORTCUT_ICON_TITLE_MAX_LEN 是快捷方式图标标题的最大长度。
+     */
     private static final int SHORTCUT_ICON_TITLE_MAX_LEN = 10;
 
+    /**
+     * TAG_CHECKED 和 TAG_UNCHECKED 是用于表示复选框状态的标签。
+     */
     public static final String TAG_CHECKED = String.valueOf('\u221A');
     public static final String TAG_UNCHECKED = String.valueOf('\u25A1');
 
+    /**
+     * mEditTextList 是包含多个 NoteEditText 的 LinearLayout，用于编辑列表模式的笔记。
+     */
     private LinearLayout mEditTextList;
 
+    /**
+     * mUserQuery 是用户查询的字符串，用于高亮显示搜索结果。
+     */
     private String mUserQuery;
+
+    /**
+     * mPattern 是用于匹配用户查询的正则表达式模式。
+     */
     private Pattern mPattern;
 
+    /**
+     * onCreate 方法是活动的入口点，负责初始化活动状态和资源。
+     */
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
@@ -162,8 +230,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
     }
 
     /**
-     * Current activity may be killed when the memory is low. Once it is killed, for another time
+     * onRestoreInstanceState 方法用于恢复活动状态。如果活动被系统杀死并重新创建，则从保存的状态中恢复。
-     * user load this activity, we should restore the former state
      */
     @Override
     protected void onRestoreInstanceState(Bundle savedInstanceState) {
@@ -179,19 +246,18 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         }
     }
 
+    /**
+     * initActivityState 方法用于根据传入的 Intent 初始化活动状态。如果用户指定了 ACTION_VIEW 但未提供 ID，则跳转到 NotesListActivity。
+     *
+     * @param intent 传入的 Intent
+     * @return 如果初始化成功则返回 true，否则返回 false
+     */
     private boolean initActivityState(Intent intent) {
-        /**
-         * If the user specified the {@link Intent#ACTION_VIEW} but not provided with id,
-         * then jump to the NotesListActivity
-         */
         mWorkingNote = null;
         if (TextUtils.equals(Intent.ACTION_VIEW, intent.getAction())) {
             long noteId = intent.getLongExtra(Intent.EXTRA_UID, 0);
             mUserQuery = "";
 
-            /**
-             * Starting from the searched result
-             */
             if (intent.hasExtra(SearchManager.EXTRA_DATA_KEY)) {
                 noteId = Long.parseLong(intent.getStringExtra(SearchManager.EXTRA_DATA_KEY));
                 mUserQuery = intent.getStringExtra(SearchManager.USER_QUERY);
@@ -215,7 +281,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
                     WindowManager.LayoutParams.SOFT_INPUT_STATE_HIDDEN
                             | WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE);
         } else if(TextUtils.equals(Intent.ACTION_INSERT_OR_EDIT, intent.getAction())) {
-            // New note
+            // 新笔记
             long folderId = intent.getLongExtra(Notes.INTENT_EXTRA_FOLDER_ID, 0);
             int widgetId = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_ID,
                     AppWidgetManager.INVALID_APPWIDGET_ID);
@@ -224,7 +290,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
             int bgResId = intent.getIntExtra(Notes.INTENT_EXTRA_BACKGROUND_ID,
                     ResourceParser.getDefaultBgId(this));
 
-            // Parse call-record note
+            // 解析通话记录笔记
             String phoneNumber = intent.getStringExtra(Intent.EXTRA_PHONE_NUMBER);
             long callDate = intent.getLongExtra(Notes.INTENT_EXTRA_CALL_DATE, 0);
             if (callDate != 0 && phoneNumber != null) {
@@ -262,12 +328,18 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         return true;
     }
 
+    /**
+     * onResume 方法在活动恢复时调用，初始化笔记屏幕。
+     */
     @Override
     protected void onResume() {
         super.onResume();
         initNoteScreen();
     }
 
+    /**
+     * initNoteScreen 方法用于初始化笔记屏幕，包括设置文本外观、切换到列表模式或高亮显示查询结果。
+     */
     private void initNoteScreen() {
         mNoteEditor.setTextAppearance(this, TextAppearanceResources
                 .getTexAppearanceResource(mFontSizeId));
@@ -295,6 +367,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         showAlertHeader();
     }
 
+    /**
+     * showAlertHeader 方法用于显示提醒头部的信息。如果设置了提醒，则显示提醒日期，否则隐藏。
+     */
     private void showAlertHeader() {
         if (mWorkingNote.hasClockAlert()) {
             long time = System.currentTimeMillis();
@@ -312,20 +387,21 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         };
     }
 
+    /**
+     * onNewIntent 方法在活动接收到新的 Intent 时调用，重新初始化活动状态。
+     */
     @Override
     protected void onNewIntent(Intent intent) {
         super.onNewIntent(intent);
         initActivityState(intent);
     }
 
+    /**
+     * onSaveInstanceState 方法用于保存活动状态，以便在活动被系统杀死后恢复。
+     */
     @Override
     protected void onSaveInstanceState(Bundle outState) {
         super.onSaveInstanceState(outState);
-        /**
-         * For new note without note id, we should firstly save it to
-         * generate a id. If the editing note is not worth saving, there
-         * is no id which is equivalent to create new note
-         */
         if (!mWorkingNote.existInDatabase()) {
             saveNote();
         }
@@ -333,6 +409,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         Log.d(TAG, "Save working note id: " + mWorkingNote.getNoteId() + " onSaveInstanceState");
     }
 
+    /**
+     * dispatchTouchEvent 方法用于处理触摸事件。当点击区域不在背景颜色选择器或字体大小选择器内时，隐藏选择器。
+     */
     @Override
     public boolean dispatchTouchEvent(MotionEvent ev) {
         if (mNoteBgColorSelector.getVisibility() == View.VISIBLE
@@ -349,6 +428,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         return super.dispatchTouchEvent(ev);
     }
 
+    /**
+     * inRangeOfView 方法用于判断触摸点是否在指定视图的范围内。
+     */
     private boolean inRangeOfView(View view, MotionEvent ev) {
         int []location = new int[2];
         view.getLocationOnScreen(location);
@@ -358,11 +440,14 @@ public class NoteEditActivity extends Activity implements OnClickListener,
                 || ev.getX() > (x + view.getWidth())
                 || ev.getY() < y
                 || ev.getY() > (y + view.getHeight())) {
-                    return false;
+            return false;
-                }
+        }
         return true;
     }
 
+    /**
+     * initResources 方法用于初始化资源，包括头部视图、背景颜色选择器、字体大小选择器等。
+     */
     private void initResources() {
         mHeadViewPanel = findViewById(R.id.note_title);
         mNoteHeaderHolder = new HeadViewHolder();
@@ -397,6 +482,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         mEditTextList = (LinearLayout) findViewById(R.id.note_edit_list);
     }
 
+    /**
+     * onPause 方法在活动暂停时调用，保存笔记数据并清除设置状态。
+     */
     @Override
     protected void onPause() {
         super.onPause();
@@ -406,6 +494,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         clearSettingState();
     }
 
+    /**
+     * updateWidget 方法用于更新小部件。
+     */
     private void updateWidget() {
         Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE);
         if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_2X) {
@@ -418,19 +509,22 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         }
 
         intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS, new int[] {
-            mWorkingNote.getWidgetId()
+                mWorkingNote.getWidgetId()
         });
 
         sendBroadcast(intent);
         setResult(RESULT_OK, intent);
     }
 
+    /**
+     * onClick 方法用于处理点击事件，根据点击的视图 ID 执行不同的操作。
+     */
     public void onClick(View v) {
         int id = v.getId();
         if (id == R.id.btn_set_bg_color) {
             mNoteBgColorSelector.setVisibility(View.VISIBLE);
             findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility(
-                    -                    View.VISIBLE);
+                    View.VISIBLE);
         } else if (sBgSelectorBtnsMap.containsKey(id)) {
             findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility(
                     View.GONE);
@@ -452,6 +546,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         }
     }
 
+    /**
+     * onBackPressed 方法用于处理返回键事件。如果有选择器可见，则隐藏它们，否则调用父类方法。
+     */
     @Override
     public void onBackPressed() {
         if(clearSettingState()) {
@@ -462,6 +559,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         super.onBackPressed();
     }
 
+    /**
+     * clearSettingState 方法用于清除选择器的状态。如果有选择器可见，则隐藏它们并返回 true，否则返回 false。
+     */
     private boolean clearSettingState() {
         if (mNoteBgColorSelector.getVisibility() == View.VISIBLE) {
             mNoteBgColorSelector.setVisibility(View.GONE);
@@ -473,6 +573,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         return false;
     }
 
+    /**
+     * onBackgroundColorChanged 方法在背景颜色改变时被调用，更新背景颜色选择器的状态和背景视图。
+     */
     public void onBackgroundColorChanged() {
         findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility(
                 View.VISIBLE);
@@ -480,6 +583,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         mHeadViewPanel.setBackgroundResource(mWorkingNote.getTitleBgResId());
     }
 
+    /**
+     * onPrepareOptionsMenu 方法用于准备菜单选项。如果活动正在结束，则返回 true。
+     */
     @Override
     public boolean onPrepareOptionsMenu(Menu menu) {
         if (isFinishing()) {
@@ -505,6 +611,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         return true;
     }
 
+    /**
+     * onOptionsItemSelected 方法用于处理菜单选项点击事件，根据菜单项 ID 执行不同的操作。
+     */
     @Override
     public boolean onOptionsItemSelected(MenuItem item) {
         switch (item.getItemId()) {
@@ -553,6 +662,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         return true;
     }
 
+    /**
+     * setReminder 方法用于设置提醒。
+     */
     private void setReminder() {
         DateTimePickerDialog d = new DateTimePickerDialog(this, System.currentTimeMillis());
         d.setOnDateTimeSetListener(new OnDateTimeSetListener() {
@@ -564,8 +676,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
     }
 
     /**
-     * Share note to apps that support {@link Intent#ACTION_SEND} action
+     * sendTo 方法用于分享笔记内容到支持 ACTION_SEND 和 text/plain 类型的应用。
-     * and {@text/plain} type
      */
     private void sendTo(Context context, String info) {
         Intent intent = new Intent(Intent.ACTION_SEND);
@@ -574,11 +685,14 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         context.startActivity(intent);
     }
 
+    /**
+     * createNewNote 方法用于创建新笔记。首先保存当前编辑的笔记，然后启动一个新的 NoteEditActivity。
+     */
     private void createNewNote() {
-        // Firstly, save current editing notes
+        // 首先保存当前编辑的笔记
         saveNote();
 
-        // For safety, start a new NoteEditActivity
+        // 为了安全，创建一个新的 NoteEditActivity
         finish();
         Intent intent = new Intent(this, NoteEditActivity.class);
         intent.setAction(Intent.ACTION_INSERT_OR_EDIT);
@@ -586,6 +700,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         startActivity(intent);
     }
 
+    /**
+     * deleteCurrentNote 方法用于删除当前笔记。如果笔记存在于数据库中，则删除它。
+     */
     private void deleteCurrentNote() {
         if (mWorkingNote.existInDatabase()) {
             HashSet<Long> ids = new HashSet<Long>();
@@ -608,15 +725,17 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         mWorkingNote.markDeleted(true);
     }
 
+    /**
+     * isSyncMode 方法用于判断当前是否为同步模式。
+     */
     private boolean isSyncMode() {
         return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0;
     }
 
+    /**
+     * onClockAlertChanged 方法在时钟提醒改变时被调用。如果笔记未保存，则先保存笔记，然后设置提醒。
+     */
     public void onClockAlertChanged(long date, boolean set) {
-        /**
-         * User could set clock to an unsaved note, so before setting the
-         * alert clock, we should save the note first
-         */
         if (!mWorkingNote.existInDatabase()) {
             saveNote();
         }
@@ -632,20 +751,21 @@ public class NoteEditActivity extends Activity implements OnClickListener,
                 alarmManager.set(AlarmManager.RTC_WAKEUP, date, pendingIntent);
             }
         } else {
-            /**
-             * There is the condition that user has input nothing (the note is
-             * not worthy saving), we have no note id, remind the user that he
-             * should input something
-             */
             Log.e(TAG, "Clock alert setting error");
             showToast(R.string.error_note_empty_for_clock);
         }
     }
 
+    /**
+     * onWidgetChanged 方法在笔记小部件改变时被调用，更新小部件。
+     */
     public void onWidgetChanged() {
         updateWidget();
     }
 
+    /**
+     * onEditTextDelete 方法在删除编辑文本时被调用，处理删除逻辑。
+     */
     public void onEditTextDelete(int index, String text) {
         int childCount = mEditTextList.getChildCount();
         if (childCount == 1) {
@@ -672,10 +792,10 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         edit.setSelection(length);
     }
 
+    /**
+     * onEditTextEnter 方法在编辑文本进入时被调用，处理进入逻辑。
+     */
     public void onEditTextEnter(int index, String text) {
-        /**
-         * Should not happen, check for debug
-         */
         if(index > mEditTextList.getChildCount()) {
             Log.e(TAG, "Index out of mEditTextList boundrary, should not happen");
         }
@@ -691,6 +811,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         }
     }
 
+    /**
+     * switchToListMode 方法用于切换到列表模式，将笔记内容转换为列表。
+     */
     private void switchToListMode(String text) {
         mEditTextList.removeAllViews();
         String[] items = text.split("\n");
@@ -708,6 +831,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         mEditTextList.setVisibility(View.VISIBLE);
     }
 
+    /**
+     * getHighlightQueryResult 方法用于高亮显示查询结果。
+     */
     private Spannable getHighlightQueryResult(String fullText, String userQuery) {
         SpannableString spannable = new SpannableString(fullText == null ? "" : fullText);
         if (!TextUtils.isEmpty(userQuery)) {
@@ -725,6 +851,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         return spannable;
     }
 
+    /**
+     * getListItem 方法用于获取列表项视图。
+     */
     private View getListItem(String item, int index) {
         View view = LayoutInflater.from(this).inflate(R.layout.note_edit_list_item, null);
         final NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text);
@@ -756,6 +885,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         return view;
     }
 
+    /**
+     * onTextChange 方法在文本改变时被调用，处理文本变化逻辑。
+     */
     public void onTextChange(int index, boolean hasText) {
         if (index >= mEditTextList.getChildCount()) {
             Log.e(TAG, "Wrong index, should not happen");
@@ -768,13 +900,15 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         }
     }
 
+    /**
+     * onCheckListModeChanged 方法在列表模式改变时被调用，处理模式变化逻辑。
+     */
     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 + " ", "").trim());
-                        ""));
             }
             mNoteEditor.setText(getHighlightQueryResult(mWorkingNote.getContent(), mUserQuery));
             mEditTextList.setVisibility(View.GONE);
@@ -782,6 +916,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         }
     }
 
+    /**
+     * getWorkingText 方法用于获取当前正在编辑的文本。
+     */
     private boolean getWorkingText() {
         boolean hasChecked = false;
         if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {
@@ -805,28 +942,30 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         return hasChecked;
     }
 
+    /**
+     * saveNote 方法用于保存当前编辑的笔记。如果保存成功，则设置结果为 RESULT_OK。
+     *
+     * @return 如果保存成功则返回 true，否则返回 false
+     */
     private boolean saveNote() {
         getWorkingText();
         boolean saved = mWorkingNote.saveNote();
         if (saved) {
             /**
-             * There are two modes from List view to edit view, open one note,
+             * 从列表视图切换到编辑视图有两种模式：打开一个笔记，创建/编辑一个笔记。
-             * create/edit a node. Opening node requires to the original
+             * 打开笔记时，从编辑视图返回时需要回到列表中的原始位置，而创建新笔记时需要回到列表顶部。
-             * position in the list when back from edit view, while creating a
+             * 此处的 {@link #RESULT_OK} 用于标识创建/编辑状态
-             * new node requires to the top of the list. This code
-             * {@link #RESULT_OK} is used to identify the create/edit state
              */
             setResult(RESULT_OK);
         }
         return saved;
     }
 
+    /**
+     * sendToDesktop 方法用于将当前笔记发送到桌面作为快捷方式。
+     * 在发送之前，确保当前编辑的笔记存在于数据库中。如果笔记不存在，则先保存它。
+     */
     private void sendToDesktop() {
-        /**
-         * Before send message to home, we should make sure that current
-         * editing note is exists in databases. So, for new note, firstly
-         * save it
-         */
         if (!mWorkingNote.existInDatabase()) {
             saveNote();
         }
@@ -847,15 +986,20 @@ public class NoteEditActivity extends Activity implements OnClickListener,
             sendBroadcast(sender);
         } else {
             /**
-             * There is the condition that user has input nothing (the note is
+             * 如果用户没有输入任何内容（笔记不值得保存），则没有笔记 ID，提醒用户应该输入一些内容。
-             * not worthy saving), we have no note id, remind the user that he
-             * should input something
              */
             Log.e(TAG, "Send to desktop error");
             showToast(R.string.error_note_empty_for_send_to_desktop);
         }
     }
 
+    /**
+     * makeShortcutIconTitle 方法用于生成快捷方式图标的标题。
+     * 它会移除复选框标签，并截取前 10 个字符作为标题。
+     *
+     * @param content 笔记内容
+     * @return 快捷方式图标标题
+     */
     private String makeShortcutIconTitle(String content) {
         content = content.replace(TAG_CHECKED, "");
         content = content.replace(TAG_UNCHECKED, "");
@@ -863,11 +1007,22 @@ public class NoteEditActivity extends Activity implements OnClickListener,
                 SHORTCUT_ICON_TITLE_MAX_LEN) : content;
     }
 
+    /**
+     * showToast 方法用于显示短时间的 Toast 消息。
+     *
+     * @param resId 字符串资源 ID
+     */
     private void showToast(int resId) {
         showToast(resId, Toast.LENGTH_SHORT);
     }
 
+    /**
+     * showToast 方法用于显示指定时间长度的 Toast 消息。
+     *
+     * @param resId    字符串资源 ID
+     * @param duration Toast 显示的时长
+     */
     private void showToast(int resId, int duration) {
         Toast.makeText(this, resId, duration).show();
     }
-}
+}

src/Notesmaster/app/src/main/java/net/micode/notes/ui/NotesListAdapter.java

@@ -0,0 +1,270 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.ui;
+
+// 导入必要的Android类
+import android.content.Context;
+import android.database.Cursor;
+import android.util.Log;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.CursorAdapter;
+
+// 导入自定义的类和资源
+import net.micode.notes.data.Notes;
+
+import java.util.Collection;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.Iterator;
+
+/**
+ * NotesListAdapter类继承自CursorAdapter，用于在ListView中显示笔记列表。
+ * 该适配器支持多选模式，并管理选中的笔记项。
+ */
+public class NotesListAdapter extends CursorAdapter {
+    private static final String TAG = "NotesListAdapter"; // 日志标签
+    private Context mContext; // 上下文对象
+    private HashMap<Integer, Boolean> mSelectedIndex; // 存储选中项的位置和状态
+    private int mNotesCount; // 笔记总数
+    private boolean mChoiceMode; // 是否处于多选模式
+
+    /**
+     * 内部静态类，用于存储AppWidget的属性。
+     */
+    public static class AppWidgetAttribute {
+        public int widgetId; // Widget的ID
+        public int widgetType; // Widget的类型
+    }
+
+    /**
+     * 构造函数，初始化NotesListAdapter。
+     *
+     * @param context 上下文对象
+     */
+    public NotesListAdapter(Context context) {
+        super(context, null);
+        mSelectedIndex = new HashMap<Integer, Boolean>(); // 初始化选中项的HashMap
+        mContext = context;
+        mNotesCount = 0;
+    }
+
+    /**
+     * 创建新的视图。
+     *
+     * @param context 上下文对象
+     * @param cursor  游标对象，指向当前数据项
+     * @param parent  父视图组
+     * @return 新的视图对象
+     */
+    @Override
+    public View newView(Context context, Cursor cursor, ViewGroup parent) {
+        return new NotesListItem(context); // 返回一个新的NotesListItem对象
+    }
+
+    /**
+     * 绑定数据到现有视图。
+     *
+     * @param view    视图对象
+     * @param context 上下文对象
+     * @param cursor  游标对象，指向当前数据项
+     */
+    @Override
+    public void bindView(View view, Context context, Cursor cursor) {
+        if (view instanceof NotesListItem) { // 检查视图是否为NotesListItem
+            NoteItemData itemData = new NoteItemData(context, cursor); // 创建NoteItemData对象
+            ((NotesListItem) view).bind(context, itemData, mChoiceMode, // 绑定数据到NotesListItem
+                    isSelectedItem(cursor.getPosition()));
+        }
+    }
+
+    /**
+     * 设置指定位置的项为选中或未选中。
+     *
+     * @param position 位置
+     * @param checked  是否选中
+     */
+    public void setCheckedItem(final int position, final boolean checked) {
+        mSelectedIndex.put(position, checked); // 更新选中状态
+        notifyDataSetChanged(); // 通知数据变化
+    }
+
+    /**
+     * 判断当前是否处于多选模式。
+     *
+     * @return 如果处于多选模式，返回true；否则返回false
+     */
+    public boolean isInChoiceMode() {
+        return mChoiceMode;
+    }
+
+    /**
+     * 设置多选模式。
+     *
+     * @param mode 如果为true，则进入多选模式；否则退出多选模式
+     */
+    public void setChoiceMode(boolean mode) {
+        mSelectedIndex.clear(); // 清除所有选中状态
+        mChoiceMode = mode;
+    }
+
+    /**
+     * 全选或全不选。
+     *
+     * @param checked 如果为true，则全选；否则全不选
+     */
+    public void selectAll(boolean checked) {
+        Cursor cursor = getCursor(); // 获取当前游标
+        for (int i = 0; i < getCount(); i++) { // 遍历所有项
+            if (cursor.moveToPosition(i)) { // 移动到指定位置
+                if (NoteItemData.getNoteType(cursor) == Notes.TYPE_NOTE) { // 如果是普通笔记
+                    setCheckedItem(i, checked); // 设置选中状态
+                }
+            }
+        }
+    }
+
+    /**
+     * 获取所有选中的项的ID。
+     *
+     * @return 包含选中项ID的HashSet
+     */
+    public HashSet<Long> getSelectedItemIds() {
+        HashSet<Long> itemSet = new HashSet<Long>(); // 初始化HashSet
+        for (Integer position : mSelectedIndex.keySet()) { // 遍历所有选中项
+            if (mSelectedIndex.get(position) == true) { // 如果选中
+                Long id = getItemId(position); // 获取项的ID
+                if (id == Notes.ID_ROOT_FOLDER) { // 如果ID为根文件夹的ID
+                    Log.d(TAG, "Wrong item id, should not happen"); // 记录日志
+                } else {
+                    itemSet.add(id); // 添加到HashSet中
+                }
+            }
+        }
+
+        return itemSet; // 返回HashSet
+    }
+
+    /**
+     * 获取所有选中的Widget属性。
+     *
+     * @return 包含选中Widget属性的HashSet
+     */
+    public HashSet<AppWidgetAttribute> getSelectedWidget() {
+        HashSet<AppWidgetAttribute> itemSet = new HashSet<AppWidgetAttribute>(); // 初始化HashSet
+        for (Integer position : mSelectedIndex.keySet()) { // 遍历所有选中项
+            if (mSelectedIndex.get(position) == true) { // 如果选中
+                Cursor c = (Cursor) getItem(position); // 获取Cursor对象
+                if (c != null) {
+                    AppWidgetAttribute widget = new AppWidgetAttribute(); // 创建AppWidgetAttribute对象
+                    NoteItemData item = new NoteItemData(mContext, c); // 创建NoteItemData对象
+                    widget.widgetId = item.getWidgetId(); // 设置Widget ID
+                    widget.widgetType = item.getWidgetType(); // 设置Widget类型
+                    itemSet.add(widget); // 添加到HashSet中
+                    /**
+                     * Don't close cursor here, only the adapter could close it
+                     */
+                } else {
+                    Log.e(TAG, "Invalid cursor"); // 记录错误日志
+                    return null;
+                }
+            }
+        }
+        return itemSet; // 返回HashSet
+    }
+
+    /**
+     * 获取选中的项的数量。
+     *
+     * @return 选中的项的数量
+     */
+    public int getSelectedCount() {
+        Collection<Boolean> values = mSelectedIndex.values(); // 获取所有选中状态
+        if (null == values) {
+            return 0;
+        }
+        Iterator<Boolean> iter = values.iterator(); // 创建迭代器
+        int count = 0;
+        while (iter.hasNext()) { // 遍历所有选中状态
+            if (true == iter.next()) { // 如果选中
+                count++; // 增加计数
+            }
+        }
+        return count;
+    }
+
+    /**
+     * 判断是否所有项都被选中。
+     *
+     * @return 如果所有项都被选中，返回true；否则返回false
+     */
+    public boolean isAllSelected() {
+        int checkedCount = getSelectedCount(); // 获取选中项的数量
+        return (checkedCount != 0 && checkedCount == mNotesCount); // 判断是否所有项都被选中
+    }
+
+    /**
+     * 判断指定位置的项是否被选中。
+     *
+     * @param position 位置
+     * @return 如果被选中，返回true；否则返回false
+     */
+    public boolean isSelectedItem(final int position) {
+        if (null == mSelectedIndex.get(position)) { // 如果没有选中状态
+            return false;
+        }
+        return mSelectedIndex.get(position); // 返回选中状态
+    }
+
+    /**
+     * 当内容变化时调用。
+     */
+    @Override
+    protected void onContentChanged() {
+        super.onContentChanged(); // 调用父类方法
+        calcNotesCount(); // 计算笔记数量
+    }
+
+    /**
+     * 更改游标。
+     *
+     * @param cursor 新的游标对象
+     */
+    @Override
+    public void changeCursor(Cursor cursor) {
+        super.changeCursor(cursor); // 调用父类方法
+        calcNotesCount(); // 计算笔记数量
+    }
+
+    /**
+     * 计算笔记数量。
+     */
+    private void calcNotesCount() {
+        mNotesCount = 0; // 重置笔记数量
+        for (int i = 0; i < getCount(); i++) { // 遍历所有项
+            Cursor c = (Cursor) getItem(i); // 获取Cursor对象
+            if (c != null) {
+                if (NoteItemData.getNoteType(c) == Notes.TYPE_NOTE) { // 如果是普通笔记
+                    mNotesCount++; // 增加计数
+                }
+            } else {
+                Log.e(TAG, "Invalid cursor"); // 记录错误日志
+                return;
+            }
+        }
+    }
+}

src/Notesmaster/app/src/main/java/net/micode/notes/ui/NotesListItem.java

@@ -5,7 +5,7 @@
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
- *        http://www.apache.org/licenses/LICENSE-2.0
+ *     http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -16,6 +16,7 @@
 
 package net.micode.notes.ui;
 
+// 导入必要的Android类
 import android.content.Context;
 import android.text.format.DateUtils;
 import android.view.View;
@@ -24,23 +25,35 @@ import android.widget.ImageView;
 import android.widget.LinearLayout;
 import android.widget.TextView;
 
+// 导入自定义的类和资源
 import net.micode.notes.R;
 import net.micode.notes.data.Notes;
 import net.micode.notes.tool.DataUtils;
 import net.micode.notes.tool.ResourceParser.NoteItemBgResources;
 
-
+/**
+ * NotesListItem类继承自LinearLayout，用于在笔记列表中显示单个笔记项。
+ * 每个笔记项包括标题、时间、图标等，并根据不同的状态展示不同的背景和图标。
+ */
 public class NotesListItem extends LinearLayout {
-    private ImageView mAlert;
+    // UI组件
-    private TextView mTitle;
+    private ImageView mAlert;        // 提示图标（如时钟图标）
-    private TextView mTime;
+    private TextView mTitle;         // 笔记标题
-    private TextView mCallName;
+    private TextView mTime;          // 笔记修改时间
-    private NoteItemData mItemData;
+    private TextView mCallName;      // 通话记录名称
-    private CheckBox mCheckBox;
+    private NoteItemData mItemData;  // 笔记项数据
+    private CheckBox mCheckBox;      // 多选模式下的复选框
 
+    /**
+     * 构造函数，初始化NotesListItem。
+     *
+     * @param context 上下文对象
+     */
     public NotesListItem(Context context) {
         super(context);
+        // 加载布局文件note_item.xml并将其作为子视图添加到当前LinearLayout中
         inflate(context, R.layout.note_item, this);
+        // 初始化UI组件
         mAlert = (ImageView) findViewById(R.id.iv_alert_icon);
         mTitle = (TextView) findViewById(R.id.tv_title);
         mTime = (TextView) findViewById(R.id.tv_time);
@@ -48,44 +61,71 @@ public class NotesListItem extends LinearLayout {
         mCheckBox = (CheckBox) findViewById(android.R.id.checkbox);
     }
 
+    /**
+     * 绑定数据到当前笔记项视图。
+     *
+     * @param context     上下文对象
+     * @param data        笔记项数据
+     * @param choiceMode  是否处于多选模式
+     * @param checked     是否被选中
+     */
     public void bind(Context context, NoteItemData data, boolean choiceMode, boolean checked) {
+        // 如果处于多选模式且笔记类型为普通笔记，则显示复选框并设置选中状态
         if (choiceMode && data.getType() == Notes.TYPE_NOTE) {
             mCheckBox.setVisibility(View.VISIBLE);
             mCheckBox.setChecked(checked);
         } else {
+            // 否则隐藏复选框
             mCheckBox.setVisibility(View.GONE);
         }
 
+        // 绑定数据到成员变量
         mItemData = data;
+
+        // 如果笔记ID为通话记录文件夹的ID，则显示通话记录文件夹视图
         if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {
             mCallName.setVisibility(View.GONE);
             mAlert.setVisibility(View.VISIBLE);
+            // 设置标题样式和文本为通话记录文件夹名称及文件数量
             mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
             mTitle.setText(context.getString(R.string.call_record_folder_name)
                     + context.getString(R.string.format_folder_files_count, data.getNotesCount()));
+            // 设置提示图标为通话记录图标
             mAlert.setImageResource(R.drawable.call_record);
-        } else if (data.getParentId() == Notes.ID_CALL_RECORD_FOLDER) {
+        }
+        // 如果笔记的父ID为通话记录文件夹的ID，则显示通话记录子项视图
+        else if (data.getParentId() == Notes.ID_CALL_RECORD_FOLDER) {
             mCallName.setVisibility(View.VISIBLE);
+            // 设置通话记录名称
             mCallName.setText(data.getCallName());
+            // 设置标题样式和文本为笔记片段
             mTitle.setTextAppearance(context,R.style.TextAppearanceSecondaryItem);
             mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));
+            // 如果笔记有提醒，则显示时钟图标
             if (data.hasAlert()) {
                 mAlert.setImageResource(R.drawable.clock);
                 mAlert.setVisibility(View.VISIBLE);
             } else {
                 mAlert.setVisibility(View.GONE);
             }
-        } else {
+        }
+        // 其他类型的笔记
+        else {
             mCallName.setVisibility(View.GONE);
+            // 设置标题样式
             mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
 
+            // 如果笔记类型为文件夹，则显示文件夹名称及文件数量
             if (data.getType() == Notes.TYPE_FOLDER) {
                 mTitle.setText(data.getSnippet()
                         + context.getString(R.string.format_folder_files_count,
-                                data.getNotesCount()));
+                        data.getNotesCount()));
                 mAlert.setVisibility(View.GONE);
-            } else {
+            }
+            // 如果是普通笔记，则显示笔记片段
+            else {
                 mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));
+                // 如果笔记有提醒，则显示时钟图标
                 if (data.hasAlert()) {
                     mAlert.setImageResource(R.drawable.clock);
                     mAlert.setVisibility(View.VISIBLE);
@@ -94,14 +134,24 @@ public class NotesListItem extends LinearLayout {
                 }
             }
         }
+        // 设置笔记的修改时间
         mTime.setText(DateUtils.getRelativeTimeSpanString(data.getModifiedDate()));
 
+        // 设置背景
         setBackground(data);
     }
 
+    /**
+     * 设置笔记项的背景。
+     *
+     * @param data 笔记项数据
+     */
     private void setBackground(NoteItemData data) {
+        // 获取背景颜色ID
         int id = data.getBgColorId();
+        // 如果笔记类型为普通笔记
         if (data.getType() == Notes.TYPE_NOTE) {
+            // 根据笔记的位置设置不同的背景资源
             if (data.isSingle() || data.isOneFollowingFolder()) {
                 setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id));
             } else if (data.isLast()) {
@@ -111,12 +161,19 @@ public class NotesListItem extends LinearLayout {
             } else {
                 setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(id));
             }
-        } else {
+        }
+        // 如果笔记类型为文件夹，则设置文件夹背景
+        else {
             setBackgroundResource(NoteItemBgResources.getFolderBgRes());
         }
     }
 
+    /**
+     * 获取当前笔记项的数据。
+     *
+     * @return 笔记项数据
+     */
     public NoteItemData getItemData() {
         return mItemData;
     }
-}
+}