Update NotesListActivity.java

# Conflicts:
#	.gradle/8.0/executionHistory/executionHistory.bin
#	.gradle/8.0/executionHistory/executionHistory.lock
#	.gradle/8.0/fileHashes/fileHashes.bin
#	.gradle/8.0/fileHashes/fileHashes.lock
#	.gradle/buildOutputCleanup/buildOutputCleanup.lock
#	.gradle/file-system.probe
#	app/build/intermediates/apk/debug/app-debug.apk
#	app/build/intermediates/incremental/debug/mergeDebugResources/compile-file-map.properties
#	app/build/intermediates/incremental/debug/mergeDebugResources/merged.dir/values/values.xml
#	app/build/intermediates/incremental/debug/packageDebugResources/compile-file-map.properties
#	app/build/intermediates/incremental/debug/packageDebugResources/merged.dir/values/values.xml
#	app/build/intermediates/incremental/packageDebug/tmp/debug/dex-renamer-state.txt
#	app/build/intermediates/incremental/packageDebug/tmp/debug/zip-cache/androidResources
#	app/build/intermediates/merged_res_blame_folder/debug/out/multi-v2/debug.json
#	app/build/intermediates/merged_res_blame_folder/debug/out/multi-v2/values.json
#	app/build/intermediates/processed_res/debug/out/resources-debug.ap_
#	app/build/outputs/apk/debug/app-debug.apk

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

@@ -36,18 +36,29 @@ import net.micode.notes.R;
 
 import java.util.HashMap;
 import java.util.Map;
