diff --git a/java/net/micode/notes/ui/NotesListAdapter.java b/java/net/micode/notes/ui/NotesListAdapter.java index 51c9cb9..9be4f6d 100644 --- a/java/net/micode/notes/ui/NotesListAdapter.java +++ b/java/net/micode/notes/ui/NotesListAdapter.java @@ -30,19 +30,27 @@ import java.util.HashMap; import java.util.HashSet; import java.util.Iterator; - +/** + * 笔记列表适配器,继承自CursorAdapter + * 用于管理笔记列表的数据和视图绑定 + */ public class NotesListAdapter extends CursorAdapter { - private static final String TAG = "NotesListAdapter"; - private Context mContext; - private HashMap mSelectedIndex; - private int mNotesCount; - private boolean mChoiceMode; + private static final String TAG = "NotesListAdapter"; // 日志标签 + private Context mContext; // 上下文对象 + private HashMap mSelectedIndex; // 存储选中项的位置和状态 + private int mNotesCount; // 笔记总数 + private boolean mChoiceMode; // 是否处于多选模式 + // 小部件属性内部类 public static class AppWidgetAttribute { - public int widgetId; - public int widgetType; - }; + public int widgetId; // 小部件ID + public int widgetType; // 小部件类型 + } + /** + * 构造函数 + * @param context 上下文对象 + */ public NotesListAdapter(Context context) { super(context, null); mSelectedIndex = new HashMap(); @@ -50,36 +58,68 @@ public class NotesListAdapter extends CursorAdapter { mNotesCount = 0; } + /** + * 创建新视图 + * @param context 上下文对象 + * @param cursor 数据游标 + * @param parent 父视图组 + * @return 返回新建的NotesListItem视图 + */ @Override public View newView(Context context, Cursor cursor, ViewGroup parent) { return new NotesListItem(context); } + /** + * 绑定数据到视图 + * @param view 要绑定的视图 + * @param context 上下文对象 + * @param cursor 数据游标 + */ @Override public void bindView(View view, Context context, Cursor cursor) { if (view instanceof NotesListItem) { + // 创建笔记项数据对象并绑定到列表项视图 NoteItemData itemData = new NoteItemData(context, cursor); ((NotesListItem) view).bind(context, itemData, mChoiceMode, isSelectedItem(cursor.getPosition())); } } + /** + * 设置项选中状态 + * @param position 项位置 + * @param checked 是否选中 + */ public void setCheckedItem(final int position, final boolean checked) { mSelectedIndex.put(position, checked); - notifyDataSetChanged(); + notifyDataSetChanged(); // 通知数据变化 } + /** + * 检查是否处于多选模式 + * @return 是否处于多选模式 + */ public boolean isInChoiceMode() { return mChoiceMode; } + /** + * 设置多选模式 + * @param mode 是否启用多选模式 + */ public void setChoiceMode(boolean mode) { - mSelectedIndex.clear(); + mSelectedIndex.clear(); // 清空选中状态 mChoiceMode = mode; } + /** + * 全选/取消全选 + * @param checked 是否选中所有项 + */ public void selectAll(boolean checked) { Cursor cursor = getCursor(); + // 遍历所有项,只选择笔记类型(不包括文件夹) for (int i = 0; i < getCount(); i++) { if (cursor.moveToPosition(i)) { if (NoteItemData.getNoteType(cursor) == Notes.TYPE_NOTE) { @@ -89,11 +129,16 @@ public class NotesListAdapter extends CursorAdapter { } } + /** + * 获取选中项的ID集合 + * @return 选中项的ID集合 + */ public HashSet getSelectedItemIds() { HashSet itemSet = new HashSet(); for (Integer position : mSelectedIndex.keySet()) { if (mSelectedIndex.get(position) == true) { Long id = getItemId(position); + // 过滤根文件夹ID if (id == Notes.ID_ROOT_FOLDER) { Log.d(TAG, "Wrong item id, should not happen"); } else { @@ -101,10 +146,13 @@ public class NotesListAdapter extends CursorAdapter { } } } - return itemSet; } + /** + * 获取选中小部件属性集合 + * @return 小部件属性集合 + */ public HashSet getSelectedWidget() { HashSet itemSet = new HashSet(); for (Integer position : mSelectedIndex.keySet()) { @@ -116,9 +164,7 @@ 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"); return null; @@ -128,6 +174,10 @@ public class NotesListAdapter extends CursorAdapter { return itemSet; } + /** + * 获取选中项数量 + * @return 选中项数量 + */ public int getSelectedCount() { Collection values = mSelectedIndex.values(); if (null == values) { @@ -143,11 +193,20 @@ public class NotesListAdapter extends CursorAdapter { return count; } + /** + * 检查是否全部选中 + * @return 是否全部选中 + */ public boolean isAllSelected() { int checkedCount = getSelectedCount(); return (checkedCount != 0 && checkedCount == mNotesCount); } + /** + * 检查指定位置项是否被选中 + * @param position 项位置 + * @return 是否被选中 + */ public boolean isSelectedItem(final int position) { if (null == mSelectedIndex.get(position)) { return false; @@ -155,18 +214,28 @@ public class NotesListAdapter extends CursorAdapter { return mSelectedIndex.get(position); } + /** + * 内容变化回调 + */ @Override protected void onContentChanged() { super.onContentChanged(); - calcNotesCount(); + calcNotesCount(); // 重新计算笔记数量 } + /** + * 更换游标 + * @param cursor 新游标 + */ @Override public void changeCursor(Cursor cursor) { super.changeCursor(cursor); - calcNotesCount(); + calcNotesCount(); // 重新计算笔记数量 } + /** + * 计算笔记数量(不包括文件夹) + */ private void calcNotesCount() { mNotesCount = 0; for (int i = 0; i < getCount(); i++) { @@ -181,4 +250,4 @@ public class NotesListAdapter extends CursorAdapter { } } } -} +} \ No newline at end of file