|
|
/*
|
|
|
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
|
|
|
*
|
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
* you may not use this file except in compliance with the License.
|
|
|
* You may obtain a copy of the License at
|
|
|
*
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
|
*
|
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
* See the License for the specific language governing permissions and
|
|
|
* limitations under the License.
|
|
|
*/
|
|
|
|
|
|
package net.micode.notes.ui;
|
|
|
|
|
|
// 导入Android相关的库，用于处理数据库查询和视图的适配
|
|
|
import android.content.Context; // 用于处理应用程序上下文
|
|
|
import android.database.Cursor; // 用于数据库查询的游标
|
|
|
import android.util.Log; // 用于记录日志
|
|
|
import android.view.View; // 用于视图组件
|
|
|
import android.view.ViewGroup; // 用于视图容器
|
|
|
import android.widget.CursorAdapter; // 用于适配器，绑定数据库游标到视图
|
|
|
|
|
|
// 导入与笔记相关的类
|
|
|
import net.micode.notes.data.Notes; // 用于操作笔记数据
|
|
|
|
|
|
// 导入集合类，用于数据存储和处理
|
|
|
import java.util.Collection; // 用于操作一组对象
|
|
|
import java.util.HashMap; // 用于存储键值对
|
|
|
import java.util.HashSet; // 用于存储唯一元素集合
|
|
|
import java.util.Iterator; // 用于遍历集合元素
|
|
|
|
|
|
|
|
|
// 自定义适配器，用于显示笔记列表
|
|
|
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; // 小部件的 ID
|
|
|
public int widgetType; // 小部件的类型
|
|
|
};
|
|
|
|
|
|
// 构造函数，初始化适配器
|
|
|
public NotesListAdapter(Context context) {
|
|
|
super(context, null); // 调用父类构造函数，传入上下文和空游标
|
|
|
mSelectedIndex = new HashMap<Integer, Boolean>(); // 初始化存储选中项的 HashMap
|
|
|
mContext = context; // 设置上下文
|
|
|
mNotesCount = 0; // 初始化笔记数量
|
|
|
}
|
|
|
|
|
|
// 创建新视图，当每一项数据被绑定时，调用此方法
|
|
|
@Override
|
|
|
public View newView(Context context, Cursor cursor, ViewGroup parent) {
|
|
|
return new NotesListItem(context); // 返回一个新的 NotesListItem 视图
|
|
|
}
|
|
|
|
|
|
// 绑定数据到视图上
|
|
|
@Override
|
|
|
public void bindView(View view, Context context, Cursor cursor) {
|
|
|
if (view instanceof NotesListItem) { // 如果视图是 NotesListItem 类型
|
|
|
// 从游标中提取数据，构建 NoteItemData 对象
|
|
|
NoteItemData itemData = new NoteItemData(context, cursor);
|
|
|
// 将数据绑定到视图中，并考虑选择模式和选中状态
|
|
|
((NotesListItem) view).bind(context, itemData, mChoiceMode,
|
|
|
isSelectedItem(cursor.getPosition()));
|
|
|
}
|
|
|
}
|
|
|
|
|
|
// 设置指定位置的选中状态
|
|
|
public void setCheckedItem(final int position, final boolean checked) {
|
|
|
mSelectedIndex.put(position, checked); // 更新选中状态
|
|
|
notifyDataSetChanged(); // 通知数据发生变化，刷新视图
|
|
|
}
|
|
|
|
|
|
// 判断是否处于选择模式
|
|
|
public boolean isInChoiceMode() {
|
|
|
return mChoiceMode;
|
|
|
}
|
|
|
|
|
|
// 设置是否进入选择模式
|
|
|
public void setChoiceMode(boolean mode) {
|
|
|
mSelectedIndex.clear(); // 清除所有选中状态
|
|
|
mChoiceMode = mode; // 设置选择模式
|
|
|
}
|
|
|
|
|
|
// 选择所有项目或取消选择
|
|
|
public void selectAll(boolean checked) {
|
|
|
Cursor cursor = getCursor(); // 获取当前游标
|
|
|
for (int i = 0; i < getCount(); i++) { // 遍历所有项
|
|
|
if (cursor.moveToPosition(i)) { // 移动游标到指定位置
|
|
|
// 如果该项是笔记类型
|
|
|
if (NoteItemData.getNoteType(cursor) == Notes.TYPE_NOTE) {
|
|
|
setCheckedItem(i, checked); // 更新选中状态
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
|
|
|
// 获取已选择的项的ID集合
|
|
|
public HashSet<Long> getSelectedItemIds() {
|
|
|
HashSet<Long> itemSet = new HashSet<Long>(); // 创建一个HashSet来存储选中的ID
|
|
|
// 遍历所有选中的项的索引
|
|
|
for (Integer position : mSelectedIndex.keySet()) {
|
|
|
if (mSelectedIndex.get(position) == true) { // 判断该项是否被选中
|
|
|
Long id = getItemId(position); // 获取该项的ID
|
|
|
if (id == Notes.ID_ROOT_FOLDER) { // 如果ID为根文件夹ID，记录日志并跳过该项
|
|
|
Log.d(TAG, "Wrong item id, should not happen");
|
|
|
} else {
|
|
|
itemSet.add(id); // 将ID添加到itemSet中
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
return itemSet; // 返回所有选中项的ID集合
|
|
|
}
|
|
|
|
|
|
// 获取已选择的小部件（AppWidget）属性集合
|
|
|
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(); // 获取小部件ID
|
|
|
widget.widgetType = item.getWidgetType(); // 获取小部件类型
|
|
|
itemSet.add(widget); // 将小部件属性添加到itemSet中
|
|
|
// 注意：不要在这里关闭Cursor，由适配器负责关闭
|
|
|
} else {
|
|
|
Log.e(TAG, "Invalid cursor"); // 如果Cursor为空，记录错误日志并返回null
|
|
|
return null;
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
return itemSet; // 返回所有选中项的小部件属性集合
|
|
|
}
|
|
|
|
|
|
// 获取已选中项的数量
|
|
|
public int getSelectedCount() {
|
|
|
Collection<Boolean> values = mSelectedIndex.values(); // 获取选中项的状态集合
|
|
|
if (null == values) {
|
|
|
return 0; // 如果没有选中项，返回0
|
|
|
}
|
|
|
Iterator<Boolean> iter = values.iterator();
|
|
|
int count = 0;
|
|
|
// 遍历选中项状态，如果为true则计数
|
|
|
while (iter.hasNext()) {
|
|
|
if (true == iter.next()) {
|
|
|
count++;
|
|
|
}
|
|
|
}
|
|
|
return count; // 返回选中项的数量
|
|
|
}
|
|
|
|
|
|
// 判断是否所有项都被选中
|
|
|
public boolean isAllSelected() {
|
|
|
int checkedCount = getSelectedCount(); // 获取已选中项的数量
|
|
|
return (checkedCount != 0 && checkedCount == mNotesCount); // 如果已选中项的数量等于总项数，则返回true
|
|
|
}
|
|
|
|
|
|
// 判断某个位置的项是否被选中
|
|
|
public boolean isSelectedItem(final int position) {
|
|
|
if (null == mSelectedIndex.get(position)) {
|
|
|
return false; // 如果该位置没有被选中，返回false
|
|
|
}
|
|
|
return mSelectedIndex.get(position); // 返回该位置的选中状态
|
|
|
|
|
|
|
|
|
@Override
|
|
|
protected void onContentChanged() {
|
|
|
// 当内容发生变化时调用，通常用于刷新UI或更新数据
|
|
|
super.onContentChanged();
|
|
|
// 重新计算笔记的数量
|
|
|
calcNotesCount();
|
|
|
}
|
|
|
|
|
|
@Override
|
|
|
public void changeCursor(Cursor cursor) {
|
|
|
// 当游标（Cursor）发生变化时调用，通常在数据更新时触发
|
|
|
super.changeCursor(cursor);
|
|
|
// 重新计算笔记的数量
|
|
|
calcNotesCount();
|
|
|
}
|
|
|
|
|
|
private void calcNotesCount() {
|
|
|
// 初始化笔记数量为0
|
|
|
mNotesCount = 0;
|
|
|
// 遍历当前的数据项，假设这些数据项是通过Cursor获取的
|
|
|
for (int i = 0; i < getCount(); i++) {
|
|
|
// 获取当前位置的Cursor对象
|
|
|
Cursor c = (Cursor) getItem(i);
|
|
|
if (c != null) {
|
|
|
// 如果当前游标存在，检查数据项类型是否为笔记类型
|
|
|
if (NoteItemData.getNoteType(c) == Notes.TYPE_NOTE) {
|
|
|
// 如果是笔记类型，增加笔记数量
|
|
|
mNotesCount++;
|
|
|
}
|
|
|
} else {
|
|
|
// 如果游标为null，打印错误日志并返回
|
|
|
Log.e(TAG, "Invalid cursor");
|
|
|
return;
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
} |
