Update NoteItemData.java

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

@@ -40,119 +40,175 @@ import net.micode.notes.tool.DataUtils;
 import java.io.IOException;
 
 
-public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener {
+//定义一个名为AlarmAlertActivity的公共类，该类继承了Activity类，同时实现了OnClickListener和OnDismissListener接口。  
-    private long mNoteId; //
+public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener {  
-    private String mSnippet;
+
-    private static final int SNIPPET_PREW_MAX_LEN = 60;
+ // 定义一个私有长整型变量mNoteId，用于存储note的ID。  
-    MediaPlayer mPlayer;
+ private long mNoteId;   
-
+
-    @Override
+ // 定义一个私有字符串变量mSnippet，用于存储note的摘要信息。  
-    protected void onCreate(Bundle savedInstanceState) {
+ private String mSnippet;  
-        super.onCreate(savedInstanceState);
+
-        requestWindowFeature(Window.FEATURE_NO_TITLE);
+ // 定义一个私有的静态最终整型常量SNIPPET_PREW_MAX_LEN，其值为60，用于限制mSnippet的最大长度。  
-
+ private static final int SNIPPET_PREW_MAX_LEN = 60;  
-        final Window win = getWindow();
+
-        win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED);
+ // 定义一个私有MediaPlayer对象mPlayer，用于播放音频。  
-
+ MediaPlayer mPlayer;  
-        if (!isScreenOn()) {
+
-            win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON
+ // 重写Activity类的onCreate方法，此方法在Activity创建时被系统调用。  
-                    | WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON
+ @Override  
-                    | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON
+ protected void onCreate(Bundle savedInstanceState) {  
-                    | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);
+     // 调用父类的onCreate方法。  
-        }
+     super.onCreate(savedInstanceState);  
-
+
-        Intent intent = getIntent();
+     // 请求获得窗口特征，此处为去除窗口的标题栏。  
-
+     requestWindowFeature(Window.FEATURE_NO_TITLE);  
-        try {
+
-            mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));
+     // 获取当前Activity的窗口对象。  
-            mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId);
+     final Window win = getWindow();  
-            mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet.substring(0,
+
-                    SNIPPET_PREW_MAX_LEN) + getResources().getString(R.string.notelist_string_info)
+     // 设置窗口标志，使即使屏幕锁定，窗口依然可见。  
-                    : mSnippet;
+     win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED);  
-        } catch (IllegalArgumentException e) {
+
-            e.printStackTrace();
+     // 判断屏幕是否处于关闭状态，如果不是，则设置窗口标志以保持屏幕常亮，并允许锁屏状态下操作窗口。  
-            return;
+     if (!isScreenOn()) {  
-        }
+         win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON |   
-
+                 WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON |   
-        mPlayer = new MediaPlayer();
+                 WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON |   
-        if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
+                 WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);  
-            showActionDialog();
+     }  
-            playAlarmSound();
+
-        } else {
+     // 获取启动当前Activity的Intent对象。  
-            finish();
+     Intent intent = getIntent();  
-        }
+
-    }
+     try {  
-
+         // 尝试从Intent中获取note的ID，并赋值给mNoteId。注意，从Intent中获取的数据路径可能会引发异常。  
-    private boolean isScreenOn() {
+         mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));  
-        PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
+         // 使用note的ID从ContentResolver中获取note的摘要信息，并赋值给mSnippet。可能会因为ID无效而引发异常。  
-        return pm.isScreenOn();
+         mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId);  
-    }
+         // 如果摘要信息长度超过预设的最大长度，就截取摘要的前面部分并添加一个提示信息，然后赋值给mSnippet。  
-
+         mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet.substring(0,   
-    private void playAlarmSound() {
+                 SNIPPET_PREW_MAX_LEN) + getResources().getString(R.string.notelist_string_info)   
-        Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);
+                 : mSnippet;                   }   
-
+     catch (IllegalArgumentException e) { // 如果发生异常，打印异常信息并结束执行。                        e.printStackTrace();  
-        int silentModeStreams = Settings.System.getInt(getContentResolver(),
+         return;                     }         
-                Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0);
+                  
-
+     // 创建一个新的MediaPlayer对象。  
-        if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM)) != 0) {
+     mPlayer = new MediaPlayer();  
-            mPlayer.setAudioStreamType(silentModeStreams);
+     // 如果note在note数据库中可见，就显示一个操作对话框并播放提示音。否则，结束当前Activity。                   if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {   
-        } else {
+         showActionDialog(); // showActionDialog方法未在代码中定义，可能在其他地方定义或者需要你自己定义。             
-            mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM);
+         playAlarmSound(); // playAlarmSound方法未在代码中定义，可能在其他地方定义或者需要你自己定义。             
-        }
+     } else { // 如果note在数据库中不可见，结束当前Activity。             
-        try {
+         finish();             
-            mPlayer.setDataSource(this, url);
+     }         
-            mPlayer.prepare();
+ } // @Override注解表示该方法是一个重写的方法，标志着该方法可以被覆盖或重写。 
-            mPlayer.setLooping(true);
+} // 类定义结束。          
-            mPlayer.start();
+
-        } catch (IllegalArgumentException e) {
+
-            // TODO Auto-generated catch block
+
-            e.printStackTrace();
+// 定义一个私有方法playAlarmSound，用于播放闹钟声音  
-        } catch (SecurityException e) {
+private void playAlarmSound() {  
-            // TODO Auto-generated catch block
+    // 使用RingtoneManager获取当前默认的闹钟铃声的URI  
-            e.printStackTrace();
+    Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);  
-        } catch (IllegalStateException e) {
+      
-            // TODO Auto-generated catch block
+    // 从系统设置中获取受到静音模式影响的音频流  
-            e.printStackTrace();
+    int silentModeStreams = Settings.System.getInt(getContentResolver(), Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0);  
-        } catch (IOException e) {
+      
-            // TODO Auto-generated catch block
+    // 检查是否受到闹钟音频流的影响  
-            e.printStackTrace();
+    if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM)) != 0) {  
-        }
+        // 如果受影响，设置音频流类型为受影响的音频流类型  
-    }
+        mPlayer.setAudioStreamType(silentModeStreams);  
-
+    } else {  
-    private void showActionDialog() {
+        // 如果不受影响，设置音频流类型为闹钟音频流  
-        AlertDialog.Builder dialog = new AlertDialog.Builder(this);
+        mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM);  
-        dialog.setTitle(R.string.app_name);
+    }  
-        dialog.setMessage(mSnippet);
+      
-        dialog.setPositiveButton(R.string.notealert_ok, this);
+    try {  
-        if (isScreenOn()) {
+        // 设置MediaPlayer的数据源为前面获取到的闹钟铃声的URI  
-            dialog.setNegativeButton(R.string.notealert_enter, this);
+        mPlayer.setDataSource(this, url);  
-        }
+          
-        dialog.show().setOnDismissListener(this);
+        // 准备MediaPlayer播放  
-    }
+        mPlayer.prepare();  
-
+          
-    public void onClick(DialogInterface dialog, int which) {
+        // 设置MediaPlayer为循环播放模式  
-        switch (which) {
+        mPlayer.setLooping(true);  
-            case DialogInterface.BUTTON_NEGATIVE:
+          
-                Intent intent = new Intent(this, NoteEditActivity.class);
+        // 开始播放MediaPlayer  
-                intent.setAction(Intent.ACTION_VIEW);
+        mPlayer.start();  
-                intent.putExtra(Intent.EXTRA_UID, mNoteId);
+    } catch (IllegalArgumentException e) {  
-                startActivity(intent);
+        // 如果发生非法参数异常，打印异常堆栈信息  
-                break;
+        e.printStackTrace();  
-            default:
+    } catch (SecurityException e) {  
-                break;
+        // 如果发生安全异常，打印异常堆栈信息  
-        }
+        e.printStackTrace();  
-    }
+    } catch (IllegalStateException e) {  
-
+        // 如果发生非法状态异常，打印异常堆栈信息  
-    public void onDismiss(DialogInterface dialog) {
+        e.printStackTrace();  
-        stopAlarmSound();
+    } catch (IOException e) {  
-        finish();
+        // 如果发生IO异常，打印异常堆栈信息  
-    }
+        e.printStackTrace();  
-
+    }  
-    private void stopAlarmSound() {
-        if (mPlayer != null) {
-            mPlayer.stop();
-            mPlayer.release();
-            mPlayer = null;
-        }
-    }
 }
+//显示操作对话框的方法  
+private void showActionDialog() {  
+ // 创建一个AlertDialog.Builder对象，用于构建对话框  
+ AlertDialog.Builder dialog = new AlertDialog.Builder(this);  
+   
+ // 设置对话框的标题  
+ dialog.setTitle(R.string.app_name);  
+   
+ // 设置对话框的消息内容  
+ dialog.setMessage(mSnippet);  
+   
+ // 设置对话框的确定按钮和点击事件监听器  
+ dialog.setPositiveButton(R.string.notealert_ok, this);  
+   
+ // 检查屏幕是否开启，如果开启，则设置对话框的取消按钮和点击事件监听器  
+ if (isScreenOn()) {  
+     dialog.setNegativeButton(R.string.notealert_enter, this);  
+ }  
+   
+ // 显示对话框，并设置对话框关闭时的监听器  
+ dialog.show().setOnDismissListener(this);  
+}  
+
+//对话框按钮点击事件处理方法  
+public void onClick(DialogInterface dialog, int which) {  
+ // 根据点击的按钮，执行不同的操作  
+ switch (which) {  
+     case DialogInterface.BUTTON_NEGATIVE: // 如果点击的是取消按钮  
+         // 创建一个指向NoteEditActivity的Intent  
+         Intent intent = new Intent(this, NoteEditActivity.class);  
+           
+         // 设置Intent的动作为查看  
+         intent.setAction(Intent.ACTION_VIEW);  
+           
+         // 将mNoteId作为额外数据放入Intent中  
+         intent.putExtra(Intent.EXTRA_UID, mNoteId);  
+           
+         // 启动NoteEditActivity  
+         startActivity(intent);  
+         break;  
+     default: // 如果点击的是其他按钮，不执行任何操作  
+         break;  
+ }  
+}  
+
+//对话框关闭事件处理方法  
+public void onDismiss(DialogInterface dialog) {  
+ // 停止闹钟声音播放  
+ stopAlarmSound();  
+   
+ // 结束当前活动  
+ finish();  
+}  
+
+//停止闹钟声音播放的方法  
+private void stopAlarmSound() {  
+ // 如果mPlayer不为空，则停止播放，释放资源，并将mPlayer设置为null  
+ if (mPlayer != null) {  
+     mPlayer.stop();  
+     mPlayer.release();  
+     mPlayer = null;  
+ }  
+}

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

