/* * 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; import android.app.Activity; import android.app.AlarmManager; import android.app.AlertDialog; import android.app.PendingIntent; import android.app.SearchManager; import android.appwidget.AppWidgetManager; import android.content.ContentUris; import android.content.Context; import android.content.DialogInterface; import android.content.Intent; import android.content.SharedPreferences; import android.graphics.Paint; import android.os.Bundle; import android.preference.PreferenceManager; import android.text.Spannable; import android.text.SpannableString; import android.text.TextUtils; import android.text.format.DateUtils; import android.text.style.BackgroundColorSpan; import android.util.Log; import android.view.LayoutInflater; import android.view.Menu; import android.view.MenuItem; import android.view.MotionEvent; import android.view.View; import android.view.View.OnClickListener; import android.view.WindowManager; import android.widget.CheckBox; import android.widget.CompoundButton; import android.widget.CompoundButton.OnCheckedChangeListener; import android.widget.EditText; import android.widget.ImageView; import android.widget.LinearLayout; import android.widget.TextView; 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; import net.micode.notes.widget.NoteWidgetProvider_2x; import net.micode.notes.widget.NoteWidgetProvider_4x; import java.util.HashMap; import java.util.HashSet; import java.util.Map; import java.util.regex.Matcher; import java.util.regex.Pattern; public class NoteEditActivity extends Activity implements OnClickListener, NoteSettingChangedListener, OnTextViewChangeListener { private class HeadViewHolder { public TextView tvModified; // 用于显示修改日期的TextView public ImageView ivAlertIcon; // 用于显示提醒图标的ImageView public TextView tvAlertDate; // 用于显示提醒日期的TextView public ImageView ibSetBgColor; // 用于设置背景颜色的ImageView按钮 } private static final Map sBgSelectorBtnsMap = new HashMap(); // 映射背景选择按钮的ID到相应的背景颜色 static { sBgSelectorBtnsMap.put(R.id.iv_bg_yellow, ResourceParser.YELLOW); sBgSelectorBtnsMap.put(R.id.iv_bg_red, ResourceParser.RED); sBgSelectorBtnsMap.put(R.id.iv_bg_blue, ResourceParser.BLUE); sBgSelectorBtnsMap.put(R.id.iv_bg_green, ResourceParser.GREEN); sBgSelectorBtnsMap.put(R.id.iv_bg_white, ResourceParser.WHITE); } private static final Map sBgSelectorSelectionMap = new HashMap(); // 映射背景颜色到相应的选中状态按钮的ID static { sBgSelectorSelectionMap.put(ResourceParser.YELLOW, R.id.iv_bg_yellow_select); sBgSelectorSelectionMap.put(ResourceParser.RED, R.id.iv_bg_red_select); sBgSelectorSelectionMap.put(ResourceParser.BLUE, R.id.iv_bg_blue_select); sBgSelectorSelectionMap.put(ResourceParser.GREEN, R.id.iv_bg_green_select); sBgSelectorSelectionMap.put(ResourceParser.WHITE, R.id.iv_bg_white_select); } private static final Map sFontSizeBtnsMap = new HashMap(); // 映射字体大小选择按钮的ID到相应的字体大小 static { sFontSizeBtnsMap.put(R.id.ll_font_large, ResourceParser.TEXT_LARGE); sFontSizeBtnsMap.put(R.id.ll_font_small, ResourceParser.TEXT_SMALL); sFontSizeBtnsMap.put(R.id.ll_font_normal, ResourceParser.TEXT_MEDIUM); sFontSizeBtnsMap.put(R.id.ll_font_super, ResourceParser.TEXT_SUPER); } private static final Map sFontSelectorSelectionMap = new HashMap(); // 映射字体大小到相应的选中状态按钮的ID static { sFontSelectorSelectionMap.put(ResourceParser.TEXT_LARGE, R.id.iv_large_select); sFontSelectorSelectionMap.put(ResourceParser.TEXT_SMALL, R.id.iv_small_select); sFontSelectorSelectionMap.put(ResourceParser.TEXT_MEDIUM, R.id.iv_medium_select); 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; 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; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); // 调用父类的onCreate方法以完成基本初始化工作 this.setContentView(R.layout.note_edit); // 设置当前活动的内容视图为note_edit.xml布局 if (savedInstanceState == null && !initActivityState(getIntent())) { finish(); // 如果没有保存的实例状态且初始化活动状态失败，则结束当前活动 return; } initResources(); // 初始化活动的资源 } /** * 当内存不足时，当前活动可能会被销毁。一旦被销毁，用户再次加载该活动时，应该还原先前的状态。 */ @Override protected void onRestoreInstanceState(Bundle savedInstanceState) { super.onRestoreInstanceState(savedInstanceState); // 调用父类的onRestoreInstanceState方法以完成基本初始化工作 // 检查是否有保存的实例状态（savedInstanceState）以及是否包含关键信息（Intent.EXTRA_UID） if (savedInstanceState != null && savedInstanceState.containsKey(Intent.EXTRA_UID)) { Intent intent = new Intent(Intent.ACTION_VIEW); intent.putExtra(Intent.EXTRA_UID, savedInstanceState.getLong(Intent.EXTRA_UID)); // 尝试初始化活动状态，如果初始化失败，则结束当前活动 if (!initActivityState(intent)) { finish(); return; } Log.d(TAG, "Restoring from killed activity"); // 打印日志以指示从已销毁的活动中还原状态 } } /** * 初始化活动的状态，根据传入的Intent执行不同操作： * * 如果Intent的操作是{@link Intent#ACTION_VIEW}，则尝试查看指定的笔记或搜索结果。 * 如果Intent的操作是{@link Intent#ACTION_INSERT_OR_EDIT}，则创建新的笔记或处理通话记录笔记。 * 其他情况下，会记录错误日志并结束活动。 * * @param intent 用于初始化活动状态的Intent对象 * @return 如果成功初始化活动状态，返回true；否则返回false */ private boolean initActivityState(Intent intent) { mWorkingNote = null; // 初始化工作笔记为null if (TextUtils.equals(Intent.ACTION_VIEW, intent.getAction())) { // 如果Intent的操作是查看笔记 long noteId = intent.getLongExtra(Intent.EXTRA_UID, 0); mUserQuery = ""; if (intent.hasExtra(SearchManager.EXTRA_DATA_KEY)) { // 如果是从搜索结果启动的 noteId = Long.parseLong(intent.getStringExtra(SearchManager.EXTRA_DATA_KEY)); 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的操作是新建或编辑笔记 long folderId = intent.getLongExtra(Notes.INTENT_EXTRA_FOLDER_ID, 0); int widgetId = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID); int widgetType = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_TYPE, Notes.TYPE_WIDGET_INVALIDE); int bgResId = intent.getIntExtra(Notes.INTENT_EXTRA_BACKGROUND_ID, ResourceParser.getDefaultBgId(this)); // 处理通话记录笔记 String phoneNumber = intent.getStringExtra(Intent.EXTRA_PHONE_NUMBER); long callDate = intent.getLongExtra(Notes.INTENT_EXTRA_CALL_DATE, 0); if (callDate != 0 && phoneNumber != null) { if (TextUtils.isEmpty(phoneNumber)) { Log.w(TAG, "The call record number is null"); } long noteId = 0; 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 { // 操作不受支持，记录错误日志并结束活动 Log.e(TAG, "Intent not specified action, should not support"); finish(); return false; } // 设置工作笔记状态变化监听器 mWorkingNote.setOnSettingStatusChangedListener(this); return true; // 成功初始化活动状态，返回true } /** * 在活动恢复时被调用，用于初始化笔记屏幕。 */ @Override protected void 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: 添加设置提醒的菜单。当前已禁用，因为DateTimePicker尚未准备好。 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); } } // 当接收到新的意图时，会调用此方法，通常用于处理新的数据或操作。 @Override protected void onNewIntent(Intent intent) { super.onNewIntent(intent); initActivityState(intent); } // 此方法用于保存活动的当前状态，包括任何未保存的数据。 @Override protected void onSaveInstanceState(Bundle outState) { super.onSaveInstanceState(outState); // 如果工作笔记是新的且未保存到数据库中，保存它以生成一个ID。 if (!mWorkingNote.existInDatabase()) { saveNote(); } // 在保存的实例状态中存储工作笔记的ID。 outState.putLong(Intent.EXTRA_UID, mWorkingNote.getNoteId()); Log.d(TAG, "保存工作笔记的ID：" + mWorkingNote.getNoteId() + " 在onSaveInstanceState中"); } // 此方法用于在触摸事件分派给视图之前处理触摸事件。 @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; } // 继续正常的触摸事件处理。 return super.dispatchTouchEvent(ev); } // 辅助方法，用于检查触摸事件是否在视图的范围内。 private boolean inRangeOfView(View view, MotionEvent ev) { // 检查触摸坐标是否在视图的范围内。 // 如果不是，返回false；否则返回true。 // 用于确定触摸是否在可见选择器的外部。 // ... // 此方法初始化活动中使用的各种资源。 private void initResources() { // 查找视图并为UI元素设置监听器。 // ... // 获取共享偏好并检索字体大小设置。 mSharedPrefs = PreferenceManager.getDefaultSharedPreferences(this); mFontSizeId = mSharedPrefs.getInt(PREFERENCE_FONT_SIZE, ResourceParser.BG_DEFAULT_FONT_SIZE); // 处理存储的字体大小ID大于可用资源的特殊情况。 if(mFontSizeId >= TextAppearanceResources.getResourcesSize()) { mFontSizeId = ResourceParser.BG_DEFAULT_FONT_SIZE; } // 设置其他资源和UI元素。 mEditTextList = (LinearLayout) findViewById(R.id.note_edit_list); } // 在活动暂停时调用此方法。通常在用户切换到其他应用程序或活动时触发。 @Override protected void onPause() { super.onPause(); // 调用 saveNote() 方法来保存笔记数据，如果保存成功，则记录保存的数据长度。 if (saveNote()) { Log.d(TAG, "Note data was saved with length:" + mWorkingNote.getContent().length()); } // 清除设置状态，确保不再保留可能在活动中的临时设置。 clearSettingState(); } // 更新小部件的方法。根据当前工作笔记的小部件类型，选择相应的小部件提供程序类并发送广播通知小部件更新。 private void updateWidget() { Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE); // 根据当前工作笔记的小部件类型设置适当的小部件提供程序类。 if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_2X) { intent.setClass(this, NoteWidgetProvider_2x.class); } else if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_4X) { intent.setClass(this, NoteWidgetProvider_4x.class); } else { // 如果小部件类型不受支持，记录错误并退出方法。 Log.e(TAG, "Unspported widget type"); return; } // 将小部件ID包含在广播意图中，以指示哪个小部件需要更新。 intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS, new int[] { mWorkingNote.getWidgetId() }); // 发送广播通知系统更新小部件。 sendBroadcast(intent); // 设置结果代码为RESULT_OK，表示操作成功。 setResult(RESULT_OK, intent); } // 处理点击事件的方法，根据视图的ID执行相应的操作。 public void onClick(View v) { 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); mWorkingNote.setBgColorId(sBgSelectorBtnsMap.get(id)); mNoteBgColorSelector.setVisibility(View.GONE); } else if (sFontSizeBtnsMap.containsKey(id)) { // 当点击字体大小选择器中的按钮时，设置字体大小并更新视图。 findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.GONE); mFontSizeId = sFontSizeBtnsMap.get(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); } } // 当用户按下返回按钮时调用，用于处理返回操作。 @Override public void onBackPressed() { if (clearSettingState()) { // 如果设置状态被清除成功，直接返回，不执行后续操作。 return; } // 保存笔记内容。 saveNote(); // 执行默认的返回操作。 super.onBackPressed(); } // 用于清除设置状态。如果背景颜色选择器或字体大小选择器可见，则隐藏它们，并返回 true 表示成功清除设置状态；否则返回 false。 private boolean clearSettingState() { if (mNoteBgColorSelector.getVisibility() == View.VISIBLE) { // 如果背景颜色选择器可见，隐藏它并返回 true。 mNoteBgColorSelector.setVisibility(View.GONE); return true; } else if (mFontSizeSelector.getVisibility() == View.VISIBLE) { // 如果字体大小选择器可见，隐藏它并返回 true。 mFontSizeSelector.setVisibility(View.GONE); return true; } // 如果没有任何设置状态需要清除，返回 false。 return false; } // 当背景颜色发生变化时调用，用于更新相关视图的背景颜色。 public void onBackgroundColorChanged() { // 设置选中的背景颜色按钮为可见状态。 findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility( View.VISIBLE); // 更新笔记编辑面板的背景颜色。 mNoteEditorPanel.setBackgroundResource(mWorkingNote.getBgColorResId()); // 更新标题视图面板的背景颜色。 mHeadViewPanel.setBackgroundResource(mWorkingNote.getTitleBgResId()); } // 在准备显示选项菜单时调用，用于根据当前笔记状态和应用状态来设置菜单项。 @Override public boolean onPrepareOptionsMenu(Menu menu) { 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; } @Override public boolean onOptionsItemSelected(MenuItem item) { switch (item.getItemId()) { case R.id.menu_new_note: // 当选择新建笔记菜单项时，调用createNewNote()方法 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()方法删除当前笔记，并结束活动 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; // 返回true表示菜单项已处理 } /** * 弹出日期和时间选择对话框，允许用户设置提醒日期和时间。 */ private void setReminder() { // 创建一个 DateTimePickerDialog 实例，传入当前活动和当前系统时间 DateTimePickerDialog dateTimePickerDialog = new DateTimePickerDialog(this, System.currentTimeMillis()); // 设置日期和时间选择监听器，当用户设置日期和时间时执行操作 dateTimePickerDialog.setOnDateTimeSetListener(new OnDateTimeSetListener() { public void OnDateTimeSet(AlertDialog dialog, long date) { // 将用户选择的日期和时间设置为当前工作笔记的提醒日期，并启用提醒 mWorkingNote.setAlertDate(date, true); } }); // 显示日期和时间选择对话框，允许用户选择提醒日期和时间 dateTimePickerDialog.show(); } /** * 分享笔记给支持 {@link Intent#ACTION_SEND} 操作和 {@text/plain} 类型的应用程序。 * * @param context 上下文对象，用于启动分享操作 * @param info 要分享的笔记内容 */ private void sendTo(Context context, String info) { // 创建一个意图，设置操作为发送操作 Intent intent = new Intent(Intent.ACTION_SEND); // 将笔记内容作为额外文本添加到意图中 intent.putExtra(Intent.EXTRA_TEXT, info); // 指定意图的数据类型为纯文本 intent.setType("text/plain"); // 启动分享操作，允许用户选择要分享的应用程序 context.startActivity(intent); } /** * 创建新的笔记。 * * 首先，保存当前正在编辑的笔记。 * 然后，为了安全起见，启动一个新的 NoteEditActivity。 * 最后，将新的笔记添加到当前文件夹中。 */ private void createNewNote() { // 首先，保存当前正在编辑的笔记 saveNote(); // 为了安全起见，结束当前活动 finish(); // 创建一个意图，指定启动 NoteEditActivity，并传递相关参数 Intent intent = new Intent(this, NoteEditActivity.class); intent.setAction(Intent.ACTION_INSERT_OR_EDIT); intent.putExtra(Notes.INTENT_EXTRA_FOLDER_ID, mWorkingNote.getFolderId()); // 启动新的 NoteEditActivity startActivity(intent); } /** * 删除当前笔记。 * * 如果当前笔记存在于数据库中，将其删除。如果处于同步模式下， * 则将笔记移动到垃圾箱文件夹。如果不处于同步模式下，直接删除笔记。 * * 在删除之后，将当前笔记标记为已删除。 */ private void deleteCurrentNote() { // 检查当前笔记是否存在于数据库中 if (mWorkingNote.existInDatabase()) { // 创建一个包含当前笔记ID的 HashSet HashSet ids = new HashSet(); long id = mWorkingNote.getNoteId(); // 如果笔记ID不是根文件夹ID，则将其添加到 HashSet 中 if (id != Notes.ID_ROOT_FOLDER) { ids.add(id); } else { Log.d(TAG, "错误的笔记ID，不应该发生"); } // 如果不处于同步模式下，直接批量删除笔记 if (!isSyncMode()) { if (!DataUtils.batchDeleteNotes(getContentResolver(), ids)) { Log.e(TAG, "删除笔记出错"); } } // 如果处于同步模式下，将笔记移动到垃圾箱文件夹 else { if (!DataUtils.batchMoveToFolder(getContentResolver(), ids, Notes.ID_TRASH_FOLER)) { Log.e(TAG, "将笔记移动到垃圾箱文件夹出错，不应该发生"); } } } // 标记当前笔记为已删除 mWorkingNote.markDeleted(true); } /** * 检查是否处于同步模式。 * * 如果已设置同步账户名称，返回 true；否则返回 false。 */ private boolean isSyncMode() { return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0; } /** * 当时钟提醒设置发生变化时触发的方法。 * * 如果用户要设置时钟提醒，但当前笔记尚未保存，先保存笔记。 * 然后，根据笔记的ID创建一个定时提醒的意图，将其与笔记关联。 * 最后，使用 AlarmManager 设置或取消提醒，并在设置提醒时显示提醒标题。 * * @param date 要设置的提醒时间 * @param set 指定是否设置提醒 */ public void onClockAlertChanged(long date, boolean set) { if (!mWorkingNote.existInDatabase()) { // 如果当前笔记尚未保存，先保存笔记 saveNote(); } if (mWorkingNote.getNoteId() > 0) { // 如果笔记ID大于0，表示笔记已保存，可以设置提醒 // 创建一个意图，用于触发时钟提醒，将其与笔记关联 Intent intent = new Intent(this, AlarmReceiver.class); 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 设置提醒时间 alarmManager.set(AlarmManager.RTC_WAKEUP, date, pendingIntent); } } else { // 如果没有笔记ID，提醒用户应该输入内容 Log.e(TAG, "时钟提醒设置错误"); showToast(R.string.error_note_empty_for_clock); } } /** * 当小部件状态发生变化时触发的方法。 * * 该方法用于更新小部件的显示状态和内容。 */ public void onWidgetChanged() { updateWidget(); } /** * 当删除文本编辑框中的文本时触发的方法。 * * @param index 要删除的文本编辑框的索引 * @param text 被删除的文本 */ public void onEditTextDelete(int index, String text) { int childCount = mEditTextList.getChildCount(); 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 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); } /** * 当在文本编辑框中输入回车键时触发的方法。 * * @param index 要插入新文本编辑框的索引 * @param text 要插入的文本 */ public void onEditTextEnter(int index, String text) { // 检查索引是否超出 mEditTextList 的范围，这种情况不应该发生 if (index > mEditTextList.getChildCount()) { Log.e(TAG, "Index out of mEditTextList boundary, should not happen"); } // 创建新的视图并将其添加到 mEditTextList 中的指定索引位置 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); } } /** * 切换到列表模式的私有方法。 * * 该方法用于将编辑器切换到列表模式，根据输入的文本将文本拆分成列表项，并在列表中显示。 * * @param text 要切换为列表模式的文本 */ private void switchToListMode(String text) { // 移除所有现有的文本编辑框视图 mEditTextList.removeAllViews(); // 将输入文本按行拆分成列表项 String[] items = text.split("\n"); int index = 0; // 遍历拆分后的列表项并将它们添加到 mEditTextList 中 for (String item : items) { if (!TextUtils.isEmpty(item)) { mEditTextList.addView(getListItem(item, index)); index++; } } // 添加一个空的文本编辑框用于用户新增项目 mEditTextList.addView(getListItem("", index)); // 设置焦点在新增的空文本编辑框上 mEditTextList.getChildAt(index).findViewById(R.id.et_edit_text).requestFocus(); // 隐藏笔记编辑器视图 mNoteEditor.setVisibility(View.GONE); // 显示文本列表视图 mEditTextList.setVisibility(View.VISIBLE); } /** * 获取高亮查询结果的可变字符串。 * * 该方法用于将用户的查询关键词在文本中高亮显示。它会创建一个包含完整文本的可变字符串，然后根据用户查询的关键词将匹配的部分高亮显示。 * * @param fullText 完整文本内容 * @param userQuery 用户的查询关键词 * @return 一个可变字符串，其中匹配用户查询的关键词已被高亮显示 */ 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); 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; } /** * 获取列表项视图。 * * 该方法用于创建和配置一个包含文本和复选框的列表项视图。它根据传入的文本和索引生成列表项，并处理复选框的状态以及文本的格式。 * * @param item 列表项的文本内容 * @param index 列表项的索引 * @return 一个包含文本和复选框的列表项视图 */ 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); CheckBox cb = ((CheckBox) view.findViewById(R.id.cb_edit_item)); // 设置文本样式根据字体大小 edit.setTextAppearance(this, TextAppearanceResources.getTexAppearanceResource(mFontSizeId)); // 复选框状态变化监听器，处理文本样式 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)) { // 文本以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)) { // 文本以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; } /** * 当文本内容发生变化时，根据索引和文本内容的存在性更新复选框的可见性。 * * @param index 列表项的索引 * @param hasText 表示是否存在文本内容 */ 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); } } /** * 当检查列表模式发生变化时，根据新旧模式执行相应的操作。 * * @param oldMode 旧的检查列表模式 * @param newMode 新的检查列表模式 */ 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); } } /** * 获取工作文本，根据当前笔记的检查列表模式处理文本内容，并更新工作笔记。 * * @return 如果存在已选中的项目，则返回 true，否则返回 false */ 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 中 sb.append(TAG_CHECKED).append(" ").append(edit.getText()).append("\n"); hasChecked = true; // 更新已选中标记 } else { // 如果项目未选中，添加未选中标记并文本内容到 sb 中 sb.append(TAG_UNCHECKED).append(" ").append(edit.getText()).append("\n"); } } } mWorkingNote.setWorkingText(sb.toString()); // 更新工作笔记的文本内容 } else { mWorkingNote.setWorkingText(mNoteEditor.getText().toString()); // 如果不是检查列表模式，直接使用编辑器内容 } return hasChecked; // 返回是否存在已选中的项目 } /** * 保存笔记的方法。该方法会获取工作文本内容，然后尝试保存笔记。 * * @return 如果成功保存笔记，返回 true；否则返回 false。 */ private boolean saveNote() { getWorkingText(); // 获取工作文本 boolean saved = mWorkingNote.saveNote(); // 尝试保存笔记 if (saved) { /** * 有两种模式，从列表视图切换到编辑视图，打开一个笔记，创建/编辑一个节点。 * 打开节点需要在从编辑视图返回时返回到列表中的原始位置，而创建一个新节点需要返回到列表的顶部。 * 此代码 {@link #RESULT_OK} 用于标识创建/编辑状态。 */ setResult(RESULT_OK); // 设置结果为成功 } return saved; // 返回是否成功保存笔记 } /** * 发送至桌面的方法。在将消息发送到桌面之前，需要确保当前编辑的笔记存在于数据库中。 * 因此，对于新笔记，首先要保存它。 */ private void sendToDesktop() { if (!mWorkingNote.existInDatabase()) { saveNote(); // 如果当前编辑的笔记不存在于数据库中，需要先保存它 } if (mWorkingNote.getNoteId() > 0) { Intent sender = new Intent(); Intent shortcutIntent = new Intent(this, NoteEditActivity.class); shortcutIntent.setAction(Intent.ACTION_VIEW); shortcutIntent.putExtra(Intent.EXTRA_UID, mWorkingNote.getNoteId()); sender.putExtra(Intent.EXTRA_SHORTCUT_INTENT, shortcutIntent); sender.putExtra(Intent.EXTRA_SHORTCUT_NAME, makeShortcutIconTitle(mWorkingNote.getContent())); sender.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE, Intent.ShortcutIconResource.fromContext(this, R.drawable.icon_app)); sender.putExtra("duplicate", true); sender.setAction("com.android.launcher.action.INSTALL_SHORTCUT"); showToast(R.string.info_note_enter_desktop); // 显示提示信息，笔记已发送到桌面 sendBroadcast(sender); } else { /** * 有一种情况是用户没有输入任何内容（笔记不值得保存），小米便签没有笔记ID，提醒用户需要输入一些内容。 */ Log.e(TAG, "Send to desktop error"); showToast(R.string.error_note_empty_for_send_to_desktop); // 显示错误信息，笔记为空不能发送到桌面 } } /** * 创建快捷方式图标标题的方法。该方法用于生成快捷方式图标的标题，通常从笔记内容中提取。 * 首先，会移除笔记内容中的特定标记（如已勾选和未勾选标记）。然后，根据快捷方式图标标题的最大长度， * 截取适当长度的内容作为标题返回。 * * @param content 笔记内容，用于生成快捷方式图标标题。 * @return 快捷方式图标标题，根据内容生成并截取到最大长度。 */ 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; } /** * 显示短时长的提示消息。该方法使用指定的资源ID显示短时长的提示消息。 * * @param resId 资源ID，用于获取提示消息内容。 */ private void showToast(int resId) { showToast(resId, Toast.LENGTH_SHORT); // 调用带有时长参数的 showToast 方法，默认使用短时长 } /** * 显示指定时长的提示消息。该方法使用指定的资源ID和时长显示提示消息。 * * @param resId 资源ID，用于获取提示消息内容。 * @param duration 提示消息的显示时长，可以是 Toast.LENGTH_SHORT 或 Toast.LENGTH_LONG。 */ private void showToast(int resId, int duration) { Toast.makeText(this, resId, duration).show(); // 创建 Toast 并显示指定时长的提示消息 } }