+/*在这段代码中，定义了一个名为NoteEditText的类，它继承自EditText。这个类用于在EditText的基础上进行一些扩展。
 
+其中，mIndex和mSelectionStartBeforeDelete是两个成员变量，用于存储索引和删除前的光标位置。
+
+接下来定义了几个常量，分别表示不同的Scheme，如电话、网址和电子邮件。
+
+最后，通过一个Map，将每个Scheme与对应的资源ID关联起来。这样可以方便地根据Scheme获取相应的资源ID，用于后续的处理。
+
+*/
 public class NoteEditText extends EditText {
     private static final String TAG = "NoteEditText";
     private int mIndex;
     private int mSelectionStartBeforeDelete;
 
+    // 定义了几种Scheme的常量值
     private static final String SCHEME_TEL = "tel:" ;
     private static final String SCHEME_HTTP = "http:" ;
     private static final String SCHEME_EMAIL = "mailto:" ;
 
+    // 定义了一个Map，用于存储Scheme和对应的资源ID的映射关系
     private static final Map<String, Integer> sSchemaActionResMap = new HashMap<String, Integer>();
     static {
+        // 将不同Scheme和对应的资源ID放入Map中
         sSchemaActionResMap.put(SCHEME_TEL, R.string.note_link_tel);
         sSchemaActionResMap.put(SCHEME_HTTP, R.string.note_link_web);
         sSchemaActionResMap.put(SCHEME_EMAIL, R.string.note_link_email);
@@ -58,47 +69,57 @@ public class NoteEditText extends EditText {
      */
     public interface OnTextViewChangeListener {
         /**
-         * Delete current edit text when {@link KeyEvent#KEYCODE_DEL} happens
-         * and the text is null
+         * 当发生{@link KeyEvent#KEYCODE_DEL}事件且当前文本为空时删除当前编辑的文本
          */
         void onEditTextDelete(int index, String text);
 
         /**
-         * Add edit text after current edit text when {@link KeyEvent#KEYCODE_ENTER}
-         * happen
+         * 当发生{@link KeyEvent#KEYCODE_ENTER}事件时，在当前编辑的文本之后添加一个编辑文本
          */
         void onEditTextEnter(int index, String text);
 
         /**
-         * Hide or show item option when text change
+         * 当文本改变时，隐藏或显示项目选项
          */
         void onTextChange(int index, boolean hasText);
     }
+    /*这是一个自定义的NoteEditText类，继承自EditText，并且实现了一些特定的功能和事件处理。
 
+          以下是对代码的逐行注释：*/
     private OnTextViewChangeListener mOnTextViewChangeListener;
-
+    /*
+    这是NoteEditText类的构造函数之一，它接受一个Context参数，并调用其父类构造函数EditText(Context context, AttributeSet attrs)。另外，它初始化了一个名为mIndex的成员变量，并设置为0。
+    */
     public NoteEditText(Context context) {
         super(context, null);
         mIndex = 0;
     }
-
+   /*
+   这是一个用于设置mIndex成员变量的方法，用于设置编辑文本的索引
+   */
     public void setIndex(int index) {
         mIndex = index;
     }
-
+   /*
+   这是一个用于设置OnTextViewChangeListener监听器的方法，用于监听文本变化事件。
+   */
     public void setOnTextViewChangeListener(OnTextViewChangeListener listener) {
         mOnTextViewChangeListener = listener;
     }
-
+    /*
+    这是NoteEditText类的构造函数之一，它接受一个Context和AttributeSet参数，并调用其父类构造函数EditText(Context context, AttributeSet attrs, int defStyle)。
+    */
     public NoteEditText(Context context, AttributeSet attrs) {
         super(context, attrs, android.R.attr.editTextStyle);
     }
-
+   
     public NoteEditText(Context context, AttributeSet attrs, int defStyle) {
         super(context, attrs, defStyle);
         // TODO Auto-generated constructor stub
     }
-
+    /*
+    这是onTouchEvent方法的重写，用于处理触摸事件，并可以控制光标的位置。
+    */
     @Override
     public boolean onTouchEvent(MotionEvent event) {
         switch (event.getAction()) {
@@ -120,7 +141,9 @@ public class NoteEditText extends EditText {
 
         return super.onTouchEvent(event);
     }
-
+    /*
+    这是onKeyDown方法的重写，用于处理按键事件，例如删除键和回车键。
+    */
     @Override
     public boolean onKeyDown(int keyCode, KeyEvent event) {
         switch (keyCode) {
@@ -137,7 +160,9 @@ public class NoteEditText extends EditText {
         }
         return super.onKeyDown(keyCode, event);
     }
-
+   /*
+   这是onKeyUp方法的重写，用于处理按键释放事件，例如删除键和回车键的释放操作。
+   */
     @Override
     public boolean onKeyUp(int keyCode, KeyEvent event) {
         switch(keyCode) {
@@ -166,7 +191,9 @@ public class NoteEditText extends EditText {
         }
         return super.onKeyUp(keyCode, event);
     }
-
+   /*
+   这是onFocusChanged方法的重写，用于处理焦点改变事件，并根据当前文本内容的有无来显示或隐藏项目选项。
+   */
     @Override
     protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) {
         if (mOnTextViewChangeListener != null) {
@@ -178,7 +205,11 @@ public class NoteEditText extends EditText {
         }
         super.onFocusChanged(focused, direction, previouslyFocusedRect);
     }
+    /*
+    这是onCreateContextMenu方法的重写，用于创建上下文菜单选项，例如处理URL链接的点击事件。
 
+通过上述重写方法，在相应的事件发生时，可以根据需要执行自定义的逻辑，并通过OnTextViewChangeListener监听器回调相关事件。
+*/
     @Override
     protected void onCreateContextMenu(ContextMenu menu) {
         if (getText() instanceof Spanned) {

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

@@ -77,65 +77,91 @@ import java.io.IOException;
 import java.io.InputStream;
 import java.io.InputStreamReader;
 import java.util.HashSet;
-
+//这个类实现了一个便签列表的界面，并包含了点击事件和长按事件的处理。
 public class NotesListActivity extends Activity implements OnClickListener, OnItemLongClickListener {
+    // 定义查询便签列表的令牌
     private static final int FOLDER_NOTE_LIST_QUERY_TOKEN = 0;
 
-    private static final int FOLDER_LIST_QUERY_TOKEN      = 1;
+    // 定义查询文件夹列表的令牌
+    private static final int FOLDER_LIST_QUERY_TOKEN = 1;
 
+    // 定义文件夹菜单选项的常量
     private static final int MENU_FOLDER_DELETE = 0;
-
     private static final int MENU_FOLDER_VIEW = 1;
-
     private static final int MENU_FOLDER_CHANGE_NAME = 2;
 
+    // 定义保存便签介绍的偏好设置参数名称
     private static final String PREFERENCE_ADD_INTRODUCTION = "net.micode.notes.introduction";
 
+    // 枚举类型，表示列表编辑状态
     private enum ListEditState {
         NOTE_LIST, SUB_FOLDER, CALL_RECORD_FOLDER
     };
 
+    // 保存当前列表的编辑状态
     private ListEditState mState;
 
+    // 后台查询操作的处理程序
     private BackgroundQueryHandler mBackgroundQueryHandler;
 
+    // 便签列表数据适配器
     private NotesListAdapter mNotesListAdapter;
 
+    // 显示便签列表的ListView
     private ListView mNotesListView;
 
+    // 添加新便签的按钮
     private Button mAddNewNote;
 
+    // 标识是否分发触摸事件
     private boolean mDispatch;
 
+    // 原始触摸事件的Y坐标
     private int mOriginY;
 
+    // 分发触摸事件的Y坐标
     private int mDispatchY;
 
+    // 显示标题的文本视图
     private TextView mTitleBar;
 
+    // 当前文件夹的ID
     private long mCurrentFolderId;
 
+    // 内容解析器，用于访问应用程序的内容提供程序
     private ContentResolver mContentResolver;
 
+    // 操作模式的回调接口
     private ModeCallback mModeCallBack;
 
+    // 日志标签
     private static final String TAG = "NotesListActivity";
 
+    // 便签列表滚动速率
     public static final int NOTES_LISTVIEW_SCROLL_RATE = 30;
 
+    // 当前焦点便签数据项
     private NoteItemData mFocusNoteDataItem;
 
+    // 便签正常选择的条件
     private static final String NORMAL_SELECTION = NoteColumns.PARENT_ID + "=?";
 
+    // 根文件夹选择的条件
     private static final String ROOT_FOLDER_SELECTION = "(" + NoteColumns.TYPE + "<>"
             + Notes.TYPE_SYSTEM + " AND " + NoteColumns.PARENT_ID + "=?)" + " OR ("
             + NoteColumns.ID + "=" + Notes.ID_CALL_RECORD_FOLDER + " AND "
             + NoteColumns.NOTES_COUNT + ">0)";
 
+    // 打开便签的请求码
     private final static int REQUEST_CODE_OPEN_NODE = 102;
-    private final static int REQUEST_CODE_NEW_NODE  = 103;
 
+    // 新建便签的请求码
+    private final static int REQUEST_CODE_NEW_NODE = 103;
+}
     @Override
+    /*
+    onCreate 方法是 Activity 的生命周期方法之一，当 Activity 创建时调用。在这个方法中，首先调用父类的 onCreate 方法进行初始化操作，然后设置布局文件为 note_list，最后调用 initResources 方法初始化资源，以及调用 setAppInfoFromRawRes 方法插入应用程序的介绍信息。
+    */
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.note_list);
@@ -146,7 +172,9 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
          */
         setAppInfoFromRawRes();
     }
-
+/*
+onActivityResult 方法是在通过 startActivityForResult 启动的活动返回结果后调用。在这个方法中，首先判断返回结果是否成功，并且请求码是打开便签或新建便签的请求码，如果是，则通过调用 mNotesListAdapter.changeCursor(null) 方法来刷新便签列表。如果不满足条件，则调用父类的 onActivityResult 方法进行默认处理。
+*/
     @Override
     protected void onActivityResult(int requestCode, int resultCode, Intent data) {
         if (resultCode == RESULT_OK
@@ -156,7 +184,9 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
             super.onActivityResult(requestCode, resultCode, data);
         }
     }
-
+/*
+setAppInfoFromRawRes 方法是用来从原始资源中读取应用程序的介绍信息并插入到便签列表中的。首先从默认的 SharedPreferences 中获取一个布尔值，该值记录了是否已经插入了介绍信息。如果没有插入介绍信息，则创建一个 StringBuilder 对象用于存储介绍信息，然后通过 getResources().openRawResource(R.raw.introduction) 打开原始资源文件 introduction，并将其读取到 StringBuilder 对象中。如果读取成功，则创建一个 WorkingNote 对象，指定根文件夹ID、App Widget ID、便签类型和颜色，并将介绍信息存储到便签中，最后保存便签并将插入介绍信息的布尔值设置为 true。如果读取或保存过程中发生错误，则打印错误日志并返回。
+*/
     private void setAppInfoFromRawRes() {
         SharedPreferences sp = PreferenceManager.getDefaultSharedPreferences(this);
         if (!sp.getBoolean(PREFERENCE_ADD_INTRODUCTION, false)) {
@@ -204,11 +234,23 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
     }
 
     @Override
+    /*
+    onStart 方法中调用 startAsyncNotesListQuery 开始异步查询笔记列表数据
+    */
     protected void onStart() {
         super.onStart();
         startAsyncNotesListQuery();
     }
-
+      /*
+      initResources 方法中进行资源初始化，包括：
+
+      获取 ContentResolver 和 BackgroundQueryHandler 实例。
+      初始化 mCurrentFolderId。
+      初始化 mNotesListView，设置适配器，添加点击和长按监听器。
+      初始化 mAddNewNote 按钮，并设置点击和触摸监听器。
+      初始化一些变量和视图组件。
+      创建 ModeCallback 实例。
+      */
     private void initResources() {
         mContentResolver = this.getContentResolver();
         mBackgroundQueryHandler = new BackgroundQueryHandler(this.getContentResolver());
@@ -230,7 +272,12 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         mState = ListEditState.NOTE_LIST;
         mModeCallBack = new ModeCallback();
     }
+/*
+      ModeCallback 内部类实现了 ListView 的多选模式监听器和菜单项点击监听器，包括：
 
+      创建 ActionMode 时显示菜单和设置相关逻辑。
+      更新下拉菜单中的选中状态和显示文本。
+      */
     private class ModeCallback implements ListView.MultiChoiceModeListener, OnMenuItemClickListener {
         private DropdownMenu mDropDownMenu;
         private ActionMode mActionMode;
@@ -268,7 +315,14 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
             });
             return true;
         }
-
+    /*
+    updateMenu 方法更新下拉菜单的标题和选项。
+
+    首先，获取选中的笔记数量。
+    然后，使用格式化字符串将选中的笔记数量与标题文本（资源字符串）合并。
+    更新下拉菜单的标题为合并后的文本。
+    根据选中状态更新下拉菜单中的全选/取消全选选项的文本和勾选状态。
+    */
         private void updateMenu() {
             int selectedCount = mNotesListAdapter.getSelectedCount();
             // Update dropdown menu
@@ -285,17 +339,24 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
                 }
             }
         }
-
+     /*
+     onPrepareActionMode 方法用于在 ActionMode 准备时执行一些操作，但在这个方法中并没有实现任何逻辑，返回值为 false。
+     */
         public boolean onPrepareActionMode(ActionMode mode, Menu menu) {
             // TODO Auto-generated method stub
             return false;
         }
-
+     //onActionItemClicked 方法用于在点击 ActionMode 的菜单项时执行一些操作，但在这个方法中并没有实现任何逻辑，返回值为 false。
         public boolean onActionItemClicked(ActionMode mode, MenuItem item) {
             // TODO Auto-generated method stub
             return false;
         }
-
+    /*
+    onDestroyActionMode 方法在销毁 ActionMode 时执行一些操作，包括：
+    将适配器的选择模式设置为 false，取消选择模式。
+    将笔记列表视图设置为可长按。
+    将 mAddNewNote 按钮设置为可见。
+*/
         public void onDestroyActionMode(ActionMode mode) {
             mNotesListAdapter.setChoiceMode(false);
             mNotesListView.setLongClickable(true);
@@ -305,13 +366,22 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         public void finishActionMode() {
             mActionMode.finish();
         }
+     /*
+      onItemCheckedStateChanged 方法在列表项选中状态改变时执行一些操作，包括：
 
+      在适配器中设置指定位置的项是否被选中。
+      调用 updateMenu 方法更新下拉菜单。
+      */
         public void onItemCheckedStateChanged(ActionMode mode, int position, long id,
                 boolean checked) {
             mNotesListAdapter.setCheckedItem(position, checked);
             updateMenu();
         }
-
+     /*
+     onMenuItemClick 方法在点击菜单项时执行一些操作，包括：
+      检查是否有选中的项，如果没有选中的项则显示一个 Toast 提示用户选择内容。
+      返回 true 表示菜单项点击事件已被处理。
+      */
         public boolean onMenuItemClick(MenuItem item) {
             if (mNotesListAdapter.getSelectedCount() == 0) {
                 Toast.makeText(NotesListActivity.this, getString(R.string.menu_select_none),

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

@@ -30,19 +30,28 @@ import java.util.HashMap;
 import java.util.HashSet;
 import java.util.Iterator;
 
-
+/*
+NotesListAdapter 是一个用于在列表中展示笔记的适配器类，继承自CursorAdapter，用于与数据库中的笔记数据进行交互并在列表中展示。该类中包含了一系列方法用于选择、操作列表项，并在其中还包含了一个内部类AppWidgetAttribute用于存储小部件的属性。
+*/
 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 int widgetId;     // 小部件的ID
+        public int widgetType;   // 小部件的类型
+    }
 
+    // 初始化适配器的构造函数
     public NotesListAdapter(Context context) {
         super(context, null);
         mSelectedIndex = new HashMap<Integer, Boolean>();
@@ -50,34 +59,40 @@ public class NotesListAdapter extends CursorAdapter {
         mNotesCount = 0;
     }
 
+    // 创建一个新的视图来表示列表中的项
     @Override
     public View newView(Context context, Cursor cursor, ViewGroup parent) {
         return new NotesListItem(context);
     }
 
+    // 将视图与指定位置上的数据进行绑定
     @Override
     public void bindView(View view, Context context, Cursor cursor) {
         if (view instanceof NotesListItem) {
+            // 从游标中创建NoteItemData，并将其与NotesListItem进行绑定
             NoteItemData itemData = new NoteItemData(context, cursor);
-            ((NotesListItem) view).bind(context, itemData, mChoiceMode,
-                    isSelectedItem(cursor.getPosition()));
+            ((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++) {
@@ -89,22 +104,23 @@ public class NotesListAdapter extends CursorAdapter {
         }
     }
 
+    // 获取选中项目的ID集合
     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");
+                    Log.d(TAG, "错误的项目ID，不应该发生");
                 } else {
                     itemSet.add(id);
                 }
             }
         }
-
         return itemSet;
     }
 
+    // 获取选中小部件的属性集合
     public HashSet<AppWidgetAttribute> getSelectedWidget() {
         HashSet<AppWidgetAttribute> itemSet = new HashSet<AppWidgetAttribute>();
         for (Integer position : mSelectedIndex.keySet()) {
@@ -116,11 +132,8 @@ public class NotesListAdapter extends CursorAdapter {
                     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");
+                    Log.e(TAG, "无效的游标");
                     return null;
                 }
             }
@@ -128,6 +141,7 @@ public class NotesListAdapter extends CursorAdapter {
         return itemSet;
     }
 
+    // 获取选中项目的数量
     public int getSelectedCount() {
         Collection<Boolean> values = mSelectedIndex.values();
         if (null == values) {
@@ -143,11 +157,13 @@ public class NotesListAdapter extends CursorAdapter {
         return count;
     }
 
+    // 检查是否全部项目都被选中
     public boolean isAllSelected() {
         int checkedCount = getSelectedCount();
         return (checkedCount != 0 && checkedCount == mNotesCount);
     }
 
+    // 检查指定位置上的项目是否被选中
     public boolean isSelectedItem(final int position) {
         if (null == mSelectedIndex.get(position)) {
             return false;
@@ -155,18 +171,21 @@ public class NotesListAdapter extends CursorAdapter {
         return mSelectedIndex.get(position);
     }
 
+    // 当数据集的内容发生变化时调用
     @Override
     protected void onContentChanged() {
         super.onContentChanged();
         calcNotesCount();
     }
 
+    // 改变游标
     @Override
     public void changeCursor(Cursor cursor) {
         super.changeCursor(cursor);
         calcNotesCount();
     }
 
+    // 计算列表中笔记的数量
     private void calcNotesCount() {
         mNotesCount = 0;
         for (int i = 0; i < getCount(); i++) {
@@ -176,7 +195,7 @@ public class NotesListAdapter extends CursorAdapter {
                     mNotesCount++;
                 }
             } else {
-                Log.e(TAG, "Invalid cursor");
+                Log.e(TAG, "无效的游标");
                 return;
             }
         }

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

@@ -28,95 +28,105 @@ 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;
-    private TextView mTitle;
-    private TextView mTime;
-    private TextView mCallName;
-    private NoteItemData mItemData;
-    private CheckBox mCheckBox;
+    private ImageView mAlert;  // 提醒图标
+    private TextView mTitle;   // 标题
+    private TextView mTime;    // 时间
+    private TextView mCallName;    // 通话名称
+    private NoteItemData mItemData; // 笔记项数据
+    private CheckBox mCheckBox;    // 多选框
 
     public NotesListItem(Context context) {
         super(context);
-        inflate(context, R.layout.note_item, this);
-        mAlert = (ImageView) findViewById(R.id.iv_alert_icon);
-        mTitle = (TextView) findViewById(R.id.tv_title);
-        mTime = (TextView) findViewById(R.id.tv_time);
-        mCallName = (TextView) findViewById(R.id.tv_name);
-        mCheckBox = (CheckBox) findViewById(android.R.id.checkbox);
+        inflate(context, R.layout.note_item, this);  // 填充视图
+        mAlert = (ImageView) findViewById(R.id.iv_alert_icon);  // 初始化提醒图标
+        mTitle = (TextView) findViewById(R.id.tv_title);        // 初始化标题
+        mTime = (TextView) findViewById(R.id.tv_time);          // 初始化时间
+        mCallName = (TextView) findViewById(R.id.tv_name);      // 初始化通话名称
+        mCheckBox = (CheckBox) findViewById(android.R.id.checkbox); // 初始化多选框
     }
 
+    // 绑定数据到视图
     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 {
+        } else { // 否则隐藏多选框
             mCheckBox.setVisibility(View.GONE);
         }
 
-        mItemData = data;
-        if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {
-            mCallName.setVisibility(View.GONE);
-            mAlert.setVisibility(View.VISIBLE);
+        mItemData = data; // 保存数据项
+
+        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) {
-            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);
+            mAlert.setImageResource(R.drawable.call_record); // 设置提醒图标为通话记录图标
+        } 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);
+                mAlert.setVisibility(View.GONE); // 隐藏提醒图标
             }
-        } else {
-            mCallName.setVisibility(View.GONE);
-            mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
+        } else { // 其他类型的笔记项
+            mCallName.setVisibility(View.GONE); // 隐藏通话名称
+            mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);// 设置标题文本样式为主要文本样式
 
-            if (data.getType() == Notes.TYPE_FOLDER) {
+            if (data.getType() == Notes.TYPE_FOLDER) { // 如果是文件夹类型
+                // 设置标题文本为文件夹名称和包含的文件数
                 mTitle.setText(data.getSnippet()
                         + context.getString(R.string.format_folder_files_count,
                                 data.getNotesCount()));
-                mAlert.setVisibility(View.GONE);
-            } else {
-                mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));
-                if (data.hasAlert()) {
-                    mAlert.setImageResource(R.drawable.clock);
-                    mAlert.setVisibility(View.VISIBLE);
+                mAlert.setVisibility(View.GONE); // 隐藏提醒图标
+            } else { // 如果是笔记类型
+                mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet())); // 设置标题文本为格式化的说明文本
+                if (data.hasAlert()) { // 如果有提醒
+                    mAlert.setImageResource(R.drawable.clock); // 设置提醒图标为闹钟图标
+                    mAlert.setVisibility(View.VISIBLE); // 显示提醒图标
                 } else {
-                    mAlert.setVisibility(View.GONE);
+                    mAlert.setVisibility(View.GONE); // 隐藏提醒图标
                 }
             }
         }
-        mTime.setText(DateUtils.getRelativeTimeSpanString(data.getModifiedDate()));
+        
+        mTime.setText(DateUtils.getRelativeTimeSpanString(data.getModifiedDate()));  // 设置时间文本为相对时间
 
-        setBackground(data);
+        setBackground(data); // 设置背景
     }
 
+    // 设置背景
     private void setBackground(NoteItemData data) {
         int id = data.getBgColorId();
-        if (data.getType() == Notes.TYPE_NOTE) {
-            if (data.isSingle() || data.isOneFollowingFolder()) {
-                setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id));
-            } else if (data.isLast()) {
-                setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(id));
-            } else if (data.isFirst() || data.isMultiFollowingFolder()) {
-                setBackgroundResource(NoteItemBgResources.getNoteBgFirstRes(id));
-            } else {
-                setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(id));
+        if (data.getType() == Notes.TYPE_NOTE) { // 如果是笔记类型
+            if (data.isSingle() || data.isOneFollowingFolder()) { // 如果是单个笔记或者是紧接在文件夹后面的单个笔记
+                setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id)); // 设置背景资源为单个笔记的背景资源
+            } else if (data.isLast()) { // 如果是最后一个笔记
+                setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(id)); // 设置背景资源为最后一个笔记的背景资源
+            } else if (data.isFirst() || data.isMultiFollowingFolder()) { // 如果是第一个笔记或者是紧接在文件夹后面的多个笔记
+                setBackgroundResource(NoteItemBgResources.getNoteBgFirstRes(id)); // 设置背景资源为第一个笔记的背景资源
+            } else { // 其他情况
+                setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(id)); // 设置背景资源为普通笔记的背景资源
             }
-        } else {
-            setBackgroundResource(NoteItemBgResources.getFolderBgRes());
+        } else { // 如果是文件夹类型
+            setBackgroundResource(NoteItemBgResources.getFolderBgRes()); // 设置背景资源为文件夹的背景资源
         }
     }
 
     public NoteItemData getItemData() {
         return mItemData;
     }
-}
+}