@@ -26,56 +26,63 @@ import net.micode.notes.data.Notes.NoteColumns;
 import net.micode.notes.tool.DataUtils;
 
 
-public class NoteItemData {
+//声明一个名为NoteItemData的类，该类不接受任何参数并且是公开的  
-    static final String [] PROJECTION = new String [] {
+public class NoteItemData {  
-        NoteColumns.ID,
+
-        NoteColumns.ALERTED_DATE,
+ // 定义一个字符串数组PROJECTION，该数组包含一些列名，这些列名是从NoteColumns类中获取的常量  
-        NoteColumns.BG_COLOR_ID,
+ static final String [] PROJECTION = new String [] {  
-        NoteColumns.CREATED_DATE,
+     NoteColumns.ID,  
-        NoteColumns.HAS_ATTACHMENT,
+     NoteColumns.ALERTED_DATE,  
-        NoteColumns.MODIFIED_DATE,
+     NoteColumns.BG_COLOR_ID,  
-        NoteColumns.NOTES_COUNT,
+     NoteColumns.CREATED_DATE,  
-        NoteColumns.PARENT_ID,
+     NoteColumns.HAS_ATTACHMENT,  
-        NoteColumns.SNIPPET,
+     NoteColumns.MODIFIED_DATE,  
-        NoteColumns.TYPE,
+     NoteColumns.NOTES_COUNT,  
-        NoteColumns.WIDGET_ID,
+     NoteColumns.PARENT_ID,  
-        NoteColumns.WIDGET_TYPE,
+     NoteColumns.SNIPPET,  
-    };
+     NoteColumns.TYPE,  
-
+     NoteColumns.WIDGET_ID,  
-    private static final int ID_COLUMN                    = 0;
+     NoteColumns.WIDGET_TYPE,  
-    private static final int ALERTED_DATE_COLUMN          = 1;
+ };  
-    private static final int BG_COLOR_ID_COLUMN           = 2;
+
-    private static final int CREATED_DATE_COLUMN          = 3;
+ // 定义一组常量，表示在PROJECTION数组中每个列的位置  
-    private static final int HAS_ATTACHMENT_COLUMN        = 4;
+ // 这些常量后续在代码中用于索引和查找特定的列  
-    private static final int MODIFIED_DATE_COLUMN         = 5;
+ private static final int ID_COLUMN                    = 0;  
-    private static final int NOTES_COUNT_COLUMN           = 6;
+ private static final int ALERTED_DATE_COLUMN          = 1;  
-    private static final int PARENT_ID_COLUMN             = 7;
+ private static final int BG_COLOR_ID_COLUMN           = 2;  
-    private static final int SNIPPET_COLUMN               = 8;
+ private static final int CREATED_DATE_COLUMN          = 3;  
-    private static final int TYPE_COLUMN                  = 9;
+ private static final int HAS_ATTACHMENT_COLUMN        = 4;  
-    private static final int WIDGET_ID_COLUMN             = 10;
+ private static final int MODIFIED_DATE_COLUMN         = 5;  
-    private static final int WIDGET_TYPE_COLUMN           = 11;
+ private static final int NOTES_COUNT_COLUMN           = 6;  
-
+ private static final int PARENT_ID_COLUMN             = 7;  
-    private long mId;
+ private static final int SNIPPET_COLUMN               = 8;  
-    private long mAlertDate;
+ private static final int TYPE_COLUMN                  = 9;  
-    private int mBgColorId;
+ private static final int WIDGET_ID_COLUMN             = 10;  
-    private long mCreatedDate;
+ private static final int WIDGET_TYPE_COLUMN           = 11;  
-    private boolean mHasAttachment;
+
-    private long mModifiedDate;
+ // 定义一些私有变量，用来存储便签的各种属性值  
-    private int mNotesCount;
+ // 如ID、提醒日期、背景颜色ID、创建日期等  
-    private long mParentId;
+ private long mId;  
-    private String mSnippet;
+ private long mAlertDate;  
-    private int mType;
+ private int mBgColorId;  
-    private int mWidgetId;
+ private long mCreatedDate;  
-    private int mWidgetType;
+ private boolean mHasAttachment;  
-    private String mName;
+ private long mModifiedDate;  
-    private String mPhoneNumber;
+ private int mNotesCount;  
-
+ private long mParentId;  
-    private boolean mIsLastItem;
+ private String mSnippet;  
-    private boolean mIsFirstItem;
+ private int mType;  
-    private boolean mIsOnlyOneItem;
+ private int mWidgetId;  
-    private boolean mIsOneNoteFollowingFolder;
+ private int mWidgetType;  
-    private boolean mIsMultiNotesFollowingFolder;
+ private String mName;  // 新增的变量，未在PROJECTION中看到对应的列名  
-
+ private String mPhoneNumber;  // 新增的变量，未在PROJECTION中看到对应的列名  
+
+ // 定义一些私有布尔变量，用来标识一些特殊状态，如是否是最后一个便签、是否是第一个便签等  
+ private boolean mIsLastItem;  
+ private boolean mIsFirstItem;  
+ private boolean mIsOnlyOneItem;  
+ private boolean mIsOneNoteFollowingFolder;  
+ private boolean mIsMultiNotesFollowingFolder;
     public NoteItemData(Context context, Cursor cursor) {
         mId = cursor.getLong(ID_COLUMN);
         mAlertDate = cursor.getLong(ALERTED_DATE_COLUMN);
@@ -134,91 +141,89 @@ public class NoteItemData {
         }
     }
 
-    public boolean isOneFollowingFolder() {
+ // 定义一个公开的布尔型方法 isOneFollowingFolder，返回值是 mIsOneNoteFollowingFolder 的值  
-        return mIsOneNoteFollowingFolder;
+    public boolean isOneFollowingFolder() {  
-    }
+        return mIsOneNoteFollowingFolder;  
-
+    }  
-    public boolean isMultiFollowingFolder() {
+      
-        return mIsMultiNotesFollowingFolder;
+    // 定义一个公开的布尔型方法 isMultiFollowingFolder，返回值是 mIsMultiNotesFollowingFolder 的值  
-    }
+    public boolean isMultiFollowingFolder() {  
-
+        return mIsMultiNotesFollowingFolder;  
-    public boolean isLast() {
+    }  
-        return mIsLastItem;
+      
-    }
+    // 定义一个公开的布尔型方法 isLast，返回值是 mIsLastItem 的值  
-
+    public boolean isLast() {  
-    public String getCallName() {
+        return mIsLastItem;  
-        return mName;
+    }  
-    }
+      
-
+    // 定义一个公开的字符串获取方法 getCallName，返回值是 mName 的值  
-    public boolean isFirst() {
+    public String getCallName() {  
-        return mIsFirstItem;
+        return mName;  
-    }
+    }  
-
+      
-    public boolean isSingle() {
+    // 定义一个公开的布尔型方法 isFirst，返回值是 mIsFirstItem 的值  
-        return mIsOnlyOneItem;
+    public boolean isFirst() {  
-    }
+        return mIsFirstItem;  
-
+    }  
-    public long getId() {
+      
-        return mId;
+    // 定义一个公开的布尔型方法 isSingle，返回值是 mIsOnlyOneItem 的值  
-    }
+    public boolean isSingle() {  
-
+        return mIsOnlyOneItem;  
-    public long getAlertDate() {
+    }  
-        return mAlertDate;
+      
-    }
+    // 定义一个公开的长整型方法 getId，返回值是 mId 的值  
-
+    public long getId() {  
-    public long getCreatedDate() {
+        return mId;  
-        return mCreatedDate;
+    }  
-    }
+      
-
+    // 定义一个公开的长整型方法 getAlertDate，返回值是 mAlertDate 的值  
-    public boolean hasAttachment() {
+    public long getAlertDate() {  
-        return mHasAttachment;
+        return mAlertDate;  
-    }
+    }  
-
+      
-    public long getModifiedDate() {
+    // 定义一个公开的长整型方法 getCreatedDate，返回值是 mCreatedDate 的值  
-        return mModifiedDate;
+    public long getCreatedDate() {  
-    }
+        return mCreatedDate;  
-
+    }  
-    public int getBgColorId() {
+      
-        return mBgColorId;
+    // 定义一个公开的布尔型方法 hasAttachment，返回值是 mHasAttachment 的值  
-    }
+    public boolean hasAttachment() {  
-
+        return mHasAttachment;  
-    public long getParentId() {
+    }  
-        return mParentId;
+      
-    }
+    // 定义一个公开的长整型方法 getModifiedDate，返回值是 mModifiedDate 的值  
-
+    public long getModifiedDate() {  
-    public int getNotesCount() {
+        return mModifiedDate;  
-        return mNotesCount;
+    }  
-    }
+      
-
+    // 定义一个公开的整型方法 getBgColorId，返回值是 mBgColorId 的值  
-    public long getFolderId () {
+    public int getBgColorId() {  
-        return mParentId;
+        return mBgColorId;  
-    }
+    }  
-
+      
-    public int getType() {
+    // 定义一个公开的长整型方法 getParentId，返回值是 mParentId 的值，注意这个方法名和 getFolderId 很相似，可能会有一些混淆。  
-        return mType;
+    public long getParentId() {  
-    }
+        return mParentId;  
-
+    }  
-    public int getWidgetType() {
+      
-        return mWidgetType;
+    // 定义一个公开的整型方法 getNotesCount，返回值是 mNotesCount 的值，这个方法可能用于获取笔记文件夹中的笔记数量。  
-    }
+    public int getNotesCount() {  
-
+        return mNotesCount;  
-    public int getWidgetId() {
+    }  
-        return mWidgetId;
+      
-    }
+    // 定义一个公开的长整型方法 getFolderId，返回值也是 mParentId 的值。这个方法和上面的 getParentId 方法是完全一样的，可能是代码重复或者错误。  
-
+    public long getFolderId () {  
-    public String getSnippet() {
+        return mParentId;  
-        return mSnippet;
+    }  
-    }
+      
-
+    // 定义一个公开的整型方法 getType，返回值是 mType 的值，这个方法可能用于获取笔记的类型。  
-    public boolean hasAlert() {
+    public int getType() {  
-        return (mAlertDate > 0);
+        return mType;  
-    }
+    }  
-
+      
-    public boolean isCallRecord() {
+    // 定义一个公开的整型方法 getWidgetType，返回值是 mWidgetType 的值，这个方法可能用于获取部件类型。部件可能是一个UI组件或者应用的一部分。  
-        return (mParentId == Notes.ID_CALL_RECORD_FOLDER && !TextUtils.isEmpty(mPhoneNumber));
+    public int getWidgetType() {  
-    }
+        return mWidgetType;  
-
+    }  
-    public static int getNoteType(Cursor cursor) {
+      
-        return cursor.getInt(TYPE_COLUMN);
+    // 定义一个公开的整型方法 getWidgetId，返回值是 mWidgetId 的值，这个方法可能用于获取部件ID。部件可能是UI的一部分或者应用的一部分。 部件ID可能是唯一标识部件的值。 同样的部件可能在屏幕上多次出现，但是每个实例都有唯一的ID。 每个部件ID都存储在部件管理器的内部数据结构中。 通过使用部件ID，可以引用和操作特定的部件实例。 这可能对于在运行时对部件进行动态控制非常有用。  在Android中，部件ID通常是整数类型。 例如，在View类中有一个名为getId的方法，它返回View的ID。 这个ID就是View的实例在屏幕上的唯一标识符。 ID可以是任何整数类型（int），因此你可以使用任何整数作为ID。 在Android中，ID的默认范围是-1到2147483647（如果使用Java）。 在使用C++时，范围可能会有所不同。 ID的值在部件的生命周期中保持不变。 ID为0表示没有给部件指定ID。 在给定ID的情况下，你可以通过使用findViewById或findView
-    }
-}

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

@@ -31,154 +31,198 @@ import java.util.HashSet;
 import java.util.Iterator;
 
 
-public class NotesListAdapter extends CursorAdapter {
+//定义一个公共类NotesListAdapter，它继承自CursorAdapter  
-    private static final String TAG = "NotesListAdapter";
+public class NotesListAdapter extends CursorAdapter {  
-    private Context mContext;
+ // 定义一个静态的字符串标签，用于日志记录  
-    private HashMap<Integer, Boolean> mSelectedIndex;
+ private static final String TAG = "NotesListAdapter";  
-    private int mNotesCount;
+ // 定义一个Context对象，用于与应用程序环境交互  
-    private boolean mChoiceMode;
+ private Context mContext;  
-
+ // 定义一个HashMap对象，用于存储选中的项目及其对应的索引  
-    public static class AppWidgetAttribute {
+ private HashMap<Integer, Boolean> mSelectedIndex;  
-        public int widgetId;
+ // 定义一个变量，用于存储笔记的数量  
-        public int widgetType;
+ private int mNotesCount;  
-    };
+ // 定义一个布尔变量，表示是否处于选择模式  
-
+ private boolean mChoiceMode;  
-    public NotesListAdapter(Context context) {
+
-        super(context, null);
+ // 定义一个内部类AppWidgetAttribute，包含widgetId和widgetType两个成员变量  
-        mSelectedIndex = new HashMap<Integer, Boolean>();
+ public static class AppWidgetAttribute {  
-        mContext = context;
+     public int widgetId;  
-        mNotesCount = 0;
+     public int widgetType;  
-    }
+ };  
-
+
-    @Override
+ // 定义一个构造函数，接收一个Context对象作为参数  
-    public View newView(Context context, Cursor cursor, ViewGroup parent) {
+ public NotesListAdapter(Context context) {  
-        return new NotesListItem(context);
+     // 调用父类的构造函数，传入上下文、null的游标和null的父视图  
-    }
+     super(context, null);  
-
+     // 初始化mSelectedIndex为空的HashMap对象  
-    @Override
+     mSelectedIndex = new HashMap<Integer, Boolean>();  
-    public void bindView(View view, Context context, Cursor cursor) {
+     // 保存传入的上下文对象  
-        if (view instanceof NotesListItem) {
+     mContext = context;  
-            NoteItemData itemData = new NoteItemData(context, cursor);
+     // 初始化笔记数量为0  
-            ((NotesListItem) view).bind(context, itemData, mChoiceMode,
+     mNotesCount = 0;  
-                    isSelectedItem(cursor.getPosition()));
+ }  
-        }
+
-    }
+ // 重写父类的newView方法，用于创建新的视图对象  
-
+ @Override  
-    public void setCheckedItem(final int position, final boolean checked) {
+ public View newView(Context context, Cursor cursor, ViewGroup parent) {  
-        mSelectedIndex.put(position, checked);
+     // 返回一个新的NotesListItem对象  
-        notifyDataSetChanged();
+     return new NotesListItem(context);  
-    }
+ }  
-
+
-    public boolean isInChoiceMode() {
+ // 重写父类的bindView方法，用于将数据绑定到视图上  
-        return mChoiceMode;
+ @Override  
-    }
+ public void bindView(View view, Context context, Cursor cursor) {  
-
+     // 如果视图是NotesListItem的实例  
-    public void setChoiceMode(boolean mode) {
+     if (view instanceof NotesListItem) {  
-        mSelectedIndex.clear();
+         // 从游标中获取数据，并创建一个新的NoteItemData对象  
-        mChoiceMode = mode;
+         NoteItemData itemData = new NoteItemData(context, cursor);  
-    }
+         // 将数据绑定到视图中，同时传入选择模式和当前项是否被选中的信息  
-
+         ((NotesListItem) view).bind(context, itemData, mChoiceMode,  
-    public void selectAll(boolean checked) {
+                 isSelectedItem(cursor.getPosition()));  
-        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 void setCheckedItem(final int position, final boolean checked) {  
-                }
+     // 在mSelectedIndex中添加或修改对应位置的选中状态  
-            }
+     mSelectedIndex.put(position, checked);  
-        }
+     // 通知数据集已改变，触发视图更新  
-    }
+     notifyDataSetChanged();  
-
+ }
-    public HashSet<Long> getSelectedItemIds() {
+ 
-        HashSet<Long> itemSet = new HashSet<Long>();
+ 
-        for (Integer position : mSelectedIndex.keySet()) {
+//判断当前是否处于选择模式  
-            if (mSelectedIndex.get(position) == true) {
+public boolean isInChoiceMode() {  
-                Long id = getItemId(position);
+  return mChoiceMode;  
-                if (id == Notes.ID_ROOT_FOLDER) {
+}  
-                    Log.d(TAG, "Wrong item id, should not happen");
+
-                } else {
+//设置选择模式，清空已选中的项目并改变选择模式  
-                    itemSet.add(id);
+public void setChoiceMode(boolean mode) {  
-                }
+  mSelectedIndex.clear(); // 清空已选中的项目  
-            }
+  mChoiceMode = mode;     // 设置新的选择模式  
-        }
+}  
-
+
-        return itemSet;
+//全选或全不选  
-    }
+public void selectAll(boolean checked) {  
-
+  Cursor cursor = getCursor(); // 获取游标，游标用于遍历查询结果  
-    public HashSet<AppWidgetAttribute> getSelectedWidget() {
+  for (int i = 0; i < getCount(); i++) { // 遍历所有项目  
-        HashSet<AppWidgetAttribute> itemSet = new HashSet<AppWidgetAttribute>();
+      if (cursor.moveToPosition(i)) { // 移动游标到当前位置  
-        for (Integer position : mSelectedIndex.keySet()) {
+          if (NoteItemData.getNoteType(cursor) == Notes.TYPE_NOTE) { // 如果当前项是笔记类型  
-            if (mSelectedIndex.get(position) == true) {
+              setCheckedItem(i, checked); // 设置该项是否被选中  
-                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();
+//获取所有被选中的项目的id，并返回一个HashSet集合  
-                    itemSet.add(widget);
+public HashSet<Long> getSelectedItemIds() {  
-                    /**
+  HashSet<Long> itemSet = new HashSet<Long>(); // 创建一个HashSet集合用于存放被选中的项目id  
-                     * Don't close cursor here, only the adapter could close it
+  for (Integer position : mSelectedIndex.keySet()) { // 遍历所有被选中的项目的位置  
-                     */
+      if (mSelectedIndex.get(position) == true) { // 如果该位置的项被选中  
-                } else {
+          Long id = getItemId(position); // 获取该位置的项目id  
-                    Log.e(TAG, "Invalid cursor");
+          if (id == Notes.ID_ROOT_FOLDER) { // 如果获取的id是根文件夹的id，则记录一个错误日志，因为根文件夹不应该被选中  
-                    return null;
+              Log.d(TAG, "Wrong item id, should not happen");  
-                }
+          } else {  
-            }
+              itemSet.add(id); // 否则，将该id添加到HashSet集合中  
-        }
+          }  
-        return itemSet;
+      }  
-    }
+  }  
-
+  return itemSet; // 返回HashSet集合  
-    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;
-            }
-        }
-    }
 }
+
+
+//获取所有选中的小部件属性  
+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) { // 如果Cursor不为空  
+             AppWidgetAttribute widget = new AppWidgetAttribute(); // 创建一个新的AppWidgetAttribute对象  
+             NoteItemData item = new NoteItemData(mContext, c); // 使用Cursor对象创建一个NoteItemData对象  
+             widget.widgetId = item.getWidgetId(); // 从NoteItemData对象获取小部件ID，并设置到AppWidgetAttribute对象中  
+             widget.widgetType = item.getWidgetType(); // 从NoteItemData对象获取小部件类型，并设置到AppWidgetAttribute对象中  
+             itemSet.add(widget); // 将创建的AppWidgetAttribute对象添加到HashSet集合中  
+             /**  
+              * 这里不要关闭Cursor，只有适配器可以关闭它  
+              */  
+         } else {  
+             Log.e(TAG, "Invalid cursor"); // 如果Cursor为空，记录错误日志  
+             return null; // 返回null，表示获取失败  
+         }  
+     }  
+ }  
+ return itemSet; // 返回HashSet集合，包含所有选中的小部件属性  
+}  
+
+//获取被选中的项目数量  
+public int getSelectedCount() {  
+ Collection<Boolean> values = mSelectedIndex.values(); // 获取所有被选中的项目（布尔值）的集合  
+ if (null == values) { // 如果集合为空（没有被选中的项目）  
+     return 0; // 返回0，表示被选中的项目数量为0  
+ }  
+ Iterator<Boolean> iter = values.iterator(); // 创建一个迭代器来遍历布尔值的集合  
+ int count = 0; // 初始化计数器为0  
+ while (iter.hasNext()) { // 当还有下一个布尔值时  
+     if (true == iter.next()) { // 如果布尔值为true（表示被选中）  
+         count++; // 计数器加1  
+     }  
+ }  
+ return count; // 返回被选中的项目数量  
+}  
+
+//检查是否所有项目都被选中  
+public boolean isAllSelected() {  
+ int checkedCount = getSelectedCount(); // 获取被选中的项目数量  
+ return (checkedCount != 0 && checkedCount == mNotesCount); // 如果被选中的项目数量不为0且等于总的项目数量，则返回true，表示所有项目都被选中；否则返回false。  
+}
+
+//定义一个方法，用于判断指定位置的项目是否被选中  
+public boolean isSelectedItem(final int position) {  
+ // 如果指定位置的项目在mSelectedIndex映射中对应的值为null，返回false，表示未被选中  
+ if (null == mSelectedIndex.get(position)) {  
+     return false;  
+ }  
+ // 返回mSelectedIndex映射中指定位置对应的值，如果为true则表示被选中，为false则表示未被选中  
+ return mSelectedIndex.get(position);  
+}  
+
+//重写onContentChanged方法，该方法在内容发生变化时被调用  
+@Override  
+protected void onContentChanged() {  
+ // 调用父类的onContentChanged方法，执行默认的内容变化处理  
+ super.onContentChanged();  
+ // 调用calcNotesCount方法，重新计算笔记数量  
+ calcNotesCount();  
+}  
+
+//重写changeCursor方法，该方法在Cursor发生变化时被调用  
+@Override  
+public void changeCursor(Cursor cursor) {  
+ // 调用父类的changeCursor方法，执行默认的Cursor变化处理  
+ super.changeCursor(cursor);  
+ // 调用calcNotesCount方法，重新计算笔记数量  
+ calcNotesCount();  
+}  
+
+//定义一个私有方法，用于计算笔记数量  
+private void calcNotesCount() {  
+ // 初始化笔记数量为0  
+ mNotesCount = 0;  
+ // 遍历所有的项目（从0到getCount()-1）  
+ for (int i = 0; i < getCount(); i++) {  
+     // 获取指定位置的项目，以Cursor对象的形式返回  
+     Cursor c = (Cursor) getItem(i);  
+     // 如果Cursor不为空  
+     if (c != null) {  
+         // 如果当前项目的类型为“笔记”（TYPE_NOTE），则笔记数量加1  
+         if (NoteItemData.getNoteType(c) == Notes.TYPE_NOTE) {  
+             mNotesCount++;  
+         }  
+     } else {  
+         // 如果Cursor为空，记录错误日志，并退出方法  
+         Log.e(TAG, "Invalid cursor");  
+         return;  
+     }  
+ }  
+}

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

