You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
qw1-notes/java/net/micode/notes/ui/NoteEditActivity.java

1305 lines
62 KiB

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

/*
* 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.
*/
// 导入包声明,指定该类所在的包为 net.micode.notes.ui
package net.micode.notes.ui;
// 导入 Android 活动类,用于创建和管理活动
import android.app.Activity;
// 导入 Android 闹钟管理类,用于设置和取消闹钟提醒
import android.app.AlarmManager;
// 导入 Android 警告对话框类,用于显示警告信息和获取用户确认
import android.app.AlertDialog;
// 导入 Android 待处理意图类,用于在未来某个时间执行特定操作
import android.app.PendingIntent;
// 导入 Android 搜索管理类,用于处理搜索相关操作
import android.app.SearchManager;
// 导入 Android 小部件管理类,用于管理和更新小部件
import android.appwidget.AppWidgetManager;
// 导入 Android 内容 URI 工具类,用于处理内容提供者的 URI
import android.content.ContentUris;
// 导入 Android 上下文类,用于获取应用程序的全局信息
import android.content.Context;
// 导入 Android 对话框接口,用于处理对话框的点击事件
import android.content.DialogInterface;
// 导入 Android 意图类,用于在不同组件之间传递消息和启动活动
import android.content.Intent;
// 导入 Android 共享偏好类,用于存储和读取应用程序的偏好设置
import android.content.SharedPreferences;
// 导入 Android 画笔类,用于绘制文本和图形
import android.graphics.Paint;
// 导入 Android 捆绑类,用于在活动之间传递数据
import android.os.Bundle;
// 导入 Android 偏好管理类,用于获取默认的共享偏好设置
import android.preference.PreferenceManager;
// 导入 Android 可扩展文本类,用于处理富文本
import android.text.Spannable;
// 导入 Android 可扩展字符串类,用于创建可扩展的字符串
import android.text.SpannableString;
// 导入 Android 文本工具类,用于处理文本的空值检查等操作
import android.text.TextUtils;
// 导入 Android 日期工具类,用于格式化日期和时间
import android.text.format.DateUtils;
// 导入 Android 背景颜色跨度类,用于设置文本的背景颜色
import android.text.style.BackgroundColorSpan;
// 导入 Android 日志类,用于记录应用程序的运行信息
import android.util.Log;
// 导入 Android 布局加载器类,用于加载布局文件
import android.view.LayoutInflater;
// 导入 Android 菜单类,用于创建和管理菜单
import android.view.Menu;
// 导入 Android 菜单项类,用于表示菜单中的单个项目
import android.view.MenuItem;
// 导入 Android 触摸事件类,用于处理触摸屏幕的事件
import android.view.MotionEvent;
// 导入 Android 视图类,是所有视图的基类
import android.view.View;
// 导入 Android 点击监听器接口,用于处理视图的点击事件
import android.view.View.OnClickListener;
// 导入 Android 窗口管理器类,用于管理窗口的属性和行为
import android.view.WindowManager;
// 导入 Android 复选框类,用于创建复选框控件
import android.widget.CheckBox;
// 导入 Android 复合按钮类,是复选框等按钮的基类
import android.widget.CompoundButton;
// 导入 Android 复选框状态改变监听器接口,用于处理复选框状态改变事件
import android.widget.CompoundButton.OnCheckedChangeListener;
// 导入 Android 编辑文本类,用于创建可编辑的文本框
import android.widget.EditText;
// 导入 Android 图像视图类,用于显示图像
import android.widget.ImageView;
// 导入 Android 线性布局类,用于按照线性方向排列子视图
import android.widget.LinearLayout;
// 导入 Android 文本视图类,用于显示文本
import android.widget.TextView;
// 导入 Android 吐司类,用于显示短暂的提示信息
import android.widget.Toast;
// 导入应用程序的资源类,用于获取应用程序的资源
import net.micode.notes.R;
// 导入应用程序的数据类,用于处理笔记数据
import net.micode.notes.data.Notes;
// 导入应用程序的文本笔记类,用于处理文本笔记的相关操作
import net.micode.notes.data.Notes.TextNote;
// 导入应用程序的工作笔记类,用于管理当前正在编辑的笔记
import net.micode.notes.model.WorkingNote;
// 导入应用程序的笔记设置改变监听器接口,用于处理笔记设置的改变事件
import net.micode.notes.model.WorkingNote.NoteSettingChangedListener;
// 导入应用程序的数据工具类,用于处理数据的增删改查等操作
import net.micode.notes.tool.DataUtils;
// 导入应用程序的资源解析类,用于解析应用程序的资源
import net.micode.notes.tool.ResourceParser;
// 导入应用程序的文本外观资源类,用于获取文本的外观资源
import net.micode.notes.tool.ResourceParser.TextAppearanceResources;
// 导入应用程序的日期时间选择对话框监听器接口,用于处理日期时间选择事件
import net.micode.notes.ui.DateTimePickerDialog.OnDateTimeSetListener;
// 导入应用程序的笔记编辑文本监听器接口,用于处理笔记编辑文本的改变事件
import net.micode.notes.ui.NoteEditText.OnTextViewChangeListener;
// 导入应用程序的 2x 小部件提供者类,用于更新 2x 大小的小部件
import net.micode.notes.widget.NoteWidgetProvider_2x;
// 导入应用程序的 4x 小部件提供者类,用于更新 4x 大小的小部件
import net.micode.notes.widget.NoteWidgetProvider_4x;
// 导入 Java 的哈希映射类,用于存储键值对
import java.util.HashMap;
// 导入 Java 的哈希集合类,用于存储不重复的元素
import java.util.HashSet;
// 导入 Java 的映射接口,是哈希映射等类的父接口
import java.util.Map;
// 导入 Java 的正则表达式匹配器类,用于匹配正则表达式
import java.util.regex.Matcher;
// 导入 Java 的正则表达式模式类,用于编译正则表达式
import java.util.regex.Pattern;
// 定义 NoteEditActivity 类,继承自 Activity 类,并实现 OnClickListener、NoteSettingChangedListener 和 OnTextViewChangeListener 接口
public class NoteEditActivity extends Activity implements OnClickListener,
NoteSettingChangedListener, OnTextViewChangeListener {
// 定义内部类 HeadViewHolder用于存储笔记头部视图的控件引用
private class HeadViewHolder {
// 声明用于显示修改日期的文本视图
public TextView tvModified;
// 声明用于显示提醒图标的图像视图
public ImageView ivAlertIcon;
// 声明用于显示提醒日期的文本视图
public TextView tvAlertDate;
// 声明用于设置背景颜色的按钮图像视图
public ImageView ibSetBgColor;
}
// 定义静态的哈希映射,用于存储背景选择按钮 ID 与对应的背景颜色资源 ID 的映射关系
private static final Map<Integer, Integer> sBgSelectorBtnsMap = new HashMap<Integer, Integer>();
static {
// 将黄色背景选择按钮 ID 与黄色背景颜色资源 ID 关联
sBgSelectorBtnsMap.put(R.id.iv_bg_yellow, ResourceParser.YELLOW);
// 将红色背景选择按钮 ID 与红色背景颜色资源 ID 关联
sBgSelectorBtnsMap.put(R.id.iv_bg_red, ResourceParser.RED);
// 将蓝色背景选择按钮 ID 与蓝色背景颜色资源 ID 关联
sBgSelectorBtnsMap.put(R.id.iv_bg_blue, ResourceParser.BLUE);
// 将绿色背景选择按钮 ID 与绿色背景颜色资源 ID 关联
sBgSelectorBtnsMap.put(R.id.iv_bg_green, ResourceParser.GREEN);
// 将白色背景选择按钮 ID 与白色背景颜色资源 ID 关联
sBgSelectorBtnsMap.put(R.id.iv_bg_white, ResourceParser.WHITE);
}
// 定义静态的哈希映射,用于存储背景颜色资源 ID 与对应的背景选择状态图标 ID 的映射关系
private static final Map<Integer, Integer> sBgSelectorSelectionMap = new HashMap<Integer, Integer>();
static {
// 将黄色背景颜色资源 ID 与黄色背景选择状态图标 ID 关联
sBgSelectorSelectionMap.put(ResourceParser.YELLOW, R.id.iv_bg_yellow_select);
// 将红色背景颜色资源 ID 与红色背景选择状态图标 ID 关联
sBgSelectorSelectionMap.put(ResourceParser.RED, R.id.iv_bg_red_select);
// 将蓝色背景颜色资源 ID 与蓝色背景选择状态图标 ID 关联
sBgSelectorSelectionMap.put(ResourceParser.BLUE, R.id.iv_bg_blue_select);
// 将绿色背景颜色资源 ID 与绿色背景选择状态图标 ID 关联
sBgSelectorSelectionMap.put(ResourceParser.GREEN, R.id.iv_bg_green_select);
// 将白色背景颜色资源 ID 与白色背景选择状态图标 ID 关联
sBgSelectorSelectionMap.put(ResourceParser.WHITE, R.id.iv_bg_white_select);
}
// 定义静态的哈希映射,用于存储字体大小选择按钮 ID 与对应的字体大小资源 ID 的映射关系
private static final Map<Integer, Integer> sFontSizeBtnsMap = new HashMap<Integer, Integer>();
static {
// 将大字体选择按钮 ID 与大字体资源 ID 关联
sFontSizeBtnsMap.put(R.id.ll_font_large, ResourceParser.TEXT_LARGE);
// 将小字体选择按钮 ID 与小字体资源 ID 关联
sFontSizeBtnsMap.put(R.id.ll_font_small, ResourceParser.TEXT_SMALL);
// 将正常字体选择按钮 ID 与正常字体资源 ID 关联
sFontSizeBtnsMap.put(R.id.ll_font_normal, ResourceParser.TEXT_MEDIUM);
// 将超大字体选择按钮 ID 与超大字体资源 ID 关联
sFontSizeBtnsMap.put(R.id.ll_font_super, ResourceParser.TEXT_SUPER);
}
// 定义静态的哈希映射,用于存储字体大小资源 ID 与对应的字体选择状态图标 ID 的映射关系
private static final Map<Integer, Integer> sFontSelectorSelectionMap = new HashMap<Integer, Integer>();
static {
// 将大字体资源 ID 与大字体选择状态图标 ID 关联
sFontSelectorSelectionMap.put(ResourceParser.TEXT_LARGE, R.id.iv_large_select);
// 将小字体资源 ID 与小字体选择状态图标 ID 关联
sFontSelectorSelectionMap.put(ResourceParser.TEXT_SMALL, R.id.iv_small_select);
// 将正常字体资源 ID 与正常字体选择状态图标 ID 关联
sFontSelectorSelectionMap.put(ResourceParser.TEXT_MEDIUM, R.id.iv_medium_select);
// 将超大字体资源 ID 与超大字体选择状态图标 ID 关联
sFontSelectorSelectionMap.put(ResourceParser.TEXT_SUPER, R.id.iv_super_select);
}
// 定义日志标签,用于标识该类的日志信息
private static final String TAG = "NoteEditActivity";
// 声明头部视图持有者对象,用于存储笔记头部视图的控件引用
private HeadViewHolder mNoteHeaderHolder;
// 声明笔记头部视图面板对象,用于表示笔记头部的视图容器
private View mHeadViewPanel;
// 声明笔记背景颜色选择器视图对象,用于显示背景颜色选择界面
private View mNoteBgColorSelector;
// 声明字体大小选择器视图对象,用于显示字体大小选择界面
private View mFontSizeSelector;
// 声明笔记编辑器编辑文本对象,用于用户输入和编辑笔记内容
private EditText mNoteEditor;
// 声明笔记编辑器面板视图对象,用于表示笔记编辑器的视图容器
private View mNoteEditorPanel;
// 声明工作笔记对象,用于管理当前正在编辑的笔记
private WorkingNote mWorkingNote;
// 声明共享偏好对象,用于存储和读取应用程序的偏好设置
private SharedPreferences mSharedPrefs;
// 声明字体大小资源 ID 变量,用于存储当前选择的字体大小资源 ID
private int mFontSizeId;
// 定义共享偏好中存储字体大小的键名
private static final String PREFERENCE_FONT_SIZE = "pref_font_size";
// 定义快捷图标标题的最大长度
private static final int SHORTCUT_ICON_TITLE_MAX_LEN = 10;
// 定义已勾选标记的字符串
public static final String TAG_CHECKED = String.valueOf('\u221A');
// 定义未勾选标记的字符串
public static final String TAG_UNCHECKED = String.valueOf('\u25A1');
// 声明用于显示编辑文本列表的线性布局对象
private LinearLayout mEditTextList;
// 声明用户查询字符串变量,用于存储用户的搜索查询内容
private String mUserQuery;
// 声明正则表达式模式对象,用于匹配用户查询的内容
private Pattern mPattern;
// 重写 Activity 的 onCreate 方法,在活动创建时调用
@Override
protected void onCreate(Bundle savedInstanceState) {
// 调用父类的 onCreate 方法
super.onCreate(savedInstanceState);
// 设置当前活动的布局为 note_edit.xml
this.setContentView(R.layout.note_edit);
// 如果 savedInstanceState 为空且初始化活动状态失败,则结束当前活动
if (savedInstanceState == null && !initActivityState(getIntent())) {
finish();
return;
}
// 初始化资源
initResources();
}
/**
* Current activity may be killed when the memory is low. Once it is killed, for another time
* user load this activity, we should restore the former state
*/
// 重写 Activity 的 onRestoreInstanceState 方法,在活动恢复状态时调用
@Override
protected void onRestoreInstanceState(Bundle savedInstanceState) {
// 调用父类的 onRestoreInstanceState 方法
super.onRestoreInstanceState(savedInstanceState);
// 如果 savedInstanceState 不为空且包含 Intent.EXTRA_UID 键
if (savedInstanceState != null && savedInstanceState.containsKey(Intent.EXTRA_UID)) {
// 创建一个新的 Intent用于查看笔记
Intent intent = new Intent(Intent.ACTION_VIEW);
// 将 savedInstanceState 中的笔记 ID 放入 Intent 中
intent.putExtra(Intent.EXTRA_UID, savedInstanceState.getLong(Intent.EXTRA_UID));
// 初始化活动状态,如果失败则结束当前活动
if (!initActivityState(intent)) {
finish();
return;
}
// 记录日志,表示从被杀死的活动中恢复
Log.d(TAG, "Restoring from killed activity");
}
}
// 初始化活动状态的方法,根据传入的 Intent 初始化工作笔记
private boolean initActivityState(Intent intent) {
/**
* If the user specified the {@link Intent#ACTION_VIEW} but not provided with id,
* then jump to the NotesListActivity
*/
// 初始化工作笔记为 null
mWorkingNote = null;
// 如果 Intent 的动作为 ACTION_VIEW
if (TextUtils.equals(Intent.ACTION_VIEW, intent.getAction())) {
// 从 Intent 中获取笔记 ID默认为 0
long noteId = intent.getLongExtra(Intent.EXTRA_UID, 0);
// 初始化用户查询字符串为空
mUserQuery = "";
/**
* Starting from the searched result
*/
// 如果 Intent 包含搜索结果的额外数据
if (intent.hasExtra(SearchManager.EXTRA_DATA_KEY)) {
// 从 Intent 中获取笔记 ID
noteId = Long.parseLong(intent.getStringExtra(SearchManager.EXTRA_DATA_KEY));
// 从 Intent 中获取用户查询字符串
mUserQuery = intent.getStringExtra(SearchManager.USER_QUERY);
}
// 检查笔记是否在数据库中可见,如果不可见则跳转到笔记列表活动并显示错误信息
if (!DataUtils.visibleInNoteDatabase(getContentResolver(), noteId, Notes.TYPE_NOTE)) {
Intent jump = new Intent(this, NotesListActivity.class);
startActivity(jump);
showToast(R.string.error_note_not_exist);
finish();
return false;
} else {
// 加载工作笔记,如果加载失败则结束当前活动
mWorkingNote = WorkingNote.load(this, noteId);
if (mWorkingNote == null) {
Log.e(TAG, "load note failed with note id" + noteId);
finish();
return false;
}
}
// 设置软键盘的显示模式
getWindow().setSoftInputMode(
WindowManager.LayoutParams.SOFT_INPUT_STATE_HIDDEN
| WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE);
} else if(TextUtils.equals(Intent.ACTION_INSERT_OR_EDIT, intent.getAction())) {
// 如果 Intent 的动作为 ACTION_INSERT_OR_EDIT创建新笔记
// 从 Intent 中获取文件夹 ID默认为 0
long folderId = intent.getLongExtra(Notes.INTENT_EXTRA_FOLDER_ID, 0);
// 从 Intent 中获取小部件 ID默认为无效值
int widgetId = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_ID,
AppWidgetManager.INVALID_APPWIDGET_ID);
// 从 Intent 中获取小部件类型,默认为无效类型
int widgetType = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_TYPE,
Notes.TYPE_WIDGET_INVALIDE);
// 从 Intent 中获取背景资源 ID默认为默认背景资源 ID
int bgResId = intent.getIntExtra(Notes.INTENT_EXTRA_BACKGROUND_ID,
ResourceParser.getDefaultBgId(this));
// Parse call-record note
// 从 Intent 中获取电话号码
String phoneNumber = intent.getStringExtra(Intent.EXTRA_PHONE_NUMBER);
// 从 Intent 中获取通话日期
long callDate = intent.getLongExtra(Notes.INTENT_EXTRA_CALL_DATE, 0);
// 如果通话日期不为 0 且电话号码不为空
if (callDate != 0 && phoneNumber != null) {
// 如果电话号码为空,记录警告信息
if (TextUtils.isEmpty(phoneNumber)) {
Log.w(TAG, "The call record number is null");
}
// 初始化笔记 ID 为 0
long noteId = 0;
// 根据电话号码和通话日期从数据库中获取笔记 ID
if ((noteId = DataUtils.getNoteIdByPhoneNumberAndCallDate(getContentResolver(),
phoneNumber, callDate)) > 0) {
// 加载工作笔记,如果加载失败则结束当前活动
mWorkingNote = WorkingNote.load(this, noteId);
if (mWorkingNote == null) {
Log.e(TAG, "load call note failed with note id" + noteId);
finish();
return false;
}
} else {
// 创建空的工作笔记并转换为通话记录笔记
mWorkingNote = WorkingNote.createEmptyNote(this, folderId, widgetId,
widgetType, bgResId);
mWorkingNote.convertToCallNote(phoneNumber, callDate);
}
} else {
// 创建空的工作笔记
mWorkingNote = WorkingNote.createEmptyNote(this, folderId, widgetId, widgetType,
bgResId);
}
// 设置软键盘的显示模式
getWindow().setSoftInputMode(
WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE
| WindowManager.LayoutParams.SOFT_INPUT_STATE_VISIBLE);
} else {
// 如果 Intent 未指定有效动作,记录错误信息并结束当前活动
Log.e(TAG, "Intent not specified action, should not support");
finish();
return false;
}
// 设置工作笔记的设置状态改变监听器
mWorkingNote.setOnSettingStatusChangedListener(this);
return true;
}
// 重写 Activity 的 onResume 方法,在活动恢复到前台时调用
@Override
protected void onResume() {
// 调用父类的 onResume 方法
super.onResume();
// 初始化笔记屏幕
initNoteScreen();
}
// 初始化笔记屏幕的方法,设置笔记编辑器的文本外观、内容和背景等
private void initNoteScreen() {
// 设置笔记编辑器的文本外观
mNoteEditor.setTextAppearance(this, TextAppearanceResources
.getTexAppearanceResource(mFontSizeId));
// 如果工作笔记处于复选列表模式
if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {
// 切换到列表模式并显示笔记内容
switchToListMode(mWorkingNote.getContent());
} else {
// 设置笔记编辑器的文本并高亮显示查询结果
mNoteEditor.setText(getHighlightQueryResult(mWorkingNote.getContent(), mUserQuery));
// 将光标移动到文本末尾
mNoteEditor.setSelection(mNoteEditor.getText().length());
}
// 隐藏所有背景选择状态图标
for (Integer id : sBgSelectorSelectionMap.keySet()) {
findViewById(sBgSelectorSelectionMap.get(id)).setVisibility(View.GONE);
}
// 设置笔记头部视图面板的背景资源
mHeadViewPanel.setBackgroundResource(mWorkingNote.getTitleBgResId());
// 设置笔记编辑器面板的背景资源
mNoteEditorPanel.setBackgroundResource(mWorkingNote.getBgColorResId());
// 设置笔记修改日期的显示文本
mNoteHeaderHolder.tvModified.setText(DateUtils.formatDateTime(this,
mWorkingNote.getModifiedDate(), DateUtils.FORMAT_SHOW_DATE
| DateUtils.FORMAT_NUMERIC_DATE | DateUtils.FORMAT_SHOW_TIME
| DateUtils.FORMAT_SHOW_YEAR));
/**
* TODO: Add the menu for setting alert. Currently disable it because the DateTimePicker
* is not ready
*/
// 显示提醒头部信息
showAlertHeader();
}
// 显示提醒头部信息的方法,根据工作笔记的提醒状态显示提醒图标和日期
private void showAlertHeader() {
// 如果工作笔记有闹钟提醒
if (mWorkingNote.hasClockAlert()) {
// 获取当前时间
long time = System.currentTimeMillis();
// 如果当前时间大于提醒日期
if (time > mWorkingNote.getAlertDate()) {
// 设置提醒日期文本为过期提示
mNoteHeaderHolder.tvAlertDate.setText(R.string.note_alert_expired);
} else {
// 设置提醒日期文本为相对时间
mNoteHeaderHolder.tvAlertDate.setText(DateUtils.getRelativeTimeSpanString(
mWorkingNote.getAlertDate(), time, DateUtils.MINUTE_IN_MILLIS));
}
// 显示提醒日期文本视图
mNoteHeaderHolder.tvAlertDate.setVisibility(View.VISIBLE);
// 显示提醒图标图像视图
mNoteHeaderHolder.ivAlertIcon.setVisibility(View.VISIBLE);
} else {
// 隐藏提醒日期文本视图
mNoteHeaderHolder.tvAlertDate.setVisibility(View.GONE);
// 隐藏提醒图标图像视图
mNoteHeaderHolder.ivAlertIcon.setVisibility(View.GONE);
};
}
// 重写 Activity 的 onNewIntent 方法,在活动接收到新的 Intent 时调用
@Override
protected void onNewIntent(Intent intent) {
// 调用父类的 onNewIntent 方法
super.onNewIntent(intent);
// 初始化活动状态
initActivityState(intent);
}
// 重写 Activity 的 onSaveInstanceState 方法,在活动保存状态时调用
@Override
protected void onSaveInstanceState(Bundle outState) {
// 调用父类的 onSaveInstanceState 方法
super.onSaveInstanceState(outState);
/**
* For new note without note id, we should firstly save it to
* generate a id. If the editing note is not worth saving, there
* is no id which is equivalent to create new note
*/
// 如果工作笔记不在数据库中,保存笔记
if (!mWorkingNote.existInDatabase()) {
saveNote();
}
// 将工作笔记的 ID 放入 outState 中
outState.putLong(Intent.EXTRA_UID, mWorkingNote.getNoteId());
// 记录日志,表示保存工作笔记的 ID
Log.d(TAG, "Save working note id: " + mWorkingNote.getNoteId() + " onSaveInstanceState");
}
// 重写 Activity 的 dispatchTouchEvent 方法,处理触摸事件
@Override
public boolean dispatchTouchEvent(MotionEvent ev) {
// 如果背景颜色选择器可见且触摸事件不在其范围内,隐藏背景颜色选择器
if (mNoteBgColorSelector.getVisibility() == View.VISIBLE
&& !inRangeOfView(mNoteBgColorSelector, ev)) {
mNoteBgColorSelector.setVisibility(View.GONE);
return true;
}
// 如果字体大小选择器可见且触摸事件不在其范围内,隐藏字体大小选择器
if (mFontSizeSelector.getVisibility() == View.VISIBLE
&& !inRangeOfView(mFontSizeSelector, ev)) {
mFontSizeSelector.setVisibility(View.GONE);
return true;
}
// 调用父类的 dispatchTouchEvent 方法处理触摸事件
return super.dispatchTouchEvent(ev);
}
// 判断触摸事件是否在指定视图范围内的方法
private boolean inRangeOfView(View view, MotionEvent ev) {
// 用于存储视图在屏幕上的位置
int []location = new int[2];
// 获取视图在屏幕上的位置
view.getLocationOnScreen(location);
// 获取视图的 X 坐标
int x = location[0];
// 获取视图的 Y 坐标
int y = location[1];
// 判断触摸事件的坐标是否在视图范围内
if (ev.getX() < x
|| ev.getX() > (x + view.getWidth())
|| ev.getY() < y
|| ev.getY() > (y + view.getHeight())) {
return false;
}
return true;
}
// 初始化资源的方法,获取布局中的控件引用并设置监听器
private void initResources() {
// 获取笔记头部视图面板的引用
mHeadViewPanel = findViewById(R.id.note_title);
// 创建头部视图持有者对象
mNoteHeaderHolder = new HeadViewHolder();
// 获取显示修改日期的文本视图的引用
mNoteHeaderHolder.tvModified = (TextView) findViewById(R.id.tv_modified_date);
// 获取显示提醒图标的图像视图的引用
mNoteHeaderHolder.ivAlertIcon = (ImageView) findViewById(R.id.iv_alert_icon);
// 获取显示提醒日期的文本视图的引用
mNoteHeaderHolder.tvAlertDate = (TextView) findViewById(R.id.tv_alert_date);
// 获取设置背景颜色的按钮图像视图的引用
mNoteHeaderHolder.ibSetBgColor = (ImageView) findViewById(R.id.btn_set_bg_color);
// 为设置背景颜色的按钮设置点击监听器
mNoteHeaderHolder.ibSetBgColor.setOnClickListener(this);
// 获取笔记编辑器编辑文本的引用
mNoteEditor = (EditText) findViewById(R.id.note_edit_view);
// 获取笔记编辑器面板的引用
mNoteEditorPanel = findViewById(R.id.sv_note_edit);
// 获取笔记背景颜色选择器的引用
mNoteBgColorSelector = findViewById(R.id.note_bg_color_selector);
// 为所有背景选择按钮设置点击监听器
for (int id : sBgSelectorBtnsMap.keySet()) {
ImageView iv = (ImageView) findViewById(id);
iv.setOnClickListener(this);
}
// 获取字体大小选择器的引用
mFontSizeSelector = findViewById(R.id.font_size_selector);
// 为所有字体大小选择按钮设置点击监听器
for (int id : sFontSizeBtnsMap.keySet()) {
View view = findViewById(id);
view.setOnClickListener(this);
};
// 获取默认的共享偏好对象
mSharedPrefs = PreferenceManager.getDefaultSharedPreferences(this);
// 从共享偏好中获取字体大小资源 ID默认为默认字体大小资源 ID
mFontSizeId = mSharedPrefs.getInt(PREFERENCE_FONT_SIZE, ResourceParser.BG_DEFAULT_FONT_SIZE);
/**
* HACKME: Fix bug of store the resource id in shared preference.
* The id may larger than the length of resources, in this case,
* return the {@link ResourceParser#BG_DEFAULT_FONT_SIZE}
*/
// 如果字体大小资源 ID 超出资源数组的长度,将其设置为默认字体大小资源 ID
if(mFontSizeId >= TextAppearanceResources.getResourcesSize()) {
mFontSizeId = ResourceParser.BG_DEFAULT_FONT_SIZE;
}
// 获取用于显示编辑文本列表的线性布局的引用
mEditTextList = (LinearLayout) findViewById(R.id.note_edit_list);
}
// 重写 Activity 的 onPause 方法,在活动暂停时调用
@Override
protected void onPause() {
// 调用父类的 onPause 方法
super.onPause();
// 保存笔记,如果保存成功则记录日志
if(saveNote()) {
Log.d(TAG, "Note data was saved with length:" + mWorkingNote.getContent().length());
}
// 清除设置状态
clearSettingState();
}
// 更新小部件的方法,根据工作笔记的小部件类型发送广播更新小部件
private void updateWidget() {
// 创建一个用于更新小部件的 Intent
Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE);
// 如果工作笔记的小部件类型为 2x 小部件
if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_2X) {
// 设置 Intent 的目标类为 2x 小部件提供者类
intent.setClass(this, NoteWidgetProvider_2x.class);
} else if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_4X) {
// 如果工作笔记的小部件类型为 4x 小部件,设置 Intent 的目标类为 4x 小部件提供者类
intent.setClass(this, NoteWidgetProvider_4x.class);
} else {
// 如果小部件类型不支持,记录错误信息并返回
Log.e(TAG, "Unspported widget type");
return;
}
// 将工作笔记的小部件 ID 放入 Intent 中
intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS, new int[] {
mWorkingNote.getWidgetId()
});
// 发送广播更新小部件
sendBroadcast(intent);
// 设置活动的结果为成功
setResult(RESULT_OK, intent);
}
// 实现 OnClickListener 接口的 onClick 方法,处理视图的点击事件
public void onClick(View v) {
// 获取点击视图的 ID
int id = v.getId();
// 如果点击的是设置背景颜色的按钮
if (id == R.id.btn_set_bg_color) {
// 显示背景颜色选择器
mNoteBgColorSelector.setVisibility(View.VISIBLE);
// 显示当前背景颜色的选择状态图标
findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility(
View.VISIBLE);
} else if (sBgSelectorBtnsMap.containsKey(id)) {
// 如果点击的是背景选择按钮
// 隐藏当前背景颜色的选择状态图标
findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility(
View.GONE);
// 设置工作笔记的背景颜色资源 ID
mWorkingNote.setBgColorId(sBgSelectorBtnsMap.get(id));
// 隐藏背景颜色选择器
mNoteBgColorSelector.setVisibility(View.GONE);
} else if (sFontSizeBtnsMap.containsKey(id)) {
// 如果点击的是字体大小选择按钮
// 隐藏当前字体大小的选择状态图标
findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.GONE);
// 更新字体大小资源 ID
mFontSizeId = sFontSizeBtnsMap.get(id);
// 将新的字体大小资源 ID 保存到共享偏好中
mSharedPrefs.edit().putInt(PREFERENCE_FONT_SIZE, mFontSizeId).commit();
// 显示新的字体大小的选择状态图标
findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.VISIBLE);
// 如果工作笔记处于复选列表模式
if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {
// 获取工作笔记的文本
getWorkingText();
// 切换到列表模式并显示笔记内容
switchToListMode(mWorkingNote.getContent());
} else {
// 设置笔记编辑器的文本外观
mNoteEditor.setTextAppearance(this,
TextAppearanceResources.getTexAppearanceResource(mFontSizeId));
}
// 隐藏字体大小选择器
mFontSizeSelector.setVisibility(View.GONE);
}
}
// 重写 Activity 的 onBackPressed 方法,在用户按下返回键时调用
@Override
public void onBackPressed() {
// 清除设置状态,如果清除成功则返回
if(clearSettingState()) {
return;
}
// 保存笔记
saveNote();
// 调用父类的 onBackPressed 方法
super.onBackPressed();
}
// 清除设置状态的方法,隐藏背景颜色选择器和字体大小选择器
private boolean clearSettingState() {
// 如果背景颜色选择器可见
if (mNoteBgColorSelector.getVisibility() == View.VISIBLE) {
// 隐藏背景颜色选择器
mNoteBgColorSelector.setVisibility(View.GONE);
return true;
} else if (mFontSizeSelector.getVisibility() == View.VISIBLE) {
// 如果字体大小选择器可见,隐藏字体大小选择器
mFontSizeSelector.setVisibility(View.GONE);
return true;
}
return false;
}
// 实现 NoteSettingChangedListener 接口的 onBackgroundColorChanged 方法,在背景颜色改变时调用
public void onBackgroundColorChanged() {
// 显示当前背景颜色的选择状态图标
findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility(
View.VISIBLE);
// 设置笔记编辑器面板的背景资源
mNoteEditorPanel.setBackgroundResource(mWorkingNote.getBgColorResId());
// 设置笔记头部视图面板的背景资源
mHeadViewPanel.setBackgroundResource(mWorkingNote.getTitleBgResId());
}
// 重写 Activity 的 onPrepareOptionsMenu 方法,在准备菜单时调用
@Override
public boolean onPrepareOptionsMenu(Menu menu) {
// 如果活动正在结束,返回 true
if (isFinishing()) {
return true;
}
// 清除设置状态
clearSettingState();
// 清除菜单
menu.clear();
// 如果工作笔记所在的文件夹为通话记录文件夹
if (mWorkingNote.getFolderId() == Notes.ID_CALL_RECORD_FOLDER) {
// 加载通话笔记编辑菜单
getMenuInflater().inflate(R.menu.call_note_edit, menu);
} else {
// 加载普通笔记编辑菜单
getMenuInflater().inflate(R.menu.note_edit, menu);
}
// 如果工作笔记处于复选列表模式
if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {
// 设置列表模式菜单项的标题为切换到普通模式
menu.findItem(R.id.menu_list_mode).setTitle(R.string.menu_normal_mode);
} else {
// 设置列表模式菜单项的标题为切换到列表模式
menu.findItem(R.id.menu_list_mode).setTitle(R.string.menu_list_mode);
}
// 如果工作笔记有闹钟提醒
if (mWorkingNote.hasClockAlert()) {
// 隐藏设置提醒菜单项
menu.findItem(R.id.menu_alert).setVisible(false);
} else {
// 隐藏删除提醒菜单项
menu.findItem(R.id.menu_delete_remind).setVisible(false);
}
return true;
}
// 重写 Activity 的 onOptionsItemSelected 方法,处理菜单项的点击事件
@Override
public boolean onOptionsItemSelected(MenuItem item) {
// 根据菜单项的 ID 进行不同的处理
switch (item.getItemId()) {
case R.id.menu_new_note:
// 如果点击的是新建笔记菜单项,创建新笔记
createNewNote();
break;
case R.id.menu_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_note));
// 设置对话框的确定按钮点击监听器
builder.setPositiveButton(android.R.string.ok,
new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int which) {
// 点击确定按钮时,删除当前笔记并结束活动
deleteCurrentNote();
finish();
}
});
// 设置对话框的取消按钮点击监听器
builder.setNegativeButton(android.R.string.cancel, null);
// 显示对话框
builder.show();
break;
case R.id.menu_font_size:
// 如果点击的是字体大小菜单项,显示字体大小选择器
mFontSizeSelector.setVisibility(View.VISIBLE);
// 显示当前字体大小的选择状态图标
findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.VISIBLE);
break;
case R.id.menu_list_mode:
// 如果点击的是列表模式菜单项,切换工作笔记的列表模式
mWorkingNote.setCheckListMode(mWorkingNote.getCheckListMode() == 0 ?
TextNote.MODE_CHECK_LIST : 0);
break;
case R.id.menu_share:
// 如果点击的是分享菜单项,获取工作笔记的文本并分享
getWorkingText();
sendTo(this, mWorkingNote.getContent());
break;
case R.id.menu_send_to_desktop:
// 如果点击的是发送到桌面菜单项,将笔记发送到桌面
sendToDesktop();
break;
case R.id.menu_alert:
// 如果点击的是设置提醒菜单项,设置提醒
setReminder();
break;
case R.id.menu_delete_remind:
// 如果点击的是删除提醒菜单项,删除提醒
mWorkingNote.setAlertDate(0, false);
break;
default:
break;
}
return true;
}
// 设置提醒的方法,显示日期时间选择对话框并设置提醒日期
private void setReminder() {
// 创建日期时间选择对话框,初始时间为当前时间
DateTimePickerDialog d = new DateTimePickerDialog(this, System.currentTimeMillis());
// 设置日期时间选择对话框的监听器
d.setOnDateTimeSetListener(new OnDateTimeSetListener() {
public void OnDateTimeSet(AlertDialog dialog, long date) {
// 当用户选择日期时间后,设置工作笔记的提醒日期
mWorkingNote.setAlertDate(date , true);
}
});
// 显示日期时间选择对话框
d.show();
}
/**
* Share note to apps that support {@link Intent#ACTION_SEND} action
* and {@text/plain} type
*/
// 分享笔记的方法,将笔记内容分享到支持文本分享的应用程序
private void sendTo(Context context, String info) {
// 创建一个用于分享的 Intent
Intent intent = new Intent(Intent.ACTION_SEND);
// 将笔记内容放入 Intent 中
intent.putExtra(Intent.EXTRA_TEXT, info);
// 设置分享的内容类型为纯文本
intent.setType("text/plain");
// 启动分享活动
context.startActivity(intent);
}
// 创建新笔记的方法,先保存当前编辑的笔记,然后启动新的笔记编辑活动
private void createNewNote() {
// 保存当前编辑的笔记
saveNote();
// 结束当前活动
finish();
// 创建一个用于启动新笔记编辑活动的 Intent
Intent intent = new Intent(this, NoteEditActivity.class);
// 设置 Intent 的动作为插入或编辑
intent.setAction(Intent.ACTION_INSERT_OR_EDIT);
// 将当前工作笔记的文件夹 ID 放入 Intent 中
intent.putExtra(Notes.INTENT_EXTRA_FOLDER_ID, mWorkingNote.getFolderId());
// 启动新的笔记编辑活动
startActivity(intent);
}
// 删除当前笔记的方法,根据同步模式将笔记删除或移动到回收站
private void deleteCurrentNote() {
// 如果工作笔记存在于数据库中
if (mWorkingNote.existInDatabase()) {
// 创建一个哈希集合用于存储要删除的笔记 ID
HashSet<Long> ids = new HashSet<Long>();
// 获取工作笔记的 ID
long id = mWorkingNote.getNoteId();
// 如果笔记 ID 不是根文件夹 ID
if (id != Notes.ID_ROOT_FOLDER) {
// 将笔记 ID 加入哈希集合
ids.add(id);
} else {
// 记录错误信息
Log.d(TAG, "Wrong note id, should not happen");
}
// 如果不是同步模式
if (!isSyncMode()) {
// 批量删除笔记,如果删除失败记录错误信息
if (!DataUtils.batchDeleteNotes(getContentResolver(), ids)) {
Log.e(TAG, "Delete Note error");
}
} else {
// 如果是同步模式,批量将笔记移动到回收站,如果移动失败记录错误信息
if (!DataUtils.batchMoveToFolder(getContentResolver(), ids, Notes.ID_TRASH_FOLER)) {
Log.e(TAG, "Move notes to trash folder error, should not happens");
}
}
}
// 标记工作笔记为已删除
mWorkingNote.markDeleted(true);
}
// 判断是否为同步模式的方法,根据同步账户名称判断
private boolean isSyncMode() {
// 获取同步账户名称并去除首尾空格
return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0;
}
// 实现 NoteSettingChangedListener 接口的 onClockAlertChanged 方法,在闹钟提醒设置改变时调用
public void onClockAlertChanged(long date, boolean set) {
/**
* User could set clock to an unsaved note, so before setting the
* alert clock, we should save the note first
*/
// 如果工作笔记不在数据库中,保存笔记
if (!mWorkingNote.existInDatabase()) {
saveNote();
}
// 如果工作笔记的 ID 大于 0
if (mWorkingNote.getNoteId() > 0) {
// 创建一个用于闹钟提醒的 Intent
Intent intent = new Intent(this, AlarmReceiver.class);
// 设置 Intent 的数据为笔记的 URI
intent.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, mWorkingNote.getNoteId()));
// 创建一个待处理意图
PendingIntent pendingIntent = PendingIntent.getBroadcast(this, 0, intent, 0);
// 获取闹钟管理服务
AlarmManager alarmManager = ((AlarmManager) getSystemService(ALARM_SERVICE));
// 显示提醒头部信息
showAlertHeader();
// 如果取消提醒
if(!set) {
// 取消闹钟提醒
alarmManager.cancel(pendingIntent);
} else {
// 如果设置提醒,设置闹钟提醒
alarmManager.set(AlarmManager.RTC_WAKEUP, date, pendingIntent);
}
} else {
/**
* There is the condition that user has input nothing (the note is
* not worthy saving), we have no note id, remind the user that he
* should input something
*/
// 记录错误信息
Log.e(TAG, "Clock alert setting error");
// 显示提示信息,提醒用户输入内容
showToast(R.string.error_note_empty_for_clock);
}
}
// 实现 NoteSettingChangedListener 接口的 onWidgetChanged 方法,在小部件设置改变时调用
public void onWidgetChanged() {
// 更新小部件
updateWidget();
}
// 实现 OnTextViewChangeListener 接口的 onEditTextDelete 方法,在编辑文本删除时调用
public void onEditTextDelete(int index, String text) {
// 获取编辑文本列表的子视图数量
int childCount = mEditTextList.getChildCount();
// 如果子视图数量为 1直接返回
if (childCount == 1) {
return;
}
// 从删除位置的下一个位置开始,更新后续编辑文本的索引
for (int i = index + 1; i < childCount; i++) {
((NoteEditText) mEditTextList.getChildAt(i).findViewById(R.id.et_edit_text))
.setIndex(i - 1);
}
// 从编辑文本列表中移除指定位置的视图
mEditTextList.removeViewAt(index);
// 声明一个 NoteEditText 对象,用于存储要追加文本的编辑文本
NoteEditText edit = null;
// 如果删除的是第一个位置的视图
if(index == 0) {
// 获取第一个位置的编辑文本
edit = (NoteEditText) mEditTextList.getChildAt(0).findViewById(
R.id.et_edit_text);
} else {
// 获取删除位置前一个位置的编辑文本
edit = (NoteEditText) mEditTextList.getChildAt(index - 1).findViewById(
R.id.et_edit_text);
}
// 获取编辑文本的长度
int length = edit.length();
// 将删除的文本追加到编辑文本中
edit.append(text);
// 请求编辑文本获取焦点
edit.requestFocus();
// 将光标移动到追加文本的末尾
edit.setSelection(length);
}
// 实现 OnTextViewChangeListener 接口的 onEditTextEnter 方法,在编辑文本输入回车时调用
public void onEditTextEnter(int index, String text) {
/**
* Should not happen, check for debug
*/
// 如果索引超出编辑文本列表的范围,记录错误信息
if(index > mEditTextList.getChildCount()) {
Log.e(TAG, "Index out of mEditTextList boundrary, should not happen");
}
// 获取一个新的列表项视图
View view = getListItem(text, index);
// 将新的列表项视图插入到编辑文本列表的指定位置
mEditTextList.addView(view, index);
// 获取新列表项视图中的编辑文本
NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text);
// 请求编辑文本获取焦点
edit.requestFocus();
// 将光标移动到编辑文本的开头
edit.setSelection(0);
// 从插入位置的下一个位置开始,更新后续编辑文本的索引
for (int i = index + 1; i < mEditTextList.getChildCount(); i++) {
((NoteEditText) mEditTextList.getChildAt(i).findViewById(R.id.et_edit_text))
.setIndex(i);
}
}
// 切换到列表模式的方法,将笔记内容按行分割并显示为列表项
private void switchToListMode(String text) {
// 清空编辑文本列表
mEditTextList.removeAllViews();
// 将笔记内容按换行符分割成数组
String[] items = text.split("\n");
// 初始化索引为 0
int index = 0;
// 遍历分割后的数组
for (String item : items) {
// 如果数组元素不为空
if(!TextUtils.isEmpty(item)) {
// 获取一个列表项视图并添加到编辑文本列表中
mEditTextList.addView(getListItem(item, index));
// 索引加 1
index++;
}
}
// 获取一个空的列表项视图并添加到编辑文本列表的末尾
mEditTextList.addView(getListItem("", index));
// 请求最后一个列表项视图中的编辑文本获取焦点
mEditTextList.getChildAt(index).findViewById(R.id.et_edit_text).requestFocus();
// 隐藏笔记编辑器
mNoteEditor.setVisibility(View.GONE);
// 显示编辑文本列表
mEditTextList.setVisibility(View.VISIBLE);
}
// 获取高亮查询结果的方法,将查询内容在笔记内容中高亮显示
private Spannable getHighlightQueryResult(String fullText, String userQuery) {
// 创建一个可扩展字符串对象,用于存储笔记内容
SpannableString spannable = new SpannableString(fullText == null ? "" : fullText);
// 如果用户查询字符串不为空
if (!TextUtils.isEmpty(userQuery)) {
// 编译用户查询字符串为正则表达式模式
mPattern = Pattern.compile(userQuery);
// 创建一个正则表达式匹配器对象
Matcher m = mPattern.matcher(fullText);
// 初始化匹配起始位置为 0
int start = 0;
// 查找所有匹配的内容
while (m.find(start)) {
// 在匹配的内容上设置背景颜色跨度,实现高亮显示
spannable.setSpan(
new BackgroundColorSpan(this.getResources().getColor(
R.color.user_query_highlight)), m.start(), m.end(),
Spannable.SPAN_INCLUSIVE_EXCLUSIVE);
// 更新匹配起始位置为匹配内容的结束位置
start = m.end();
}
}
return spannable;
}
// 获取列表项视图的方法,根据文本内容和索引创建列表项视图
private View getListItem(String item, int index) {
// 使用布局加载器加载列表项布局文件
View view = LayoutInflater.from(this).inflate(R.layout.note_edit_list_item, null);
// 获取列表项视图中的编辑文本
final NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text);
// 设置编辑文本的文本外观
edit.setTextAppearance(this, TextAppearanceResources.getTexAppearanceResource(mFontSizeId));
// 获取列表项视图中的复选框
CheckBox cb = ((CheckBox) view.findViewById(R.id.cb_edit_item));
// 为复选框设置状态改变监听器
cb.setOnCheckedChangeListener(new OnCheckedChangeListener() {
public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
// 如果复选框被选中
if (isChecked) {
// 在编辑文本上添加删除线
edit.setPaintFlags(edit.getPaintFlags() | Paint.STRIKE_THRU_TEXT_FLAG);
} else {
// 移除编辑文本上的删除线
edit.setPaintFlags(Paint.ANTI_ALIAS_FLAG | Paint.DEV_KERN_TEXT_FLAG);
}
}
});
// 如果文本内容以已勾选标记开头
if (item.startsWith(TAG_CHECKED)) {
// 设置复选框为选中状态
cb.setChecked(true);
// 在编辑文本上添加删除线
edit.setPaintFlags(edit.getPaintFlags() | Paint.STRIKE_THRU_TEXT_FLAG);
// 去除文本内容中的已勾选标记
item = item.substring(TAG_CHECKED.length(), item.length()).trim();
} else if (item.startsWith(TAG_UNCHECKED)) {
// 如果文本内容以未勾选标记开头,设置复选框为未选中状态
cb.setChecked(false);
// 移除编辑文本上的删除线
edit.setPaintFlags(Paint.ANTI_ALIAS_FLAG | Paint.DEV_KERN_TEXT_FLAG);
// 去除文本内容中的未勾选标记
item = item.substring(TAG_UNCHECKED.length(), item.length()).trim();
}
// 为编辑文本设置文本改变监听器
edit.setOnTextViewChangeListener(this);
// 设置编辑文本的索引
edit.setIndex(index);
// 设置编辑文本的文本并高亮显示查询结果
edit.setText(getHighlightQueryResult(item, mUserQuery));
return view;
}
// 实现 OnTextViewChangeListener 接口的 onTextChange 方法,在编辑文本内容改变时调用
public void onTextChange(int index, boolean hasText) {
// 如果索引超出编辑文本列表的范围,记录错误信息
if (index >= mEditTextList.getChildCount()) {
Log.e(TAG, "Wrong index, should not happen");
return;
}
// 如果编辑文本有内容
if(hasText) {
// 显示列表项视图中的复选框
mEditTextList.getChildAt(index).findViewById(R.id.cb_edit_item).setVisibility(View.VISIBLE);
} else {
// 如果编辑文本没有内容,隐藏列表项视图中的复选框
mEditTextList.getChildAt(index).findViewById(R.id.cb_edit_item).setVisibility(View.GONE);
}
}
// 实现 NoteSettingChangedListener 接口的 onCheckListModeChanged 方法,在复选列表模式改变时调用
public void onCheckListModeChanged(int oldMode, int newMode) {
// 如果新的模式为复选列表模式
if (newMode == TextNote.MODE_CHECK_LIST) {
// 切换到列表模式并显示笔记内容
switchToListMode(mNoteEditor.getText().toString());
} else {
// 如果新的模式不是复选列表模式
if (!getWorkingText()) {
// 获取工作笔记的文本,如果失败则替换未勾选标记
mWorkingNote.setWorkingText(mWorkingNote.getContent().replace(TAG_UNCHECKED + " ",
""));
}
// 设置笔记编辑器的文本并高亮显示查询结果
mNoteEditor.setText(getHighlightQueryResult(mWorkingNote.getContent(), mUserQuery));
// 隐藏编辑文本列表
mEditTextList.setVisibility(View.GONE);
// 显示笔记编辑器
mNoteEditor.setVisibility(View.VISIBLE);
}
}
// 获取工作笔记文本的方法,根据工作笔记的模式获取文本内容
private boolean getWorkingText() {
// 用于标记是否有勾选的项目
boolean hasChecked = false;
// 如果工作笔记处于复选列表模式
if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {
// 创建一个字符串构建器对象,用于拼接文本内容
StringBuilder sb = new StringBuilder();
// 遍历编辑文本列表中的所有子视图
for (int i = 0; i < mEditTextList.getChildCount(); i++) {
// 获取当前子视图
View view = mEditTextList.getChildAt(i);
// 获取当前子视图中的编辑文本
NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text);
// 如果编辑文本有内容
if (!TextUtils.isEmpty(edit.getText())) {
// 如果当前列表项的复选框被选中
if (((CheckBox) view.findViewById(R.id.cb_edit_item)).isChecked()) {
// 在字符串构建器中添加已勾选标记、编辑文本内容和换行符
sb.append(TAG_CHECKED).append(" ").append(edit.getText()).append("\n");
// 标记有勾选的项目
hasChecked = true;
} else {
// 在字符串构建器中添加未勾选标记、编辑文本内容和换行符
sb.append(TAG_UNCHECKED).append(" ").append(edit.getText()).append("\n");
}
}
}
// 设置工作笔记的文本内容
mWorkingNote.setWorkingText(sb.toString());
} else {
// 如果工作笔记不是复选列表模式,设置工作笔记的文本内容为笔记编辑器的文本
mWorkingNote.setWorkingText(mNoteEditor.getText().toString());
}
return hasChecked;
}
// 保存笔记的方法,获取工作笔记的文本并保存到数据库
private boolean saveNote() {
// 获取工作笔记的文本
getWorkingText();
// 调用工作笔记的保存方法保存笔记
boolean saved = mWorkingNote.saveNote();
// 如果保存成功
if (saved) {
/**
* There are two modes from List view to edit view, open one note,
* create/edit a node. Opening node requires to the original
* position in the list when back from edit view, while creating a
* new node requires to the top of the list. This code
* {@link #RESULT_OK} is used to identify the create/edit state
*/
// 设置活动的结果为成功
setResult(RESULT_OK);
}
return saved;
}
// 发送到桌面的方法,将笔记创建为桌面快捷方式
private void sendToDesktop() {
/**
* Before send message to home, we should make sure that current
* editing note is exists in databases. So, for new note, firstly
* save it
*/
// 如果工作笔记不在数据库中,保存笔记
if (!mWorkingNote.existInDatabase()) {
saveNote();
}
// 如果工作笔记的 ID 大于 0
if (mWorkingNote.getNoteId() > 0) {
// 创建一个用于发送广播的 Intent
Intent sender = new Intent();
// 创建一个用于打开笔记编辑活动的 Intent
Intent shortcutIntent = new Intent(this, NoteEditActivity.class);
// 设置 Intent 的动作为查看笔记
shortcutIntent.setAction(Intent.ACTION_VIEW);
// 将工作笔记的 ID 放入 Intent 中
shortcutIntent.putExtra(Intent.EXTRA_UID, mWorkingNote.getNoteId());
// 将打开笔记编辑活动的 Intent 放入发送广播的 Intent 中
sender.putExtra(Intent.EXTRA_SHORTCUT_INTENT, shortcutIntent);
// 将笔记的快捷图标标题放入发送广播的 Intent 中
sender.putExtra(Intent.EXTRA_SHORTCUT_NAME,
makeShortcutIconTitle(mWorkingNote.getContent()));
// 将笔记的快捷图标资源放入发送广播的 Intent 中
sender.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE,
Intent.ShortcutIconResource.fromContext(this, R.drawable.icon_app));
// 设置允许创建重复的快捷方式
sender.putExtra("duplicate", true);
// 设置发送广播的 Intent 的动作为安装快捷方式
sender.setAction("com.android.launcher.action.INSTALL_SHORTCUT");
// 显示提示信息,提示笔记已发送到桌面
showToast(R.string.info_note_enter_desktop);
// 发送广播创建快捷方式
sendBroadcast(sender);
} else {
/**
* There is the condition that user has input nothing (the note is
* not worthy saving), we have no note id, remind the user that he
* should input something
*/
// 记录错误信息
Log.e(TAG, "Send to desktop error");
// 显示提示信息,提醒用户输入内容
showToast(R.string.error_note_empty_for_send_to_desktop);
}
}
// 生成快捷图标标题的方法,去除文本中的勾选标记并截取指定长度
private String makeShortcutIconTitle(String content) {
// 去除文本中的已勾选标记
content = content.replace(TAG_CHECKED, "");
// 去除文本中的未勾选标记
content = content.replace(TAG_UNCHECKED, "");
// 如果文本长度超过最大长度,截取前最大长度的字符
return content.length() > SHORTCUT_ICON_TITLE_MAX_LEN ? content.substring(0,
SHORTCUT_ICON_TITLE_MAX_LEN) : content;
}
// 显示短时间提示信息的方法
private void showToast(int resId) {
// 调用显示提示信息的方法,显示短时间提示信息
showToast(resId, Toast.LENGTH_SHORT);
}
// 显示提示信息的方法,根据指定的时长显示提示信息
private void showToast(int resId, int duration) {
// 使用 Toast 显示提示信息
Toast.makeText(this, resId, duration).show();
}
}