|
|
/*
|
|
|
* 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.app.Activity; // 用于创建和管理Activity
|
|
|
import android.app.AlertDialog; // 用于弹出对话框
|
|
|
import android.app.Dialog; // 用于显示对话框
|
|
|
import android.appwidget.AppWidgetManager; // 用于操作应用程序小部件
|
|
|
import android.content.AsyncQueryHandler; // 用于异步数据库查询
|
|
|
import android.content.ContentResolver; // 用于访问内容提供者
|
|
|
import android.content.ContentValues; // 用于存储内容提供者的值
|
|
|
import android.content.Context; // 获取应用的上下文
|
|
|
import android.content.DialogInterface; // 用于管理对话框的接口
|
|
|
import android.content.Intent; // 用于启动其他组件
|
|
|
import android.content.SharedPreferences; // 用于保存和获取应用设置
|
|
|
import android.database.Cursor; // 用于数据库查询结果的游标
|
|
|
import android.os.AsyncTask; // 用于后台任务的异步处理
|
|
|
import android.os.Bundle; // 用于存储Activity的状态
|
|
|
import android.preference.PreferenceManager; // 管理SharedPreferences的工具类
|
|
|
import android.text.Editable; // 用于监听和编辑文本的类
|
|
|
import android.text.TextUtils; // 用于文本处理的工具类
|
|
|
import android.text.TextWatcher; // 用于监听文本变化
|
|
|
import android.util.Log; // 用于日志输出
|
|
|
import android.view.ActionMode; // 用于管理操作模式（如长按选择）
|
|
|
import android.view.ContextMenu; // 用于上下文菜单的创建
|
|
|
import android.view.ContextMenu.ContextMenuInfo; // 上下文菜单的信息
|
|
|
import android.view.Display; // 用于显示设备信息
|
|
|
import android.view.HapticFeedbackConstants; // 用于触觉反馈常量
|
|
|
import android.view.LayoutInflater; // 用于加载布局
|
|
|
import android.view.Menu; // 用于创建菜单
|
|
|
import android.view.MenuItem; // 用于菜单项的定义
|
|
|
import android.view.MenuItem.OnMenuItemClickListener; // 菜单项点击监听器
|
|
|
import android.view.MotionEvent; // 用于处理触摸事件
|
|
|
import android.view.View; // 所有视图组件的基类
|
|
|
import android.view.View.OnClickListener; // 点击事件监听器
|
|
|
import android.view.View.OnCreateContextMenuListener; // 上下文菜单创建监听器
|
|
|
import android.view.View.OnTouchListener; // 触摸事件监听器
|
|
|
import android.view.inputmethod.InputMethodManager; // 用于管理输入法
|
|
|
import android.widget.AdapterView; // 用于适配器视图（如ListView）的操作
|
|
|
import android.widget.AdapterView.OnItemClickListener; // 列表项点击监听器
|
|
|
import android.widget.AdapterView.OnItemLongClickListener; // 列表项长按监听器
|
|
|
import android.widget.Button; // 按钮组件
|
|
|
import android.widget.EditText; // 编辑文本组件
|
|
|
import android.widget.ListView; // 列表视图组件
|
|
|
import android.widget.PopupMenu; // 弹出菜单
|
|
|
import android.widget.TextView; // 文本视图组件
|
|
|
import android.widget.Toast; // 用于显示短暂消息的Toast
|
|
|
|
|
|
// 导入应用程序相关的数据、工具和部件
|
|
|
import net.micode.notes.R; // 引入应用程序的资源文件
|
|
|
import net.micode.notes.data.Notes; // 引入笔记数据模型
|
|
|
import net.micode.notes.data.Notes.NoteColumns; // 引入笔记数据表的列
|
|
|
import net.micode.notes.gtask.remote.GTaskSyncService; // 用于Google任务同步服务
|
|
|
import net.micode.notes.model.WorkingNote; // 用于操作当前笔记的模型
|
|
|
import net.micode.notes.tool.BackupUtils; // 用于备份操作的工具类
|
|
|
import net.micode.notes.tool.DataUtils; // 用于数据处理的工具类
|
|
|
import net.micode.notes.tool.ResourceParser; // 用于解析资源的工具类
|
|
|
import net.micode.notes.ui.NotesListAdapter.AppWidgetAttribute; // 用于App Widget的适配器
|
|
|
import net.micode.notes.widget.NoteWidgetProvider_2x; // 用于提供2x大小的笔记小部件
|
|
|
import net.micode.notes.widget.NoteWidgetProvider_4x; // 用于提供4x大小的笔记小部件
|
|
|
|
|
|
import java.io.BufferedReader; // 用于缓冲读取文本数据
|
|
|
import java.io.IOException; // 用于处理I/O异常
|
|
|
import java.io.InputStream; // 用于输入流操作
|
|
|
import java.io.InputStreamReader; // 用于将输入流转换为字符流
|
|
|
import java.util.HashSet; // 用于存储唯一元素的集合
|
|
|
|
|
|
// 在代码中添加详细注释，解释每个功能模块的作用和实现细节。
|
|
|
// 比如上面引入了很多Android类和自定义类，接下来代码会用到这些类来实现应用程序的具体功能。
|
|
|
|
|
|
public class NotesListActivity extends Activity implements OnClickListener, OnItemLongClickListener {
|
|
|
|
|
|
// 定义了两个常量用于标识查询操作的 token
|
|
|
private static final int FOLDER_NOTE_LIST_QUERY_TOKEN = 0;
|
|
|
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;
|
|
|
|
|
|
// 处理后台查询操作的 Handler
|
|
|
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;
|
|
|
|
|
|
// 模式回调，用于响应 UI 操作
|
|
|
private ModeCallback mModeCallBack;
|
|
|
|
|
|
// 日志标签
|
|
|
private static final String TAG = "NotesListActivity";
|
|
|
|
|
|
// 设置滚动速率
|
|
|
public static final int NOTES_LISTVIEW_SCROLL_RATE = 30;
|
|
|
|
|
|
// 当前聚焦的笔记数据项
|
|
|
private NoteItemData mFocusNoteDataItem;
|
|
|
|
|
|
// 用于查询的正常选择条件：父目录 ID
|
|
|
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;
|
|
|
|
|
|
@Override
|
|
|
protected void onCreate(Bundle savedInstanceState) {
|
|
|
super.onCreate(savedInstanceState);
|
|
|
// 设置当前活动的布局文件
|
|
|
setContentView(R.layout.note_list);
|
|
|
|
|
|
// 初始化资源，可能包括数据库、界面元素等
|
|
|
initResources();
|
|
|
|
|
|
/**
|
|
|
* Insert an introduction when user firstly use this application
|
|
|
*/
|
|
|
setAppInfoFromRawRes();
|
|
|
}
|
|
|
|
|
|
@Override
|
|
|
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
|
|
|
// 处理返回结果，主要是针对打开或新建笔记的操作
|
|
|
if (resultCode == RESULT_OK
|
|
|
&& (requestCode == REQUEST_CODE_OPEN_NODE || requestCode == REQUEST_CODE_NEW_NODE)) {
|
|
|
// 如果是打开或新建笔记成功，更新列表适配器，清空数据（重新加载）
|
|
|
mNotesListAdapter.changeCursor(null);
|
|
|
} else {
|
|
|
// 否则，调用父类的 onActivityResult 处理
|
|
|
super.onActivityResult(requestCode, resultCode, data);
|
|
|
}
|
|
|
}
|
|
|
|
|
|
private void setAppInfoFromRawRes() {
|
|
|
// 获取应用的 SharedPreferences，用于存储应用的设置
|
|
|
SharedPreferences sp = PreferenceManager.getDefaultSharedPreferences(this);
|
|
|
|
|
|
// 判断是否已经添加过介绍内容，如果添加过则不再执行
|
|
|
if (!sp.getBoolean(PREFERENCE_ADD_INTRODUCTION, false)) {
|
|
|
// 创建一个 StringBuilder 来存储介绍内容
|
|
|
StringBuilder sb = new StringBuilder();
|
|
|
InputStream in = null;
|
|
|
|
|
|
try {
|
|
|
// 打开 raw 资源文件，获取介绍内容
|
|
|
in = getResources().openRawResource(R.raw.introduction);
|
|
|
|
|
|
// 如果文件成功读取
|
|
|
if (in != null) {
|
|
|
InputStreamReader isr = new InputStreamReader(in);
|
|
|
BufferedReader br = new BufferedReader(isr);
|
|
|
char[] buf = new char[1024];
|
|
|
int len = 0;
|
|
|
|
|
|
// 逐行读取文件内容并追加到 StringBuilder 中
|
|
|
while ((len = br.read(buf)) > 0) {
|
|
|
sb.append(buf, 0, len);
|
|
|
}
|
|
|
} else {
|
|
|
Log.e(TAG, "Read introduction file error");
|
|
|
return;
|
|
|
}
|
|
|
} catch (IOException e) {
|
|
|
// 处理读取过程中可能发生的异常
|
|
|
e.printStackTrace();
|
|
|
return;
|
|
|
} finally {
|
|
|
// 关闭输入流，确保资源被释放
|
|
|
if (in != null) {
|
|
|
try {
|
|
|
in.close();
|
|
|
} catch (IOException e) {
|
|
|
// 处理关闭流时的异常
|
|
|
e.printStackTrace();
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
|
|
|
// 创建一个空的工作笔记，设置为介绍内容
|
|
|
WorkingNote note = WorkingNote.createEmptyNote(this, Notes.ID_ROOT_FOLDER,
|
|
|
AppWidgetManager.INVALID_APPWIDGET_ID, Notes.TYPE_WIDGET_INVALIDE,
|
|
|
ResourceParser.RED);
|
|
|
note.setWorkingText(sb.toString());
|
|
|
|
|
|
// 保存介绍笔记，并在 SharedPreferences 中标记已添加介绍内容
|
|
|
if (note.saveNote()) {
|
|
|
sp.edit().putBoolean(PREFERENCE_ADD_INTRODUCTION, true).commit();
|
|
|
} else {
|
|
|
// 如果保存笔记失败，输出错误日志
|
|
|
Log.e(TAG, "Save introduction note error");
|
|
|
return;
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
|
|
|
|
|
|
@Override
|
|
|
protected void onStart() {
|
|
|
super.onStart();
|
|
|
startAsyncNotesListQuery();
|
|
|
}
|
|
|
|
|
|
private void initResources() {
|
|
|
mContentResolver = this.getContentResolver();
|
|
|
mBackgroundQueryHandler = new BackgroundQueryHandler(this.getContentResolver());
|
|
|
mCurrentFolderId = Notes.ID_ROOT_FOLDER;
|
|
|
mNotesListView = (ListView) findViewById(R.id.notes_list);
|
|
|
mNotesListView.addFooterView(LayoutInflater.from(this).inflate(R.layout.note_list_footer, null),
|
|
|
null, false);
|
|
|
mNotesListView.setOnItemClickListener(new OnListItemClickListener());
|
|
|
mNotesListView.setOnItemLongClickListener(this);
|
|
|
mNotesListAdapter = new NotesListAdapter(this);
|
|
|
mNotesListView.setAdapter(mNotesListAdapter);
|
|
|
mAddNewNote = (Button) findViewById(R.id.btn_new_note);
|
|
|
mAddNewNote.setOnClickListener(this);
|
|
|
mAddNewNote.setOnTouchListener(new NewNoteOnTouchListener());
|
|
|
mDispatch = false;
|
|
|
mDispatchY = 0;
|
|
|
mOriginY = 0;
|
|
|
mTitleBar = (TextView) findViewById(R.id.tv_title_bar);
|
|
|
mState = ListEditState.NOTE_LIST;
|
|
|
mModeCallBack = new ModeCallback();
|
|
|
}
|
|
|
|
|
|
// ModeCallback 类实现了 MultiChoiceModeListener 和 OnMenuItemClickListener
|
|
|
// 用于支持 ListView 的多选模式以及自定义菜单的行为
|
|
|
private class ModeCallback implements ListView.MultiChoiceModeListener, OnMenuItemClickListener {
|
|
|
private DropdownMenu mDropDownMenu; // 定义下拉菜单
|
|
|
private ActionMode mActionMode; // 当前的 ActionMode
|
|
|
private MenuItem mMoveMenu; // 移动菜单项
|
|
|
|
|
|
// 当启动 ActionMode 时触发
|
|
|
public boolean onCreateActionMode(ActionMode mode, Menu menu) {
|
|
|
// 向菜单中添加项（通过菜单资源文件）
|
|
|
getMenuInflater().inflate(R.menu.note_list_options, menu);
|
|
|
|
|
|
// 获取删除菜单项并设置点击监听器
|
|
|
menu.findItem(R.id.delete).setOnMenuItemClickListener(this);
|
|
|
|
|
|
// 获取移动菜单项
|
|
|
mMoveMenu = menu.findItem(R.id.move);
|
|
|
|
|
|
// 根据条件来决定是否显示移动菜单项
|
|
|
if (mFocusNoteDataItem.getParentId() == Notes.ID_CALL_RECORD_FOLDER
|
|
|
|| DataUtils.getUserFolderCount(mContentResolver) == 0) {
|
|
|
// 如果当前选中的笔记是通话记录文件夹，或者用户没有文件夹，则隐藏移动菜单项
|
|
|
mMoveMenu.setVisible(false);
|
|
|
} else {
|
|
|
// 否则显示并设置点击事件
|
|
|
mMoveMenu.setVisible(true);
|
|
|
mMoveMenu.setOnMenuItemClickListener(this);
|
|
|
}
|
|
|
|
|
|
// 设置 ActionMode 实例
|
|
|
mActionMode = mode;
|
|
|
|
|
|
// 设置 ListView 为多选模式
|
|
|
mNotesListAdapter.setChoiceMode(true);
|
|
|
|
|
|
// 禁止长按列表项时触发点击事件
|
|
|
mNotesListView.setLongClickable(false);
|
|
|
|
|
|
// 隐藏“新建笔记”按钮
|
|
|
mAddNewNote.setVisibility(View.GONE);
|
|
|
|
|
|
// 加载自定义视图到 ActionMode 中
|
|
|
View customView = LayoutInflater.from(NotesListActivity.this).inflate(
|
|
|
R.layout.note_list_dropdown_menu, null);
|
|
|
mode.setCustomView(customView);
|
|
|
|
|
|
// 初始化下拉菜单并设置点击事件
|
|
|
mDropDownMenu = new DropdownMenu(NotesListActivity.this,
|
|
|
(Button) customView.findViewById(R.id.selection_menu),
|
|
|
R.menu.note_list_dropdown);
|
|
|
mDropDownMenu.setOnDropdownMenuItemClickListener(new PopupMenu.OnMenuItemClickListener() {
|
|
|
public boolean onMenuItemClick(MenuItem item) {
|
|
|
// 切换选择所有或取消选择所有笔记
|
|
|
mNotesListAdapter.selectAll(!mNotesListAdapter.isAllSelected());
|
|
|
updateMenu(); // 更新菜单
|
|
|
return true;
|
|
|
}
|
|
|
});
|
|
|
|
|
|
// 返回 true 表示成功创建了 ActionMode
|
|
|
return true;
|
|
|
}
|
|
|
|
|
|
// 用于更新下拉菜单中的选择状态
|
|
|
private void updateMenu() {
|
|
|
int selectedCount = mNotesListAdapter.getSelectedCount(); // 获取当前选择的笔记数量
|
|
|
|
|
|
// 更新下拉菜单的标题
|
|
|
String format = getResources().getString(R.string.menu_select_title, selectedCount);
|
|
|
mDropDownMenu.setTitle(format);
|
|
|
|
|
|
// 更新“选择全部”菜单项的状态
|
|
|
MenuItem item = mDropDownMenu.findItem(R.id.action_select_all);
|
|
|
if (item != null) {
|
|
|
if (mNotesListAdapter.isAllSelected()) {
|
|
|
// 如果所有笔记都已选择，显示“取消选择所有”
|
|
|
item.setChecked(true);
|
|
|
item.setTitle(R.string.menu_deselect_all);
|
|
|
} else {
|
|
|
// 否则显示“选择全部”
|
|
|
item.setChecked(false);
|
|
|
item.setTitle(R.string.menu_select_all);
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
|
|
|
|
|
|
public boolean onPrepareActionMode(ActionMode mode, Menu menu) {
|
|
|
// TODO Auto-generated method stub
|
|
|
return false;
|
|
|
}
|
|
|
|
|
|
public boolean onActionItemClicked(ActionMode mode, MenuItem item) {
|
|
|
// TODO Auto-generated method stub
|
|
|
return false;
|
|
|
}
|
|
|
|
|
|
public void onDestroyActionMode(ActionMode mode) {
|
|
|
// 退出 ActionMode 时，禁用选择模式，并恢复原有状态。
|
|
|
mNotesListAdapter.setChoiceMode(false); // 禁用适配器中的选择模式（即禁用多选）
|
|
|
mNotesListView.setLongClickable(true); // 使 ListView 恢复长按事件的响应
|
|
|
mAddNewNote.setVisibility(View.VISIBLE); // 恢复显示“添加新笔记”按钮
|
|
|
}
|
|
|
|
|
|
public void finishActionMode() {
|
|
|
// 结束当前的 ActionMode，通常是在完成操作后调用
|
|
|
mActionMode.finish(); // 调用 ActionMode 的 finish 方法来结束当前操作模式
|
|
|
}
|
|
|
|
|
|
public void onItemCheckedStateChanged(ActionMode mode, int position, long id,
|
|
|
boolean checked) {
|
|
|
// 在用户选中或取消选择某项时调用
|
|
|
mNotesListAdapter.setCheckedItem(position, checked); // 更新适配器中选项的选中状态
|
|
|
updateMenu(); // 更新菜单项（例如更新删除或移动按钮的状态）
|
|
|
}
|
|
|
|
|
|
public boolean onMenuItemClick(MenuItem item) {
|
|
|
// 当用户点击 ActionMode 菜单中的某项时调用
|
|
|
if (mNotesListAdapter.getSelectedCount() == 0) {
|
|
|
// 如果没有任何项被选中，显示提示消息
|
|
|
Toast.makeText(NotesListActivity.this, getString(R.string.menu_select_none),
|
|
|
Toast.LENGTH_SHORT).show();
|
|
|
return true; // 消费该事件
|
|
|
}
|
|
|
|
|
|
// 处理菜单项点击事件
|
|
|
switch (item.getItemId()) {
|
|
|
case R.id.delete:
|
|
|
// 用户选择删除
|
|
|
AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
|
|
|
builder.setTitle(getString(R.string.alert_title_delete)) // 设置对话框标题
|
|
|
.setIcon(android.R.drawable.ic_dialog_alert) // 设置对话框图标
|
|
|
.setMessage(getString(R.string.alert_message_delete_notes,
|
|
|
mNotesListAdapter.getSelectedCount())) // 设置删除提示信息，显示选中项的数量
|
|
|
.setPositiveButton(android.R.string.ok, new DialogInterface.OnClickListener() {
|
|
|
public void onClick(DialogInterface dialog, int which) {
|
|
|
batchDelete(); // 执行批量删除操作
|
|
|
}
|
|
|
})
|
|
|
.setNegativeButton(android.R.string.cancel, null) // 取消按钮
|
|
|
.show(); // 显示对话框
|
|
|
break;
|
|
|
case R.id.move:
|
|
|
// 用户选择移动
|
|
|
startQueryDestinationFolders(); // 启动查询目标文件夹的操作
|
|
|
break;
|
|
|
default:
|
|
|
return false; // 其他菜单项，返回 false，不处理
|
|
|
}
|
|
|
return true; // 表示该事件已被处理
|
|
|
}
|
|
|
}
|
|
|
private class NewNoteOnTouchListener implements OnTouchListener {
|
|
|
|
|
|
public boolean onTouch(View v, MotionEvent event) {
|
|
|
switch (event.getAction()) {
|
|
|
case MotionEvent.ACTION_DOWN: {
|
|
|
Display display = getWindowManager().getDefaultDisplay();
|
|
|
int screenHeight = display.getHeight();
|
|
|
int newNoteViewHeight = mAddNewNote.getHeight();
|
|
|
int start = screenHeight - newNoteViewHeight;
|
|
|
int eventY = start + (int) event.getY();
|
|
|
/**
|
|
|
* Minus TitleBar's height
|
|
|
*/
|
|
|
if (mState == ListEditState.SUB_FOLDER) {
|
|
|
eventY -= mTitleBar.getHeight();
|
|
|
start -= mTitleBar.getHeight();
|
|
|
}
|
|
|
/**
|
|
|
* HACKME:When click the transparent part of "New Note" button, dispatch
|
|
|
* the event to the list view behind this button. The transparent part of
|
|
|
* "New Note" button could be expressed by formula y=-0.12x+94（Unit:pixel）
|
|
|
* and the line top of the button. The coordinate based on left of the "New
|
|
|
* Note" button. The 94 represents maximum height of the transparent part.
|
|
|
* Notice that, if the background of the button changes, the formula should
|
|
|
* also change. This is very bad, just for the UI designer's strong requirement.
|
|
|
*/
|
|
|
if (event.getY() < (event.getX() * (-0.12) + 94)) {
|
|
|
View view = mNotesListView.getChildAt(mNotesListView.getChildCount() - 1
|
|
|
- mNotesListView.getFooterViewsCount());
|
|
|
if (view != null && view.getBottom() > start
|
|
|
&& (view.getTop() < (start + 94))) {
|
|
|
mOriginY = (int) event.getY();
|
|
|
mDispatchY = eventY;
|
|
|
event.setLocation(event.getX(), mDispatchY);
|
|
|
mDispatch = true;
|
|
|
return mNotesListView.dispatchTouchEvent(event);
|
|
|
}
|
|
|
}
|
|
|
break;
|
|
|
}
|
|
|
case MotionEvent.ACTION_MOVE: {
|
|
|
if (mDispatch) {
|
|
|
mDispatchY += (int) event.getY() - mOriginY;
|
|
|
event.setLocation(event.getX(), mDispatchY);
|
|
|
return mNotesListView.dispatchTouchEvent(event);
|
|
|
}
|
|
|
break;
|
|
|
}
|
|
|
default: {
|
|
|
if (mDispatch) {
|
|
|
event.setLocation(event.getX(), mDispatchY);
|
|
|
mDispatch = false;
|
|
|
return mNotesListView.dispatchTouchEvent(event);
|
|
|
}
|
|
|
break;
|
|
|
}
|
|
|
}
|
|
|
return false;
|
|
|
}
|
|
|
|
|
|
};
|
|
|
|
|
|
// 启动异步查询，查询当前文件夹的笔记列表
|
|
|
private void startAsyncNotesListQuery() {
|
|
|
// 根据当前文件夹ID选择查询条件
|
|
|
String selection = (mCurrentFolderId == Notes.ID_ROOT_FOLDER) ? ROOT_FOLDER_SELECTION
|
|
|
: NORMAL_SELECTION;
|
|
|
|
|
|
// 启动异步查询
|
|
|
mBackgroundQueryHandler.startQuery(FOLDER_NOTE_LIST_QUERY_TOKEN, null,
|
|
|
Notes.CONTENT_NOTE_URI, NoteItemData.PROJECTION, selection, new String[] {
|
|
|
String.valueOf(mCurrentFolderId) // 当前文件夹ID作为查询参数
|
|
|
},
|
|
|
NoteColumns.TYPE + " DESC," + NoteColumns.MODIFIED_DATE + " DESC"); // 按类型和修改日期降序排序
|
|
|
}
|
|
|
|
|
|
// 定义异步查询处理类，继承自 AsyncQueryHandler
|
|
|
private final class BackgroundQueryHandler extends AsyncQueryHandler {
|
|
|
|
|
|
// 构造方法，传入ContentResolver
|
|
|
public BackgroundQueryHandler(ContentResolver contentResolver) {
|
|
|
super(contentResolver);
|
|
|
}
|
|
|
|
|
|
// 查询完成后的回调方法
|
|
|
@Override
|
|
|
protected void onQueryComplete(int token, Object cookie, Cursor cursor) {
|
|
|
switch (token) {
|
|
|
// 如果查询的是笔记列表
|
|
|
case FOLDER_NOTE_LIST_QUERY_TOKEN:
|
|
|
// 将查询结果的Cursor设置到适配器中
|
|
|
mNotesListAdapter.changeCursor(cursor);
|
|
|
break;
|
|
|
// 如果查询的是文件夹列表
|
|
|
case FOLDER_LIST_QUERY_TOKEN:
|
|
|
if (cursor != null && cursor.getCount() > 0) {
|
|
|
// 如果查询结果有数据，显示文件夹列表
|
|
|
showFolderListMenu(cursor);
|
|
|
} else {
|
|
|
// 如果查询失败或没有数据，打印错误日志
|
|
|
Log.e(TAG, "Query folder failed");
|
|
|
}
|
|
|
break;
|
|
|
default:
|
|
|
return;
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
|
|
|
// 显示文件夹列表的弹出菜单
|
|
|
private void showFolderListMenu(Cursor cursor) {
|
|
|
// 创建AlertDialog.Builder来构建对话框
|
|
|
AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
|
|
|
builder.setTitle(R.string.menu_title_select_folder); // 设置对话框标题
|
|
|
|
|
|
// 创建一个自定义的Adapter来显示文件夹列表
|
|
|
final FoldersListAdapter adapter = new FoldersListAdapter(this, cursor);
|
|
|
|
|
|
// 设置对话框的Adapter和点击事件
|
|
|
builder.setAdapter(adapter, new DialogInterface.OnClickListener() {
|
|
|
public void onClick(DialogInterface dialog, int which) {
|
|
|
// 执行批量移动笔记到所选文件夹
|
|
|
DataUtils.batchMoveToFolder(mContentResolver,
|
|
|
mNotesListAdapter.getSelectedItemIds(), adapter.getItemId(which));
|
|
|
|
|
|
// 显示提示Toast，告知用户笔记已成功移动
|
|
|
Toast.makeText(
|
|
|
NotesListActivity.this,
|
|
|
getString(R.string.format_move_notes_to_folder,
|
|
|
mNotesListAdapter.getSelectedCount(),
|
|
|
adapter.getFolderName(NotesListActivity.this, which)),
|
|
|
Toast.LENGTH_SHORT).show();
|
|
|
|
|
|
// 结束Action Mode，取消选择模式
|
|
|
mModeCallBack.finishActionMode();
|
|
|
}
|
|
|
});
|
|
|
|
|
|
// 显示对话框
|
|
|
builder.show();
|
|
|
}
|
|
|
|
|
|
// 创建新的笔记
|
|
|
private void createNewNote() {
|
|
|
// 创建一个Intent，跳转到NoteEditActivity来编辑或插入新笔记
|
|
|
Intent intent = new Intent(this, NoteEditActivity.class);
|
|
|
intent.setAction(Intent.ACTION_INSERT_OR_EDIT); // 设置操作类型为插入或编辑
|
|
|
intent.putExtra(Notes.INTENT_EXTRA_FOLDER_ID, mCurrentFolderId); // 传递当前文件夹ID
|
|
|
this.startActivityForResult(intent, REQUEST_CODE_NEW_NODE); // 启动活动并等待结果
|
|
|
}
|
|
|
|
|
|
|
|
|
private void batchDelete() {
|
|
|
new AsyncTask<Void, Void, HashSet<AppWidgetAttribute>>() {
|
|
|
// 后台线程任务，执行批量删除操作
|
|
|
protected HashSet<AppWidgetAttribute> doInBackground(Void... unused) {
|
|
|
// 获取用户选中的小部件
|
|
|
HashSet<AppWidgetAttribute> widgets = mNotesListAdapter.getSelectedWidget();
|
|
|
|
|
|
if (!isSyncMode()) {
|
|
|
// 如果不在同步模式，直接删除选中的笔记
|
|
|
if (DataUtils.batchDeleteNotes(mContentResolver, mNotesListAdapter
|
|
|
.getSelectedItemIds())) {
|
|
|
// 删除成功
|
|
|
} else {
|
|
|
// 删除失败，打印错误日志
|
|
|
Log.e(TAG, "Delete notes error, should not happens");
|
|
|
}
|
|
|
} else {
|
|
|
// 如果在同步模式，将选中的笔记移到垃圾箱文件夹
|
|
|
if (!DataUtils.batchMoveToFolder(mContentResolver, mNotesListAdapter
|
|
|
.getSelectedItemIds(), Notes.ID_TRASH_FOLER)) {
|
|
|
// 移动到垃圾箱失败，打印错误日志
|
|
|
Log.e(TAG, "Move notes to trash folder error, should not happens");
|
|
|
}
|
|
|
}
|
|
|
// 返回小部件的集合，以便在UI线程更新
|
|
|
return widgets;
|
|
|
}
|
|
|
|
|
|
// 在后台任务执行完后更新UI
|
|
|
@Override
|
|
|
protected void onPostExecute(HashSet<AppWidgetAttribute> widgets) {
|
|
|
// 如果有小部件信息，更新相关的小部件
|
|
|
if (widgets != null) {
|
|
|
for (AppWidgetAttribute widget : widgets) {
|
|
|
// 如果小部件ID有效且类型不是无效类型，则更新小部件
|
|
|
if (widget.widgetId != AppWidgetManager.INVALID_APPWIDGET_ID
|
|
|
&& widget.widgetType != Notes.TYPE_WIDGET_INVALIDE) {
|
|
|
updateWidget(widget.widgetId, widget.widgetType);
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
// 执行完成后，结束操作模式
|
|
|
mModeCallBack.finishActionMode();
|
|
|
}
|
|
|
}.execute();
|
|
|
}
|
|
|
private void deleteFolder(long folderId) {
|
|
|
// 检查文件夹ID是否是根文件夹的ID，根文件夹不能被删除
|
|
|
if (folderId == Notes.ID_ROOT_FOLDER) {
|
|
|
Log.e(TAG, "Wrong folder id, should not happen " + folderId); // 打印错误日志
|
|
|
return; // 如果是根文件夹，返回不做任何操作
|
|
|
}
|
|
|
|
|
|
// 创建一个HashSet来保存要删除的文件夹ID
|
|
|
HashSet<Long> ids = new HashSet<Long>();
|
|
|
ids.add(folderId);
|
|
|
|
|
|
// 获取与该文件夹相关的所有小部件（AppWidget），可能有些文件夹有附加的小部件
|
|
|
HashSet<AppWidgetAttribute> widgets = DataUtils.getFolderNoteWidget(mContentResolver, folderId);
|
|
|
|
|
|
// 判断是否处于同步模式
|
|
|
if (!isSyncMode()) {
|
|
|
// 如果不在同步模式，直接删除文件夹及其内容
|
|
|
DataUtils.batchDeleteNotes(mContentResolver, ids);
|
|
|
} else {
|
|
|
// 如果在同步模式，将要删除的文件夹移动到回收站文件夹
|
|
|
DataUtils.batchMoveToFolder(mContentResolver, ids, Notes.ID_TRASH_FOLER);
|
|
|
}
|
|
|
|
|
|
// 如果该文件夹有小部件，处理这些小部件
|
|
|
if (widgets != null) {
|
|
|
// 遍历每个小部件
|
|
|
for (AppWidgetAttribute widget : widgets) {
|
|
|
// 如果小部件ID有效且小部件类型不是无效类型，则更新小部件
|
|
|
if (widget.widgetId != AppWidgetManager.INVALID_APPWIDGET_ID
|
|
|
&& widget.widgetType != Notes.TYPE_WIDGET_INVALIDE) {
|
|
|
// 更新小部件（例如：刷新其显示或者移除等操作）
|
|
|
updateWidget(widget.widgetId, widget.widgetType);
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
|
|
|
// 打开一个特定的NoteItem (笔记项)并启动NoteEditActivity
|
|
|
private void openNode(NoteItemData data) {
|
|
|
// 创建一个Intent，指定目标Activity为NoteEditActivity
|
|
|
Intent intent = new Intent(this, NoteEditActivity.class);
|
|
|
|
|
|
// 设置Intent的Action为查看 (ACTION_VIEW)
|
|
|
intent.setAction(Intent.ACTION_VIEW);
|
|
|
|
|
|
// 将NoteItem的ID作为额外数据传递到NoteEditActivity
|
|
|
intent.putExtra(Intent.EXTRA_UID, data.getId());
|
|
|
|
|
|
// 启动NoteEditActivity，并等待返回结果
|
|
|
this.startActivityForResult(intent, REQUEST_CODE_OPEN_NODE);
|
|
|
}
|
|
|
|
|
|
// 打开一个文件夹，更新当前文件夹ID并查询相关笔记
|
|
|
private void openFolder(NoteItemData data) {
|
|
|
// 更新当前文件夹ID
|
|
|
mCurrentFolderId = data.getId();
|
|
|
|
|
|
// 启动异步笔记列表查询
|
|
|
startAsyncNotesListQuery();
|
|
|
|
|
|
// 如果当前是“通话记录”文件夹，设置不同的状态和UI
|
|
|
if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {
|
|
|
mState = ListEditState.CALL_RECORD_FOLDER;
|
|
|
mAddNewNote.setVisibility(View.GONE); // 隐藏新建笔记按钮
|
|
|
} else {
|
|
|
mState = ListEditState.SUB_FOLDER;
|
|
|
}
|
|
|
|
|
|
// 根据文件夹的ID设置标题栏文字
|
|
|
if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {
|
|
|
mTitleBar.setText(R.string.call_record_folder_name);
|
|
|
} else {
|
|
|
mTitleBar.setText(data.getSnippet()); // 设置为文件夹的简介信息
|
|
|
}
|
|
|
|
|
|
// 显示标题栏
|
|
|
mTitleBar.setVisibility(View.VISIBLE);
|
|
|
}
|
|
|
|
|
|
// 处理点击事件
|
|
|
public void onClick(View v) {
|
|
|
// 根据点击的视图ID来判断不同的操作
|
|
|
switch (v.getId()) {
|
|
|
case R.id.btn_new_note: // 如果点击的是新建笔记按钮
|
|
|
createNewNote(); // 创建一个新的笔记
|
|
|
break;
|
|
|
default:
|
|
|
break;
|
|
|
}
|
|
|
}
|
|
|
|
|
|
// 显示软键盘
|
|
|
private void showSoftInput() {
|
|
|
// 获取输入法管理器服务
|
|
|
InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
|
|
|
|
|
|
// 如果输入法管理器不为空，强制显示软键盘
|
|
|
if (inputMethodManager != null) {
|
|
|
inputMethodManager.toggleSoftInput(InputMethodManager.SHOW_FORCED, 0);
|
|
|
}
|
|
|
}
|
|
|
|
|
|
// 隐藏软键盘
|
|
|
private void hideSoftInput(View view) {
|
|
|
// 获取输入法管理器服务
|
|
|
InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
|
|
|
|
|
|
// 隐藏软键盘，传递当前视图的WindowToken
|
|
|
inputMethodManager.hideSoftInputFromWindow(view.getWindowToken(), 0);
|
|
|
}
|
|
|
|
|
|
|
|
|
private void showCreateOrModifyFolderDialog(final boolean create) {
|
|
|
// 创建一个AlertDialog.Builder对象，用于构建对话框
|
|
|
final AlertDialog.Builder builder = new AlertDialog.Builder(this);
|
|
|
|
|
|
// 加载自定义的布局（dialog_edit_text），并获取其中的EditText控件
|
|
|
View view = LayoutInflater.from(this).inflate(R.layout.dialog_edit_text, null);
|
|
|
final EditText etName = (EditText) view.findViewById(R.id.et_foler_name);
|
|
|
|
|
|
// 显示软键盘，准备输入
|
|
|
showSoftInput();
|
|
|
|
|
|
// 如果不是创建文件夹（即是修改文件夹），设置EditText的文本为当前文件夹的名称
|
|
|
if (!create) {
|
|
|
if (mFocusNoteDataItem != null) {
|
|
|
etName.setText(mFocusNoteDataItem.getSnippet()); // 设置文件夹名称
|
|
|
builder.setTitle(getString(R.string.menu_folder_change_name)); // 设置标题为“修改文件夹名称”
|
|
|
} else {
|
|
|
Log.e(TAG, "The long click data item is null"); // 如果没有选中的文件夹，记录错误日志
|
|
|
return;
|
|
|
}
|
|
|
} else {
|
|
|
// 如果是创建文件夹，设置EditText为空
|
|
|
etName.setText("");
|
|
|
builder.setTitle(this.getString(R.string.menu_create_folder)); // 设置标题为“创建文件夹”
|
|
|
}
|
|
|
|
|
|
// 设置对话框的正按钮（确认按钮），但是暂时不处理点击事件
|
|
|
builder.setPositiveButton(android.R.string.ok, null);
|
|
|
|
|
|
// 设置对话框的负按钮（取消按钮），点击时隐藏软键盘
|
|
|
builder.setNegativeButton(android.R.string.cancel, new DialogInterface.OnClickListener() {
|
|
|
public void onClick(DialogInterface dialog, int which) {
|
|
|
hideSoftInput(etName); // 隐藏软键盘
|
|
|
}
|
|
|
});
|
|
|
|
|
|
// 显示对话框
|
|
|
final Dialog dialog = builder.setView(view).show();
|
|
|
|
|
|
// 获取对话框的确认按钮，并为其设置点击事件
|
|
|
final Button positive = (Button) dialog.findViewById(android.R.id.button1);
|
|
|
positive.setOnClickListener(new OnClickListener() {
|
|
|
public void onClick(View v) {
|
|
|
hideSoftInput(etName); // 隐藏软键盘
|
|
|
|
|
|
// 获取EditText中的文件夹名称
|
|
|
String name = etName.getText().toString();
|
|
|
|
|
|
// 检查文件夹名称是否已存在（DataUtils.checkVisibleFolderName方法进行检查）
|
|
|
if (DataUtils.checkVisibleFolderName(mContentResolver, name)) {
|
|
|
// 如果文件夹已存在，提示用户并清空输入框的文本
|
|
|
Toast.makeText(NotesListActivity.this, getString(R.string.folder_exist, name),
|
|
|
Toast.LENGTH_LONG).show();
|
|
|
etName.setSelection(0, etName.length()); // 将光标移到文本的开头
|
|
|
return;
|
|
|
}
|
|
|
|
|
|
// 如果是修改文件夹名称，并且输入的名称非空，则更新文件夹名称
|
|
|
if (!create) {
|
|
|
if (!TextUtils.isEmpty(name)) {
|
|
|
ContentValues values = new ContentValues();
|
|
|
values.put(NoteColumns.SNIPPET, name); // 设置新文件夹名称
|
|
|
values.put(NoteColumns.TYPE, Notes.TYPE_FOLDER); // 设置类型为文件夹
|
|
|
values.put(NoteColumns.LOCAL_MODIFIED, 1); // 标记为已修改
|
|
|
// 更新数据库中对应的文件夹项
|
|
|
mContentResolver.update(Notes.CONTENT_NOTE_URI, values, NoteColumns.ID
|
|
|
+ "=?", new String[] {
|
|
|
String.valueOf(mFocusNoteDataItem.getId()) // 使用选中的文件夹ID进行更新
|
|
|
});
|
|
|
}
|
|
|
} else if (!TextUtils.isEmpty(name)) {
|
|
|
// 如果是创建新文件夹，并且输入的名称非空，则插入新的文件夹
|
|
|
ContentValues values = new ContentValues();
|
|
|
values.put(NoteColumns.SNIPPET, name); // 设置新文件夹名称
|
|
|
values.put(NoteColumns.TYPE, Notes.TYPE_FOLDER); // 设置类型为文件夹
|
|
|
// 插入到数据库中
|
|
|
mContentResolver.insert(Notes.CONTENT_NOTE_URI, values);
|
|
|
}
|
|
|
// 关闭对话框
|
|
|
dialog.dismiss();
|
|
|
}
|
|
|
});
|
|
|
|
|
|
if (TextUtils.isEmpty(etName.getText())) {
|
|
|
positive.setEnabled(false);
|
|
|
}
|
|
|
/**
|
|
|
* When the name edit text is null, disable the positive button
|
|
|
*/
|
|
|
etName.addTextChangedListener(new TextWatcher() {
|
|
|
public void beforeTextChanged(CharSequence s, int start, int count, int after) {
|
|
|
// TODO Auto-generated method stub
|
|
|
|
|
|
}
|
|
|
|
|
|
public void onTextChanged(CharSequence s, int start, int before, int count) {
|
|
|
if (TextUtils.isEmpty(etName.getText())) {
|
|
|
positive.setEnabled(false);
|
|
|
} else {
|
|
|
positive.setEnabled(true);
|
|
|
}
|
|
|
}
|
|
|
|
|
|
public void afterTextChanged(Editable s) {
|
|
|
// TODO Auto-generated method stub
|
|
|
|
|
|
}
|
|
|
});
|
|
|
}
|
|
|
|
|
|
// 重写返回按钮的行为
|
|
|
@Override
|
|
|
public void onBackPressed() {
|
|
|
switch (mState) {
|
|
|
case SUB_FOLDER: // 当前状态为子文件夹时
|
|
|
mCurrentFolderId = Notes.ID_ROOT_FOLDER; // 返回到根文件夹
|
|
|
mState = ListEditState.NOTE_LIST; // 更新状态为笔记列表
|
|
|
startAsyncNotesListQuery(); // 异步查询笔记列表
|
|
|
mTitleBar.setVisibility(View.GONE); // 隐藏标题栏
|
|
|
break;
|
|
|
case CALL_RECORD_FOLDER: // 当前状态为通话记录文件夹时
|
|
|
mCurrentFolderId = Notes.ID_ROOT_FOLDER; // 返回到根文件夹
|
|
|
mState = ListEditState.NOTE_LIST; // 更新状态为笔记列表
|
|
|
mAddNewNote.setVisibility(View.VISIBLE); // 显示新增笔记按钮
|
|
|
mTitleBar.setVisibility(View.GONE); // 隐藏标题栏
|
|
|
startAsyncNotesListQuery(); // 异步查询笔记列表
|
|
|
break;
|
|
|
case NOTE_LIST: // 当前状态为笔记列表时
|
|
|
super.onBackPressed(); // 调用父类的返回处理逻辑
|
|
|
break;
|
|
|
default: // 其他状态不处理
|
|
|
break;
|
|
|
}
|
|
|
}
|
|
|
|
|
|
// 更新小部件的方法
|
|
|
private void updateWidget(int appWidgetId, int appWidgetType) {
|
|
|
// 创建一个更新小部件的广播意图
|
|
|
Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE);
|
|
|
|
|
|
// 根据小部件类型设置对应的小部件提供者
|
|
|
if (appWidgetType == Notes.TYPE_WIDGET_2X) {
|
|
|
intent.setClass(this, NoteWidgetProvider_2x.class); // 设置2x小部件提供者
|
|
|
} else if (appWidgetType == Notes.TYPE_WIDGET_4X) {
|
|
|
intent.setClass(this, NoteWidgetProvider_4x.class); // 设置4x小部件提供者
|
|
|
} else {
|
|
|
Log.e(TAG, "Unspported widget type"); // 如果小部件类型不支持，则记录错误日志
|
|
|
return;
|
|
|
}
|
|
|
|
|
|
// 添加小部件ID到意图中
|
|
|
intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS, new int[] {
|
|
|
appWidgetId
|
|
|
});
|
|
|
|
|
|
// 发送广播来更新小部件
|
|
|
sendBroadcast(intent);
|
|
|
// 设置返回结果为成功
|
|
|
setResult(RESULT_OK, intent);
|
|
|
}
|
|
|
|
|
|
// 创建上下文菜单监听器，用于处理文件夹长按事件
|
|
|
private final OnCreateContextMenuListener mFolderOnCreateContextMenuListener = new OnCreateContextMenuListener() {
|
|
|
public void onCreateContextMenu(ContextMenu menu, View v, ContextMenuInfo menuInfo) {
|
|
|
if (mFocusNoteDataItem != null) {
|
|
|
menu.setHeaderTitle(mFocusNoteDataItem.getSnippet()); // 设置菜单标题为当前焦点项的摘要
|
|
|
// 添加菜单项：查看、删除和修改名称
|
|
|
menu.add(0, MENU_FOLDER_VIEW, 0, R.string.menu_folder_view);
|
|
|
menu.add(0, MENU_FOLDER_DELETE, 0, R.string.menu_folder_delete);
|
|
|
menu.add(0, MENU_FOLDER_CHANGE_NAME, 0, R.string.menu_folder_change_name);
|
|
|
}
|
|
|
}
|
|
|
};
|
|
|
|
|
|
// 当上下文菜单关闭时，移除监听器并调用父类方法
|
|
|
@Override
|
|
|
public void onContextMenuClosed(Menu menu) {
|
|
|
if (mNotesListView != null) {
|
|
|
mNotesListView.setOnCreateContextMenuListener(null); // 移除菜单监听器
|
|
|
}
|
|
|
super.onContextMenuClosed(menu); // 调用父类方法
|
|
|
}
|
|
|
|
|
|
// 处理上下文菜单项被选中的事件
|
|
|
@Override
|
|
|
public boolean onContextItemSelected(MenuItem item) {
|
|
|
// 如果当前没有选中笔记项，返回false
|
|
|
if (mFocusNoteDataItem == null) {
|
|
|
Log.e(TAG, "The long click data item is null"); // 记录错误日志
|
|
|
return false;
|
|
|
}
|
|
|
|
|
|
// 根据菜单项的ID处理不同的操作
|
|
|
switch (item.getItemId()) {
|
|
|
case MENU_FOLDER_VIEW: // 查看文件夹
|
|
|
openFolder(mFocusNoteDataItem); // 打开当前焦点文件夹
|
|
|
break;
|
|
|
case MENU_FOLDER_DELETE: // 删除文件夹
|
|
|
// 创建删除文件夹的对话框
|
|
|
AlertDialog.Builder builder = new AlertDialog.Builder(this);
|
|
|
builder.setTitle(getString(R.string.alert_title_delete)); // 设置标题
|
|
|
builder.setIcon(android.R.drawable.ic_dialog_alert); // 设置图标
|
|
|
builder.setMessage(getString(R.string.alert_message_delete_folder)); // 设置删除确认信息
|
|
|
builder.setPositiveButton(android.R.string.ok, new DialogInterface.OnClickListener() {
|
|
|
public void onClick(DialogInterface dialog, int which) {
|
|
|
deleteFolder(mFocusNoteDataItem.getId()); // 删除选中的文件夹
|
|
|
}
|
|
|
});
|
|
|
builder.setNegativeButton(android.R.string.cancel, null); // 取消按钮
|
|
|
builder.show(); // 显示对话框
|
|
|
break;
|
|
|
case MENU_FOLDER_CHANGE_NAME: // 修改文件夹名称
|
|
|
showCreateOrModifyFolderDialog(false); // 显示修改文件夹名称的对话框
|
|
|
break;
|
|
|
default:
|
|
|
break;
|
|
|
}
|
|
|
|
|
|
return true;
|
|
|
}
|
|
|
|
|
|
@Override
|
|
|
public boolean onPrepareOptionsMenu(Menu menu) {
|
|
|
// 清空菜单中的所有项
|
|
|
menu.clear();
|
|
|
|
|
|
// 根据当前状态（mState）设置不同的菜单
|
|
|
if (mState == ListEditState.NOTE_LIST) {
|
|
|
// 如果当前状态是 NOTE_LIST，加载 note_list 菜单
|
|
|
getMenuInflater().inflate(R.menu.note_list, menu);
|
|
|
|
|
|
// 设置同步（sync）或者取消同步（sync_cancel）菜单项的标题
|
|
|
menu.findItem(R.id.menu_sync).setTitle(
|
|
|
GTaskSyncService.isSyncing() ? R.string.menu_sync_cancel : R.string.menu_sync);
|
|
|
} else if (mState == ListEditState.SUB_FOLDER) {
|
|
|
// 如果当前状态是 SUB_FOLDER，加载 sub_folder 菜单
|
|
|
getMenuInflater().inflate(R.menu.sub_folder, menu);
|
|
|
} else if (mState == ListEditState.CALL_RECORD_FOLDER) {
|
|
|
// 如果当前状态是 CALL_RECORD_FOLDER，加载 call_record_folder 菜单
|
|
|
getMenuInflater().inflate(R.menu.call_record_folder, menu);
|
|
|
} else {
|
|
|
// 如果状态不符合任何已知类型，打印错误日志
|
|
|
Log.e(TAG, "Wrong state:" + mState);
|
|
|
}
|
|
|
return true;
|
|
|
}
|
|
|
|
|
|
@Override
|
|
|
public boolean onOptionsItemSelected(MenuItem item) {
|
|
|
// 处理用户点击菜单项的事件
|
|
|
switch (item.getItemId()) {
|
|
|
case R.id.menu_new_folder: {
|
|
|
// 当点击 "新建文件夹" 菜单项时，显示创建或修改文件夹的对话框
|
|
|
showCreateOrModifyFolderDialog(true);
|
|
|
break;
|
|
|
}
|
|
|
case R.id.menu_export_text: {
|
|
|
// 当点击 "导出文本" 菜单项时，执行导出笔记为文本的操作
|
|
|
exportNoteToText();
|
|
|
break;
|
|
|
}
|
|
|
case R.id.menu_sync: {
|
|
|
// 当点击 "同步" 菜单项时，判断是否处于同步模式
|
|
|
if (isSyncMode()) {
|
|
|
// 如果处于同步模式，检查标题并开始或取消同步
|
|
|
if (TextUtils.equals(item.getTitle(), getString(R.string.menu_sync))) {
|
|
|
GTaskSyncService.startSync(this); // 开始同步
|
|
|
} else {
|
|
|
GTaskSyncService.cancelSync(this); // 取消同步
|
|
|
}
|
|
|
} else {
|
|
|
// 如果不处于同步模式，打开设置界面
|
|
|
startPreferenceActivity();
|
|
|
}
|
|
|
break;
|
|
|
}
|
|
|
case R.id.menu_setting: {
|
|
|
// 当点击 "设置" 菜单项时，打开设置界面
|
|
|
startPreferenceActivity();
|
|
|
break;
|
|
|
}
|
|
|
case R.id.menu_new_note: {
|
|
|
// 当点击 "新建笔记" 菜单项时，创建一个新的笔记
|
|
|
createNewNote();
|
|
|
break;
|
|
|
}
|
|
|
case R.id.menu_search:
|
|
|
// 当点击 "搜索" 菜单项时，启动搜索
|
|
|
onSearchRequested();
|
|
|
break;
|
|
|
default:
|
|
|
break;
|
|
|
}
|
|
|
return true;
|
|
|
}
|
|
|
|
|
|
@Override
|
|
|
public boolean onSearchRequested() {
|
|
|
// 启动应用内搜索界面
|
|
|
startSearch(null, false, null /* appData */, false);
|
|
|
return true;
|
|
|
}
|
|
|
|
|
|
// 导出笔记到文本文件的函数
|
|
|
private void exportNoteToText() {
|
|
|
// 获取 BackupUtils 实例
|
|
|
final BackupUtils backup = BackupUtils.getInstance(NotesListActivity.this);
|
|
|
|
|
|
// 异步任务：导出笔记
|
|
|
new AsyncTask<Void, Void, Integer>() {
|
|
|
|
|
|
// 在后台线程中执行的任务
|
|
|
@Override
|
|
|
protected Integer doInBackground(Void... unused) {
|
|
|
// 执行备份操作并返回结果状态
|
|
|
return backup.exportToText();
|
|
|
}
|
|
|
|
|
|
// 在主线程中处理任务完成后的结果
|
|
|
@Override
|
|
|
protected void onPostExecute(Integer result) {
|
|
|
// 根据不同的返回状态弹出不同的提示框
|
|
|
|
|
|
// 如果 SD 卡未挂载
|
|
|
if (result == BackupUtils.STATE_SD_CARD_UNMOUONTED) {
|
|
|
AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
|
|
|
builder.setTitle(NotesListActivity.this.getString(R.string.failed_sdcard_export)); // 设置标题
|
|
|
builder.setMessage(NotesListActivity.this.getString(R.string.error_sdcard_unmounted)); // 设置消息内容
|
|
|
builder.setPositiveButton(android.R.string.ok, null); // 设置确认按钮
|
|
|
builder.show(); // 显示提示框
|
|
|
}
|
|
|
// 如果导出成功
|
|
|
else if (result == BackupUtils.STATE_SUCCESS) {
|
|
|
AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
|
|
|
builder.setTitle(NotesListActivity.this.getString(R.string.success_sdcard_export)); // 设置标题
|
|
|
builder.setMessage(NotesListActivity.this.getString(R.string.format_exported_file_location, backup.getExportedTextFileName(), backup.getExportedTextFileDir())); // 设置消息内容，包含文件路径
|
|
|
builder.setPositiveButton(android.R.string.ok, null); // 设置确认按钮
|
|
|
builder.show(); // 显示提示框
|
|
|
}
|
|
|
// 如果发生了系统错误
|
|
|
else if (result == BackupUtils.STATE_SYSTEM_ERROR) {
|
|
|
AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
|
|
|
builder.setTitle(NotesListActivity.this.getString(R.string.failed_sdcard_export)); // 设置标题
|
|
|
builder.setMessage(NotesListActivity.this.getString(R.string.error_sdcard_export)); // 设置错误信息
|
|
|
builder.setPositiveButton(android.R.string.ok, null); // 设置确认按钮
|
|
|
builder.show(); // 显示提示框
|
|
|
}
|
|
|
}
|
|
|
|
|
|
}.execute(); // 执行异步任务
|
|
|
}
|
|
|
|
|
|
// 判断是否处于同步模式
|
|
|
private boolean isSyncMode() {
|
|
|
// 如果同步账户名称不为空，表示处于同步模式
|
|
|
return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0;
|
|
|
}
|
|
|
|
|
|
// 启动设置活动页面
|
|
|
private void startPreferenceActivity() {
|
|
|
// 获取当前活动的父活动，如果没有父活动，则使用当前活动
|
|
|
Activity from = getParent() != null ? getParent() : this;
|
|
|
// 创建 Intent，启动设置界面
|
|
|
Intent intent = new Intent(from, NotesPreferenceActivity.class);
|
|
|
// 启动活动
|
|
|
from.startActivityIfNeeded(intent, -1);
|
|
|
}
|
|
|
|
|
|
private class OnListItemClickListener implements OnItemClickListener {
|
|
|
|
|
|
// 处理列表项点击事件
|
|
|
public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
|
|
|
|
|
|
// 确保点击的视图是 NotesListItem 类型
|
|
|
if (view instanceof NotesListItem) {
|
|
|
NoteItemData item = ((NotesListItem) view).getItemData(); // 获取点击项的 NoteItemData
|
|
|
|
|
|
// 如果处于多选模式
|
|
|
if (mNotesListAdapter.isInChoiceMode()) {
|
|
|
// 如果项的类型是 Note 类型
|
|
|
if (item.getType() == Notes.TYPE_NOTE) {
|
|
|
// 计算点击项在列表中的实际位置（去除头部视图数量）
|
|
|
position = position - mNotesListView.getHeaderViewsCount();
|
|
|
// 更新项的选择状态
|
|
|
mModeCallBack.onItemCheckedStateChanged(null, position, id,
|
|
|
!mNotesListAdapter.isSelectedItem(position));
|
|
|
}
|
|
|
return; // 结束方法，避免进入后续的逻辑
|
|
|
}
|
|
|
|
|
|
// 根据当前状态进行不同的操作
|
|
|
switch (mState) {
|
|
|
case NOTE_LIST:
|
|
|
// 如果项是文件夹类型或系统类型，打开文件夹
|
|
|
if (item.getType() == Notes.TYPE_FOLDER
|
|
|
|| item.getType() == Notes.TYPE_SYSTEM) {
|
|
|
openFolder(item);
|
|
|
}
|
|
|
// 如果项是 Note 类型，打开笔记
|
|
|
else if (item.getType() == Notes.TYPE_NOTE) {
|
|
|
openNode(item);
|
|
|
} else {
|
|
|
Log.e(TAG, "Wrong note type in NOTE_LIST"); // 如果项类型不正确，输出错误日志
|
|
|
}
|
|
|
break;
|
|
|
case SUB_FOLDER:
|
|
|
case CALL_RECORD_FOLDER:
|
|
|
// 如果项是 Note 类型，打开笔记
|
|
|
if (item.getType() == Notes.TYPE_NOTE) {
|
|
|
openNode(item);
|
|
|
} else {
|
|
|
Log.e(TAG, "Wrong note type in SUB_FOLDER"); // 如果项类型不正确，输出错误日志
|
|
|
}
|
|
|
break;
|
|
|
default:
|
|
|
break; // 默认情况下不做任何事情
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
|
|
|
|
|
|
// 开始查询目标文件夹
|
|
|
private void startQueryDestinationFolders() {
|
|
|
// 设置查询条件：文件类型是文件夹且父文件夹ID不等于给定的ID，ID不等于给定的ID
|
|
|
String selection = NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>? AND " + NoteColumns.ID + "<>?";
|
|
|
|
|
|
// 根据当前状态决定是否需要添加额外的条件
|
|
|
// 如果当前状态是NOTE_LIST，则使用原始查询条件；否则，添加一个OR条件，查询ID为根文件夹的项
|
|
|
selection = (mState == ListEditState.NOTE_LIST) ? selection :
|
|
|
"(" + selection + ") OR (" + NoteColumns.ID + "=" + Notes.ID_ROOT_FOLDER + ")";
|
|
|
|
|
|
// 启动后台查询，使用FOLDER_LIST_QUERY_TOKEN标识该查询
|
|
|
mBackgroundQueryHandler.startQuery(FOLDER_LIST_QUERY_TOKEN,
|
|
|
null, // 不需要指定查询的特定ID
|
|
|
Notes.CONTENT_NOTE_URI, // 数据源URI
|
|
|
FoldersListAdapter.PROJECTION, // 查询的列
|
|
|
selection, // 查询条件
|
|
|
new String[] {
|
|
|
String.valueOf(Notes.TYPE_FOLDER), // 查询文件夹类型
|
|
|
String.valueOf(Notes.ID_TRASH_FOLER), // 查询垃圾桶文件夹
|
|
|
String.valueOf(mCurrentFolderId) // 当前文件夹ID
|
|
|
},
|
|
|
NoteColumns.MODIFIED_DATE + " DESC"); // 根据修改日期降序排列
|
|
|
}
|
|
|
|
|
|
// 处理列表项的长按事件
|
|
|
public boolean onItemLongClick(AdapterView<?> parent, View view, int position, long id) {
|
|
|
// 确保视图是NotesListItem类型
|
|
|
if (view instanceof NotesListItem) {
|
|
|
mFocusNoteDataItem = ((NotesListItem) view).getItemData(); // 获取长按项的数据
|
|
|
|
|
|
// 判断长按的项是否为笔记类型且没有进入选择模式
|
|
|
if (mFocusNoteDataItem.getType() == Notes.TYPE_NOTE && !mNotesListAdapter.isInChoiceMode()) {
|
|
|
// 启动操作模式（ActionMode），该模式用于管理选中的项
|
|
|
if (mNotesListView.startActionMode(mModeCallBack) != null) {
|
|
|
// 在选择模式中选择当前项
|
|
|
mModeCallBack.onItemCheckedStateChanged(null, position, id, true);
|
|
|
|
|
|
// 反馈给用户，表示长按事件发生
|
|
|
mNotesListView.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS);
|
|
|
} else {
|
|
|
// 如果启动ActionMode失败，打印错误日志
|
|
|
Log.e(TAG, "startActionMode fails");
|
|
|
}
|
|
|
}
|
|
|
// 判断长按的项是否为文件夹类型
|
|
|
else if (mFocusNoteDataItem.getType() == Notes.TYPE_FOLDER) {
|
|
|
// 设置文件夹的上下文菜单监听器
|
|
|
mNotesListView.setOnCreateContextMenuListener(mFolderOnCreateContextMenuListener);
|
|
|
}
|
|
|
}
|
|
|
// 返回false表示该事件没有完全处理，交由其他事件处理器继续处理
|
|
|
return false;
|
|
|
}
|
|
|
} |