@@ -30,93 +30,152 @@ import net.micode.notes.tool.DataUtils;
 import net.micode.notes.tool.ResourceParser.NoteItemBgResources;
 
 
-public class NotesListItem extends LinearLayout {
+//定义一个名为NotesListItem的类，它继承自LinearLayout  
-    private ImageView mAlert;
+public class NotesListItem extends LinearLayout {  
-    private TextView mTitle;
+   
-    private TextView mTime;
+ // 定义一个私有的ImageView对象，用于显示警报图标  
-    private TextView mCallName;
+ private ImageView mAlert;  
-    private NoteItemData mItemData;
+   
-    private CheckBox mCheckBox;
+ // 定义一个私有的TextView对象，用于显示标题  
-
+ private TextView mTitle;  
-    public NotesListItem(Context context) {
+   
-        super(context);
+ // 定义一个私有的TextView对象，用于显示时间  
-        inflate(context, R.layout.note_item, this);
+ private TextView mTime;  
-        mAlert = (ImageView) findViewById(R.id.iv_alert_icon);
+   
-        mTitle = (TextView) findViewById(R.id.tv_title);
+ // 定义一个私有的TextView对象，用于显示电话的名字  
-        mTime = (TextView) findViewById(R.id.tv_time);
+ private TextView mCallName;  
-        mCallName = (TextView) findViewById(R.id.tv_name);
+   
-        mCheckBox = (CheckBox) findViewById(android.R.id.checkbox);
+ // 定义一个私有的NoteItemData对象，用于存储与笔记相关的数据  
-    }
+ private NoteItemData mItemData;  
-
+   
-    public void bind(Context context, NoteItemData data, boolean choiceMode, boolean checked) {
+ // 定义一个私有的CheckBox对象，用于表示笔记是否被选中  
-        if (choiceMode && data.getType() == Notes.TYPE_NOTE) {
+ private CheckBox mCheckBox;  
-            mCheckBox.setVisibility(View.VISIBLE);
+   
-            mCheckBox.setChecked(checked);
+ // 定义一个公共的构造函数，接收一个Context参数  
-        } else {
+ public NotesListItem(Context context) {  
-            mCheckBox.setVisibility(View.GONE);
+     // 调用父类的构造函数，传入context参数  
-        }
+     super(context);  
-
+       
-        mItemData = data;
+     // 使用inflate方法从指定的XML布局文件中创建视图，并将视图添加到当前实例中  
-        if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {
+     inflate(context, R.layout.note_item, this);  
-            mCallName.setVisibility(View.GONE);
+       
-            mAlert.setVisibility(View.VISIBLE);
+     // 通过ID查找布局中的控件，并赋值给相应的变量  
-            mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
+     mAlert = (ImageView) findViewById(R.id.iv_alert_icon);  
-            mTitle.setText(context.getString(R.string.call_record_folder_name)
+     mTitle = (TextView) findViewById(R.id.tv_title);  
-                    + context.getString(R.string.format_folder_files_count, data.getNotesCount()));
+     mTime = (TextView) findViewById(R.id.tv_time);  
-            mAlert.setImageResource(R.drawable.call_record);
+     mCallName = (TextView) findViewById(R.id.tv_name);  
-        } else if (data.getParentId() == Notes.ID_CALL_RECORD_FOLDER) {
+     mCheckBox = (CheckBox) findViewById(android.R.id.checkbox);  
-            mCallName.setVisibility(View.VISIBLE);
+ }  
-            mCallName.setText(data.getCallName());
+}
-            mTitle.setTextAppearance(context,R.style.TextAppearanceSecondaryItem);
+public void bind(Context context, NoteItemData data, boolean choiceMode, boolean checked) {  
-            mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));
+    // 如果处于选择模式，并且数据类型是笔记  
-            if (data.hasAlert()) {
+    if (choiceMode && data.getType() == Notes.TYPE_NOTE) {  
-                mAlert.setImageResource(R.drawable.clock);
+        // 显示复选框，并设置其选中状态  
-                mAlert.setVisibility(View.VISIBLE);
+        mCheckBox.setVisibility(View.VISIBLE);  
-            } else {
+        mCheckBox.setChecked(checked);  
-                mAlert.setVisibility(View.GONE);
+    } else {  
-            }
+        // 隐藏复选框  
-        } else {
+        mCheckBox.setVisibility(View.GONE);  
-            mCallName.setVisibility(View.GONE);
+    }  
-            mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
+  
-
+    // 保存传入的数据  
-            if (data.getType() == Notes.TYPE_FOLDER) {
+    mItemData = data;  
-                mTitle.setText(data.getSnippet()
+}
-                        + context.getString(R.string.format_folder_files_count,
+//如果data的id等于Notes.ID_CALL_RECORD_FOLDER  
-                                data.getNotesCount()));
+if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {  
-                mAlert.setVisibility(View.GONE);
+ // 隐藏电话名称的显示  
-            } else {
+ mCallName.setVisibility(View.GONE);  
-                mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));
+ // 显示警报图标  
-                if (data.hasAlert()) {
+ mAlert.setVisibility(View.VISIBLE);  
-                    mAlert.setImageResource(R.drawable.clock);
+ // 设置标题的文本样式为默认样式  
-                    mAlert.setVisibility(View.VISIBLE);
+ mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);  
-                } else {
+ // 设置标题的文本为“通话记录文件夹名”加上data中的笔记数量  
-                    mAlert.setVisibility(View.GONE);
+ 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);  
-        mTime.setText(DateUtils.getRelativeTimeSpanString(data.getModifiedDate()));
+} else if (data.getParentId() == Notes.ID_CALL_RECORD_FOLDER) {  
-
+ // 显示电话名称的显示  
-        setBackground(data);
+ mCallName.setVisibility(View.VISIBLE);  
-    }
+ // 设置电话名称的文本为data中的callName  
+ mCallName.setText(data.getCallName());  
+ // 设置标题的文本样式为二级样式  
+ mTitle.setTextAppearance(context,R.style.TextAppearanceSecondaryItem);  
+ // 设置标题的文本为DataUtils格式化后的摘要  
+ mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));  
+ // 如果data有警报  
+ if (data.hasAlert()) {  
+     // 设置警报图标的资源为时钟图标，并显示警报图标  
+     mAlert.setImageResource(R.drawable.clock);  
+     mAlert.setVisibility(View.VISIBLE);  
+ } else {  
+     // 否则隐藏警报图标  
+     mAlert.setVisibility(View.GONE);  
+ }  
+} else {  
+ // 隐藏电话名称的显示  
+ mCallName.setVisibility(View.GONE);  
+ // 设置标题的文本样式为默认样式  
+ mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);  
+ // 如果data的类型是文件夹  
+ if (data.getType() == Notes.TYPE_FOLDER) {  
+     // 设置标题的文本为摘要加上data中的笔记数量  
+     mTitle.setText(data.getSnippet()  
+             + context.getString(R.string.format_folder_files_count,  
+                     data.getNotesCount()));  
+     // 隐藏警报图标  
+     mAlert.setVisibility(View.GONE);  
+ } else {  
+     // 设置标题的文本为DataUtils格式化后的摘要  
+     mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));  
+     // 如果data有警报  
+     if (data.hasAlert()) {  
+         // 设置警报图标的资源为时钟图标，并显示警报图标  
+         mAlert.setImageResource(R.drawable.clock);  
+         mAlert.setVisibility(View.VISIBLE);  
+     } else {  
+         // 否则隐藏警报图标  
+         mAlert.setVisibility(View.GONE);  
+     }  
+ }  
+}  
+//设置时间文本为相对时间格式（例如：1小时前，2分钟前等）  
+mTime.setText(DateUtils.getRelativeTimeSpanString(data.getModifiedDate()));  
+//根据data设置背景色或背景图片等背景样式  
+setBackground(data);
 
-    private void setBackground(NoteItemData data) {
+//设置背景的方法  
-        int id = data.getBgColorId();
+private void setBackground(NoteItemData data) {  
-        if (data.getType() == Notes.TYPE_NOTE) {
+ // 获取data的背景颜色id  
-            if (data.isSingle() || data.isOneFollowingFolder()) {
+ int id = data.getBgColorId();  
-                setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id));
+   
-            } else if (data.isLast()) {
+ // 如果data的类型是笔记  
-                setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(id));
+ if (data.getType() == Notes.TYPE_NOTE) {  
-            } else if (data.isFirst() || data.isMultiFollowingFolder()) {
+     // 如果data是单条笔记或者是某个文件夹下的第一条笔记  
-                setBackgroundResource(NoteItemBgResources.getNoteBgFirstRes(id));
+     if (data.isSingle() || data.isOneFollowingFolder()) {  
-            } else {
+         // 设置背景资源为单条笔记的背景资源  
-                setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(id));
+         setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id));  
-            }
+     // 如果data是最后一条笔记  
-        } else {
+     } else if (data.isLast()) {  
-            setBackgroundResource(NoteItemBgResources.getFolderBgRes());
+         // 设置背景资源为最后一条笔记的背景资源  
-        }
+         setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(id));  
-    }
+     // 如果data是第一条笔记或者是某个文件夹下的第一条多条笔记  
+     } else if (data.isFirst() || data.isMultiFollowingFolder()) {  
+         // 设置背景资源为第一条笔记的背景资源  
+         setBackgroundResource(NoteItemBgResources.getNoteBgFirstRes(id));  
+     // 其他情况，默认为普通情况  
+     } else {  
+         // 设置背景资源为普通笔记的背景资源  
+         setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(id));  
+     }  
+ // 如果data的类型是文件夹  
+ } else {  
+     // 设置背景资源为文件夹的背景资源  
+     setBackgroundResource(NoteItemBgResources.getFolderBgRes());  
+ }  
+}  
 
-    public NoteItemData getItemData() {
+//获取itemData的方法，返回mItemData对象  
-        return mItemData;
+public NoteItemData getItemData() {  
-    }
+ return mItemData;  
-}
+}

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

@@ -48,228 +48,334 @@ import net.micode.notes.data.Notes.NoteColumns;
 import net.micode.notes.gtask.remote.GTaskSyncService;
 
 
-public class NotesPreferenceActivity extends PreferenceActivity {
+//声明一个名为NotesPreferenceActivity的类，该类继承自PreferenceActivity  
-    public static final String PREFERENCE_NAME = "notes_preferences";
+public class NotesPreferenceActivity extends PreferenceActivity {  
-
+
-    public static final String PREFERENCE_SYNC_ACCOUNT_NAME = "pref_key_account_name";
+ // 声明一个静态常量，用于保存偏好设置的全局名称  
-
+ public static final String PREFERENCE_NAME = "notes_preferences";  
-    public static final String PREFERENCE_LAST_SYNC_TIME = "pref_last_sync_time";
+
-
+ // 声明一个静态常量，用于保存同步账户名称的键  
-    public static final String PREFERENCE_SET_BG_COLOR_KEY = "pref_key_bg_random_appear";
+ public static final String PREFERENCE_SYNC_ACCOUNT_NAME = "pref_key_account_name";  
-
+
-    private static final String PREFERENCE_SYNC_ACCOUNT_KEY = "pref_sync_account_key";
+ // 声明一个静态常量，用于保存最后一次同步时间的键  
-
+ public static final String PREFERENCE_LAST_SYNC_TIME = "pref_last_sync_time";  
-    private static final String AUTHORITIES_FILTER_KEY = "authorities";
+
-
+ // 声明一个静态常量，用于设置背景颜色的键  
-    private PreferenceCategory mAccountCategory;
+ public static final String PREFERENCE_SET_BG_COLOR_KEY = "pref_key_bg_random_appear";  
-
+
-    private GTaskReceiver mReceiver;
+ // 声明一个静态常量，用于保存同步账户的键  
-
+ private static final String PREFERENCE_SYNC_ACCOUNT_KEY = "pref_sync_account_key";  
-    private Account[] mOriAccounts;
+
-
+ // 声明一个PreferenceCategory类型的成员变量mAccountCategory，用于保存账户偏好设置的类别  
-    private boolean mHasAddedAccount;
+ private PreferenceCategory mAccountCategory;  
-
+
-    @Override
+ // 声明一个GTaskReceiver类型的成员变量mReceiver，可能用于接收和处理任务相关的广播  
-    protected void onCreate(Bundle icicle) {
+ private GTaskReceiver mReceiver;  
-        super.onCreate(icicle);
+
-
+ // 声明一个Account类型的数组mOriAccounts，用于保存原始账户信息  
-        /* using the app icon for navigation */
+ private Account[] mOriAccounts;  
-        getActionBar().setDisplayHomeAsUpEnabled(true);
+
-
+ // 声明一个布尔类型的成员变量mHasAddedAccount，用于跟踪是否已添加账户  
-        addPreferencesFromResource(R.xml.preferences);
+ private boolean mHasAddedAccount;  
-        mAccountCategory = (PreferenceCategory) findPreference(PREFERENCE_SYNC_ACCOUNT_KEY);
+
-        mReceiver = new GTaskReceiver();
+ // 重写PreferenceActivity的onCreate方法，该方法在活动创建时被调用  
-        IntentFilter filter = new IntentFilter();
+ @Override  
-        filter.addAction(GTaskSyncService.GTASK_SERVICE_BROADCAST_NAME);
+ protected void onCreate(Bundle icicle) {  
-        registerReceiver(mReceiver, filter);
+     // 调用父类的onCreate方法并设置导航图标为应用图标，允许用户通过图标进行导航  
-
+     super.onCreate(icicle);  
-        mOriAccounts = null;
+     getActionBar().setDisplayHomeAsUpEnabled(true);  
-        View header = LayoutInflater.from(this).inflate(R.layout.settings_header, null);
+
-        getListView().addHeaderView(header, null, true);
+     // 从资源文件中加载偏好设置  
-    }
+     addPreferencesFromResource(R.xml.preferences);  
-
+     // 获取账户偏好设置的类别  
-    @Override
+     mAccountCategory = (PreferenceCategory) findPreference(PREFERENCE_SYNC_ACCOUNT_KEY);  
-    protected void onResume() {
+     // 创建一个GTaskReceiver对象  
-        super.onResume();
+     mReceiver = new GTaskReceiver();  
-
+     // 创建一个IntentFilter对象，并添加一个动作过滤器，该动作过滤器用于过滤来自GTaskSyncService的广播  
-        // need to set sync account automatically if user has added a new
+     IntentFilter filter = new IntentFilter();  
-        // account
+     filter.addAction(GTaskSyncService.GTASK_SERVICE_BROADCAST_NAME);  
-        if (mHasAddedAccount) {
+     // 注册广播接收器以接收与GTaskSyncService相关的广播  
-            Account[] accounts = getGoogleAccounts();
+     registerReceiver(mReceiver, filter);  
-            if (mOriAccounts != null && accounts.length > mOriAccounts.length) {
+
-                for (Account accountNew : accounts) {
+     // 将mOriAccounts设置为null，表示尚未初始化该变量（在后续代码中可能会进行初始化）  
-                    boolean found = false;
+     mOriAccounts = null;  
-                    for (Account accountOld : mOriAccounts) {
+     // 使用LayoutInflater从当前context创建一个视图，并从布局文件R.layout.settings_header中获取头部视图（可能包含一些标题或标头信息）  
-                        if (TextUtils.equals(accountOld.name, accountNew.name)) {
+     View header = LayoutInflater.from(this).inflate(R.layout.settings_header, null);  
-                            found = true;
+     // 将头部视图添加到列表视图中，允许在偏好设置列表中显示一些额外的信息或标题等。参数为null是因为我们不需要在此处创建任何新的视图层次结构。第三个参数为true表示在列表中显示头部视图。如果为false，则头部视图不会显示在列表中。  
-                            break;
+     getListView().addHeaderView(header, null, true);  
-                        }
+ } // 结束onCreate方法定义  
-                    }
+} // 结束NotesPreferenceActivity类定义
-                    if (!found) {
+
-                        setSyncAccount(accountNew.name);
+
-                        break;
+@Override  
-                    }
+protected void onResume() {  
-                }
+    super.onResume();  
-            }
+  
-        }
+    // 当用户添加新账户时，需要自动设置同步账户  
-
+    if (mHasAddedAccount) {  
-        refreshUI();
+        // 获取所有Google账户  
-    }
+        Account[] accounts = getGoogleAccounts();  
-
+          
-    @Override
+        // 如果原始账户列表和新获取的账户列表长度不一致，说明有新账户添加  
-    protected void onDestroy() {
+        if (mOriAccounts != null && accounts.length > mOriAccounts.length) {  
-        if (mReceiver != null) {
+            for (Account accountNew : accounts) {  
-            unregisterReceiver(mReceiver);
+                boolean found = false;  
-        }
+                for (Account accountOld : mOriAccounts) {  
-        super.onDestroy();
+                    // 检查新账户是否在原始列表中  
-    }
+                    if (TextUtils.equals(accountOld.name, accountNew.name)) {  
-
+                        found = true;  
-    private void loadAccountPreference() {
+                        break;  
-        mAccountCategory.removeAll();
+                    }  
-
+                }  
-        Preference accountPref = new Preference(this);
+                // 如果新账户不在原始列表中，则设置该账户为同步账户  
-        final String defaultAccount = getSyncAccountName(this);
+                if (!found) {  
-        accountPref.setTitle(getString(R.string.preferences_account_title));
+                    setSyncAccount(accountNew.name);  
-        accountPref.setSummary(getString(R.string.preferences_account_summary));
+                    break;  
-        accountPref.setOnPreferenceClickListener(new OnPreferenceClickListener() {
+                }  
-            public boolean onPreferenceClick(Preference preference) {
+            }  
-                if (!GTaskSyncService.isSyncing()) {
+        }  
-                    if (TextUtils.isEmpty(defaultAccount)) {
+    }  
-                        // the first time to set account
+  
-                        showSelectAccountAlertDialog();
+    // 刷新UI，可能是为了显示同步账户的更改或其他相关UI更新  
-                    } else {
+    refreshUI();  
-                        // if the account has already been set, we need to promp
+}  
-                        // user about the risk
+  
-                        showChangeAccountConfirmAlertDialog();
+@Override  
-                    }
+protected void onDestroy() {  
-                } else {
+    if (mReceiver != null) {  
-                    Toast.makeText(NotesPreferenceActivity.this,
+        // 取消注册广播接收器，以避免内存泄漏  
-                            R.string.preferences_toast_cannot_change_account, Toast.LENGTH_SHORT)
+        unregisterReceiver(mReceiver);  
-                            .show();
+    }  
-                }
+    super.onDestroy();  
-                return true;
+}
-            }
-        });
-
-        mAccountCategory.addPreference(accountPref);
-    }
-
-    private void loadSyncButton() {
-        Button syncButton = (Button) findViewById(R.id.preference_sync_button);
-        TextView lastSyncTimeView = (TextView) findViewById(R.id.prefenerece_sync_status_textview);
-
-        // set button state
-        if (GTaskSyncService.isSyncing()) {
-            syncButton.setText(getString(R.string.preferences_button_sync_cancel));
-            syncButton.setOnClickListener(new View.OnClickListener() {
-                public void onClick(View v) {
-                    GTaskSyncService.cancelSync(NotesPreferenceActivity.this);
-                }
-            });
-        } else {
-            syncButton.setText(getString(R.string.preferences_button_sync_immediately));
-            syncButton.setOnClickListener(new View.OnClickListener() {
-                public void onClick(View v) {
-                    GTaskSyncService.startSync(NotesPreferenceActivity.this);
-                }
-            });
-        }
-        syncButton.setEnabled(!TextUtils.isEmpty(getSyncAccountName(this)));
-
-        // set last sync time
-        if (GTaskSyncService.isSyncing()) {
-            lastSyncTimeView.setText(GTaskSyncService.getProgressString());
-            lastSyncTimeView.setVisibility(View.VISIBLE);
-        } else {
-            long lastSyncTime = getLastSyncTime(this);
-            if (lastSyncTime != 0) {
-                lastSyncTimeView.setText(getString(R.string.preferences_last_sync_time,
-                        DateFormat.format(getString(R.string.preferences_last_sync_time_format),
-                                lastSyncTime)));
-                lastSyncTimeView.setVisibility(View.VISIBLE);
-            } else {
-                lastSyncTimeView.setVisibility(View.GONE);
-            }
-        }
-    }
-
-    private void refreshUI() {
-        loadAccountPreference();
-        loadSyncButton();
-    }
 
-    private void showSelectAccountAlertDialog() {
+//加载账户偏好  
-        AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
+private void loadAccountPreference() {  
+ // 从账户分类中移除所有偏好  
+ mAccountCategory.removeAll();  
+
+ // 创建一个新的偏好，类型为账户  
+ Preference accountPref = new Preference(this);  
+
+ // 获取默认的账户名称  
+ final String defaultAccount = getSyncAccountName(this);  
+
+ // 设置账户偏好的标题  
+ accountPref.setTitle(getString(R.string.preferences_account_title));  
+
+ // 设置账户偏好的摘要信息  
+ accountPref.setSummary(getString(R.string.preferences_account_summary));  
+
+ // 设置账户偏好的点击监听器  
+ accountPref.setOnPreferenceClickListener(new OnPreferenceClickListener() {  
+     public boolean onPreferenceClick(Preference preference) {  
+         // 如果不在同步状态，则执行以下操作  
+         if (!GTaskSyncService.isSyncing()) {  
+             // 如果默认账户为空，表示这是第一次设置账户  
+             if (TextUtils.isEmpty(defaultAccount)) {  
+                 // 显示选择账户的对话框  
+                 showSelectAccountAlertDialog();  
+             } else {  
+                 // 如果账户已经被设置，需要提示用户更改账户的风险  
+                 showChangeAccountConfirmAlertDialog();  
+             }  
+         } else {  
+             // 如果正在同步，则显示一个提示信息，表示不能更改账户  
+             Toast.makeText(NotesPreferenceActivity.this,  
+                     R.string.preferences_toast_cannot_change_account, Toast.LENGTH_SHORT)  
+                     .show();  
+         }  
+         // 返回true表示监听器已经处理了点击事件  
+         return true;  
+     }  
+ });  
+
+ // 将账户偏好添加到账户分类中  
+ mAccountCategory.addPreference(accountPref);  
+}
 
-        View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
-        TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
-        titleTextView.setText(getString(R.string.preferences_dialog_select_account_title));
-        TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);
-        subtitleTextView.setText(getString(R.string.preferences_dialog_select_account_tips));
 
-        dialogBuilder.setCustomTitle(titleView);
+//加载同步按钮  
-        dialogBuilder.setPositiveButton(null, null);
+private void loadSyncButton() {  
+ // 从布局中获取同步按钮  
+ Button syncButton = (Button) findViewById(R.id.preference_sync_button);  
+ // 从布局中获取最后一次同步时间文本视图  
+ TextView lastSyncTimeView = (TextView) findViewById(R.id.prefenerece_sync_status_textview);  
+
+ // 设置按钮状态  
+ // 如果正在同步  
+ if (GTaskSyncService.isSyncing()) {  
+     // 设置按钮文本为"取消同步"  
+     syncButton.setText(getString(R.string.preferences_button_sync_cancel));  
+     // 设置按钮点击监听器，点击时取消同步  
+     syncButton.setOnClickListener(new View.OnClickListener() {  
+         public void onClick(View v) {  
+             GTaskSyncService.cancelSync(NotesPreferenceActivity.this);  
+         }  
+     });  
+ // 如果未同步  
+ } else {  
+     // 设置按钮文本为"立即同步"  
+     syncButton.setText(getString(R.string.preferences_button_sync_immediately));  
+     // 设置按钮点击监听器，点击时开始同步  
+     syncButton.setOnClickListener(new View.OnClickListener() {  
+         public void onClick(View v) {  
+             GTaskSyncService.startSync(NotesPreferenceActivity.this);  
+         }  
+     });  
+ }  
+ // 设置按钮是否可用，如果同步账户名不为空则启用，否则禁用  
+ syncButton.setEnabled(!TextUtils.isEmpty(getSyncAccountName(this)));  
+
+ // 设置最后一次同步时间  
+ // 如果正在同步  
+ if (GTaskSyncService.isSyncing()) {  
+     // 设置最后一次同步时间为进度字符串  
+     lastSyncTimeView.setText(GTaskSyncService.getProgressString());  
+     // 显示最后一次同步时间文本视图  
+     lastSyncTimeView.setVisibility(View.VISIBLE);  
+ // 如果未同步  
+ } else {  
+     // 获取最后一次同步时间  
+     long lastSyncTime = getLastSyncTime(this);  
+     // 如果最后一次同步时间不为0  
+     if (lastSyncTime != 0) {  
+         // 设置最后一次同步时间为格式化的时间字符串，并显示文本视图  
+         lastSyncTimeView.setText(getString(R.string.preferences_last_sync_time,  
+                 DateFormat.format(getString(R.string.preferences_last_sync_time_format),  
+                         lastSyncTime)));  
+         lastSyncTimeView.setVisibility(View.VISIBLE);  
+     // 如果没有同步过  
+     } else {  
+         // 隐藏最后一次同步时间文本视图  
+         lastSyncTimeView.setVisibility(View.GONE);  
+     }  
+ }  
+}
 
-        Account[] accounts = getGoogleAccounts();
-        String defAccount = getSyncAccountName(this);
 
-        mOriAccounts = accounts;
+//刷新UI，可能包括加载账户偏好设置和同步按钮的状态等  
-        mHasAddedAccount = false;
+private void refreshUI() {  
+ // 加载账户偏好设置  
+ loadAccountPreference();  
+ // 加载同步按钮  
+ loadSyncButton();  
+}  
+
+//显示选择账户的对话框提示  
+private void showSelectAccountAlertDialog() {  
+ // 创建对话框构建器  
+ AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);  
+
+ // 从布局中加载 account_dialog_title 视图，并获取其中的 TextView 实例  
+ View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);  
+ // 获取标题文本框实例  
+ TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);  
+ // 设置标题文本  
+ titleTextView.setText(getString(R.string.preferences_dialog_select_account_title));  
+ // 获取副标题文本框实例  
+ TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);  
+ // 设置副标题文本  
+ subtitleTextView.setText(getString(R.string.preferences_dialog_select_account_tips));  
+
+ // 设置自定义标题视图  
+ dialogBuilder.setCustomTitle(titleView);  
+ // 不设置确认按钮的文本和点击监听器  
+ dialogBuilder.setPositiveButton(null, null);  
+
+ // 获取所有谷歌账户  
+ Account[] accounts = getGoogleAccounts();  
+ // 获取默认同步账户名称  
+ String defAccount = getSyncAccountName(this);  
+
+ // 保存原始账户数组  
+ mOriAccounts = accounts;  
+ // 标记是否已添加账户，默认为 false  
+ mHasAddedAccount = false;  
+
+ // 如果存在谷歌账户  
+ if (accounts.length > 0) {  
+     // 创建字符序列数组，用于存放账户名称  
+     CharSequence[] items = new CharSequence[accounts.length];  
+     // 用于映射原始账户数组和字符序列数组的对应关系  
+     final CharSequence[] itemMapping = items;  
+     int checkedItem = -1; // 默认未选中任何账户，初始值为 -1  
+     int index = 0;  
+     // 遍历所有账户  
+     for (Account account : accounts) {  
+         // 如果账户名称与默认同步账户名称相同  
+         if (TextUtils.equals(account.name, defAccount)) {  
+             checkedItem = index; // 将该账户设置为默认选中状态，checkedItem 值为索引值  
+         }  
+         items[index++] = account.name; // 将账户名称存入字符序列数组中  
+     }  
+     // 设置单选列表项，并指定默认选中项和点击监听器  
+     dialogBuilder.setSingleChoiceItems(items, checkedItem,  
+             new DialogInterface.OnClickListener() {  
+                 public void onClick(DialogInterface dialog, int which) {  
+                     // 设置同步账户，参数为选中的账户名称  
+                     setSyncAccount(itemMapping[which].toString());  
+                     // 关闭对话框  
+                     dialog.dismiss();  
+                     // 刷新UI  
+                     refreshUI();  
+                 }  
+             });  
+ }  
+}
 
-        if (accounts.length > 0) {
-            CharSequence[] items = new CharSequence[accounts.length];
-            final CharSequence[] itemMapping = items;
-            int checkedItem = -1;
-            int index = 0;
-            for (Account account : accounts) {
-                if (TextUtils.equals(account.name, defAccount)) {
-                    checkedItem = index;
-                }
-                items[index++] = account.name;
-            }
-            dialogBuilder.setSingleChoiceItems(items, checkedItem,
-                    new DialogInterface.OnClickListener() {
-                        public void onClick(DialogInterface dialog, int which) {
-                            setSyncAccount(itemMapping[which].toString());
-                            dialog.dismiss();
-                            refreshUI();
-                        }
-                    });
-        }
-
-        View addAccountView = LayoutInflater.from(this).inflate(R.layout.add_account_text, null);
-        dialogBuilder.setView(addAccountView);
-
-        final AlertDialog dialog = dialogBuilder.show();
-        addAccountView.setOnClickListener(new View.OnClickListener() {
-            public void onClick(View v) {
-                mHasAddedAccount = true;
-                Intent intent = new Intent("android.settings.ADD_ACCOUNT_SETTINGS");
-                intent.putExtra(AUTHORITIES_FILTER_KEY, new String[] {
-                    "gmail-ls"
-                });
-                startActivityForResult(intent, -1);
-                dialog.dismiss();
-            }
-        });
-    }
 
-    private void showChangeAccountConfirmAlertDialog() {
+//加载添加账户的视图，并将其设置为对话框的内容  
-        AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
+View addAccountView = LayoutInflater.from(this).inflate(R.layout.add_account_text, null);  
-
+dialogBuilder.setView(addAccountView);  
-        View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
+
-        TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
+//创建并显示对话框  
-        titleTextView.setText(getString(R.string.preferences_dialog_change_account_title,
+final AlertDialog dialog = dialogBuilder.show();  
-                getSyncAccountName(this)));
+
-        TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);
+//为添加账户的视图设置点击事件监听器  
-        subtitleTextView.setText(getString(R.string.preferences_dialog_change_account_warn_msg));
+addAccountView.setOnClickListener(new View.OnClickListener() {  
-        dialogBuilder.setCustomTitle(titleView);
+ public void onClick(View v) {  
-
+     // 标记已添加账户  
-        CharSequence[] menuItemArray = new CharSequence[] {
+     mHasAddedAccount = true;  
-                getString(R.string.preferences_menu_change_account),
+     // 创建意图，并设置其动作为添加账户设置  
-                getString(R.string.preferences_menu_remove_account),
+     Intent intent = new Intent("android.settings.ADD_ACCOUNT_SETTINGS");  
-                getString(R.string.preferences_menu_cancel)
+     // 添加过滤条件，仅显示gmail-ls账户  
-        };
+     intent.putExtra(AUTHORITIES_FILTER_KEY, new String[] {  
+         "gmail-ls"  
+     });  
+     // 启动意图，并等待结果（-1）  
+     startActivityForResult(intent, -1);  
+     // 关闭对话框  
+     dialog.dismiss();  
+ }  
+});  
+}  
+
+//显示更改账户的确认对话框  
+private void showChangeAccountConfirmAlertDialog() {  
+AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);  
+
+//加载账户对话框的标题视图，并获取其中的 TextView 实例  
+View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);  
+//获取标题 TextView 实例  
+TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);  
+//设置标题文本，包含当前同步账户的名称  
+titleTextView.setText(getString(R.string.preferences_dialog_change_account_title,  
+     getSyncAccountName(this)));  
+//获取副标题 TextView 实例  
+TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);  
+//设置副标题文本，为警告消息  
+subtitleTextView.setText(getString(R.string.preferences_dialog_change_account_warn_msg));  
+//设置自定义标题视图  
+dialogBuilder.setCustomTitle(titleView);  
+
+//创建菜单项数组，包含更改账户、移除账户和取消三个选项 
+
+CharSequence[] menuItemArray = new CharSequence[] {  
+     getString(R.string.preferences_menu_change_account),  
+     getString(R.string.preferences_menu_remove_account),  
+     getString(R.string.preferences_menu_cancel)  
+};
         dialogBuilder.setItems(menuItemArray, new DialogInterface.OnClickListener() {
             public void onClick(DialogInterface dialog, int which) {
                 if (which == 0) {
@@ -288,101 +394,161 @@ public class NotesPreferenceActivity extends PreferenceActivity {
         return accountManager.getAccountsByType("com.google");
     }
 
-    private void setSyncAccount(String account) {
+    /**  
-        if (!getSyncAccountName(this).equals(account)) {
+     * 设置同步账户  
-            SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
+     *  
-            SharedPreferences.Editor editor = settings.edit();
+     * @param account 要设置的同步账户名称  
-            if (account != null) {
+     */  
-                editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, account);
+    private void setSyncAccount(String account) {  
-            } else {
+        // 检查当前同步账户的名称是否与给定的账户名称不同  
-                editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
+        if (!getSyncAccountName(this).equals(account)) {  
-            }
+            // 获取共享偏好设置  
-            editor.commit();
+            SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);  
-
+            // 创建一个编辑器来修改共享偏好设置  
-            // clean up last sync time
+            SharedPreferences.Editor editor = settings.edit();  
-            setLastSyncTime(this, 0);
+              
-
+            // 如果给定的账户名称不为空，则将其保存到共享偏好设置中  
-            // clean up local gtask related info
+            if (account != null) {  
-            new Thread(new Runnable() {
+                editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, account);  
-                public void run() {
+            } else {  
-                    ContentValues values = new ContentValues();
+                // 否则，将同步账户名称设置为空字符串  
-                    values.put(NoteColumns.GTASK_ID, "");
+                editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, "");  
-                    values.put(NoteColumns.SYNC_ID, 0);
+            }  
-                    getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null);
+              
-                }
+            // 提交编辑，使更改生效  
-            }).start();
+            editor.commit();  
-
+      
-            Toast.makeText(NotesPreferenceActivity.this,
+            // 清理上次同步的时间  
-                    getString(R.string.preferences_toast_success_set_accout, account),
+            setLastSyncTime(this, 0);  
-                    Toast.LENGTH_SHORT).show();
+      
-        }
+            // 在新线程中清理与本地GTask相关的信息  
+            new Thread(new Runnable() {  
+                public void run() {  
+                    ContentValues values = new ContentValues();  
+                    values.put(NoteColumns.GTASK_ID, "");  // 将GTask ID设置为空字符串  
+                    values.put(NoteColumns.SYNC_ID, 0);     // 将同步ID设置为0  
+                    getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null); // 更新内容URI，清理与同步相关的信息  
+                }  
+            }).start(); // 启动新线程来执行清理操作  
+      
+            // 显示一个短暂的Toast消息，告知用户成功设置了账户  
+            Toast.makeText(NotesPreferenceActivity.this,  
+                    getString(R.string.preferences_toast_success_set_accout, account), // 获取并格式化Toast消息文本  
+                    Toast.LENGTH_SHORT).show(); // 显示Toast消息，持续时间短暂  
+        }  
     }
-
+    
-    private void removeSyncAccount() {
+    /**  
-        SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
+     * 移除同步账户  
-        SharedPreferences.Editor editor = settings.edit();
+     */  
-        if (settings.contains(PREFERENCE_SYNC_ACCOUNT_NAME)) {
+    private void removeSyncAccount() {  
-            editor.remove(PREFERENCE_SYNC_ACCOUNT_NAME);
+        // 获取共享偏好设置  
-        }
+        SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);  
-        if (settings.contains(PREFERENCE_LAST_SYNC_TIME)) {
+        // 创建一个编辑器来修改共享偏好设置  
-            editor.remove(PREFERENCE_LAST_SYNC_TIME);
+        SharedPreferences.Editor editor = settings.edit();  
-        }
+      
-        editor.commit();
+        // 如果共享偏好设置中包含同步账户名称，则移除它  
-
+        if (settings.contains(PREFERENCE_SYNC_ACCOUNT_NAME)) {  
-        // clean up local gtask related info
+            editor.remove(PREFERENCE_SYNC_ACCOUNT_NAME);  
-        new Thread(new Runnable() {
+        }  
-            public void run() {
+        // 如果共享偏好设置中包含上次同步的时间，则移除它  
-                ContentValues values = new ContentValues();
+        if (settings.contains(PREFERENCE_LAST_SYNC_TIME)) {  
-                values.put(NoteColumns.GTASK_ID, "");
+            editor.remove(PREFERENCE_LAST_SYNC_TIME);  
-                values.put(NoteColumns.SYNC_ID, 0);
+        }  
-                getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null);
+        // 提交编辑，使更改生效  
-            }
+        editor.commit();  
-        }).start();
+      
-    }
+        // 在新线程中清理与本地GTask相关的信息  
-
+        new Thread(new Runnable() {  
-    public static String getSyncAccountName(Context context) {
+            public void run() {  
-        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
+                ContentValues values = new ContentValues();  
-                Context.MODE_PRIVATE);
+                // 将GTask ID设置为空字符串  
-        return settings.getString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
+                values.put(NoteColumns.GTASK_ID, "");    
-    }
+                // 将同步ID设置为0  
-
+                values.put(NoteColumns.SYNC_ID, 0);      
-    public static void setLastSyncTime(Context context, long time) {
+                // 更新内容URI，清理与同步相关的信息  
-        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
+                getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null);   
-                Context.MODE_PRIVATE);
+            }  
-        SharedPreferences.Editor editor = settings.edit();
+        }).start(); // 启动新线程来执行清理操作  
-        editor.putLong(PREFERENCE_LAST_SYNC_TIME, time);
+    }  
-        editor.commit();
+      
-    }
+    /**  
-
+     * 获取同步账户名称  
-    public static long getLastSyncTime(Context context) {
+     * @param context 上下文对象  
-        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
+     * @return 同步账户名称，如果不存在则返回空字符串  
-                Context.MODE_PRIVATE);
+     */  
-        return settings.getLong(PREFERENCE_LAST_SYNC_TIME, 0);
+    public static String getSyncAccountName(Context context) {  
+        // 获取共享偏好设置  
+        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,  
+                Context.MODE_PRIVATE);  
+        // 返回同步账户名称，如果不存在则返回空字符串  
+        return settings.getString(PREFERENCE_SYNC_ACCOUNT_NAME, "");  
+    }  
+      
+    /**  
+     * 设置上次同步的时间  
+     * @param context 上下文对象  
+     * @param time 上次同步的时间（以毫秒为单位）  
+     */  
+    public static void setLastSyncTime(Context context, long time) {  
+        // 获取共享偏好设置  
+        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,  
+                Context.MODE_PRIVATE);  
+        // 创建一个编辑器来修改共享偏好设置  
+        SharedPreferences.Editor editor = settings.edit();  
+        // 保存上次同步的时间（以毫秒为单位）到共享偏好设置中  
+        editor.putLong(PREFERENCE_LAST_SYNC_TIME, time);  
+        // 提交编辑，使更改生效  
+        editor.commit();  
     }
-
+    
-    private class GTaskReceiver extends BroadcastReceiver {
+    
-
+ // 定义一个公共静态方法，名为getLastSyncTime，接收一个Context对象作为参数  
-        @Override
+ // 该方法用于从SharedPreferences中获取上次同步的时间（以毫秒为单位），如果不存在则返回0  
-        public void onReceive(Context context, Intent intent) {
+ public static long getLastSyncTime(Context context) {  
-            refreshUI();
+     // 从给定的Context对象中获取名为PREFERENCE_NAME的SharedPreferences对象，同时设置其访问模式为Context.MODE_PRIVATE  
-            if (intent.getBooleanExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_IS_SYNCING, false)) {
+     SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,  
-                TextView syncStatus = (TextView) findViewById(R.id.prefenerece_sync_status_textview);
+             Context.MODE_PRIVATE);  
-                syncStatus.setText(intent
+     // 从SharedPreferences对象中获取名为PREFERENCE_Last_SYNC_TIME的值，如果不存在则返回0  
-                        .getStringExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_PROGRESS_MSG));
+     return settings.getLong(PREFERENCE_Last_Sync_Time, 0);  
-            }
+ }  
-
+   
-        }
+ // 定义一个私有的内部类GTaskReceiver，它继承了BroadcastReceiver类  
-    }
+ private class GTaskReceiver extends BroadcastReceiver {  
-
+   
-    public boolean onOptionsItemSelected(MenuItem item) {
+     // 覆盖BroadcastReceiver的onReceive方法，接收两个参数：Context对象和Intent对象  
-        switch (item.getItemId()) {
+     @Override  
-            case android.R.id.home:
+     public void onReceive(Context context, Intent intent) {  
-                Intent intent = new Intent(this, NotesListActivity.class);
+         // 调用refreshUI方法，可能是为了更新用户界面  
-                intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
+         refreshUI();  
-                startActivity(intent);
+         // 从Intent对象中获取一个Boolean类型的额外数据，键为GTaskSyncService.GTASK_SERVICE_BROADCAST_IS_SYNCING，如果不存在则返回false  
-                return true;
+         // 如果该额外数据存在并且为true，说明正在进行同步操作  
-            default:
+         if (intent.getBooleanExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_IS_SYNCING, false)) {  
-                return false;
+             // 从布局中获取id为R.id.prefenerece_sync_status_textview的TextView对象  
-        }
+             TextView syncStatus = (TextView) findViewById(R.id.prefenerece_sync_status_textview);  
-    }
+             // 将从Intent中获取的额外数据（键为GTaskSyncService.GTASK_SERVICE_BROADCAST_PROGRESS_MSG）设置为TextView的内容，显示同步进度信息  
-}
+             syncStatus.setText(intent.getStringExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_PROGRESS_MSG));  
+         }  
+     }  
+ }  
+   
+ // 定义一个公共的onOptionsItemSelected方法，接收一个MenuItem对象作为参数，返回一个boolean值  
+ // 该方法用于处理菜单项的选择事件  
+ public boolean onOptionsItemSelected(MenuItem item) {  
+     // 根据选择的菜单项ID进行不同的处理  
+     switch (item.getItemId()) {  
+         // 如果选择的菜单项ID为android.R.id.home，则执行以下操作：  
+         case android.R.id.home:  
+             // 创建一个新的Intent对象，目标Activity为NotesListActivity.class  
+             Intent intent = new Intent(this, NotesListActivity.class);  
+             // 向Intent对象添加一个标志位，表示在启动新Activity之前先清除当前Activity的栈记录，达到关闭当前Activity的效果  
+             intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);  
+             // 启动目标Activity  
+             startActivity(intent);  
+             // 返回true表示该菜单项已被处理，不再向下执行  
+             return true;  
+         // 如果选择的菜单项ID不属于android.R.id.home，则返回false，表示该菜单项未被处理，继续向下执行其他菜单项的处理逻辑  
+         default:  
+             return false;  
+     }  
+ }