/*
 * 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;

// NoteEditActivity类继承自Activity类，并实现了三个接口，用于处理点击事件、笔记设置变化监听和文本视图变化监听。
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的映射关系。
    private static final Map<Integer, Integer> sBgSelectorBtnsMap = new HashMap<Integer, Integer>();
    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);
    }

    // 静态代码块，用于初始化背景选择器选中状态与选中图标资源ID的映射关系。
    private static final Map<Integer, Integer> sBgSelectorSelectionMap = new HashMap<Integer, Integer>();
    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);
    }

    // 静态代码块，用于初始化字体大小选择器按钮与字体大小资源ID的映射关系。
    private static final Map<Integer, Integer> sFontSizeBtnsMap = new HashMap<Integer, Integer>();
    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);
    }

    // 静态代码块，用于初始化字体大小选择器选中状态与选中图标资源ID的映射关系。
    private static final Map<Integer, Integer> sFontSelectorSelectionMap = new HashMap<Integer, Integer>();
    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; // 字体大小的ID

    // 用于存储用户偏好字体大小的键。
    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;

    // onCreate方法，用于初始化Activity。
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        this.setContentView(R.layout.note_edit);

        // 如果没有保存的状态或者初始化Activity状态失败，则结束Activity。
        if (savedInstanceState == null && !initActivityState(getIntent())) {
            finish();
            return;
        }
        initResources();
    }

    // onRestoreInstanceState方法，用于在Activity从杀死状态恢复时恢复之前的状态。
    @Override
    protected void onRestoreInstanceState(Bundle savedInstanceState) {
        super.onRestoreInstanceState(savedInstanceState);
        // 如果保存的状态中包含Intent的额外数据，则尝试恢复Activity状态。
        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");
        }
    }

    // initActivityState方法，用于初始化Activity的状态。
    private boolean initActivityState(Intent intent) {
        // 如果Intent动作是VIEW，但是没有提供ID，则跳转到笔记列表Activity。
        mWorkingNote = null;
        if (TextUtils.equals(Intent.ACTION_VIEW, intent.getAction())) {
            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);
            }

            // 如果笔记ID在数据库中不可见，则跳转到笔记列表Activity并显示错误信息。
            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())) {
            // 新建笔记
            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;
    }

    // 当Activity重新获得焦点时调用，用于初始化笔记屏幕。
@Override
protected void onResume() {
    super.onResume();
    initNoteScreen();
}

// 初始化笔记屏幕的方法。
private void initNoteScreen() {
    // 设置笔记编辑器的文本外观，根据字体大小ID来决定。
    mNoteEditor.setTextAppearance(this, TextAppearanceResources
            .getTexAppearanceResource(mFontSizeId));
    // 如果笔记是 checklist 模式，则切换到列表模式。
    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));

    // 显示或隐藏提醒头部。
    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);
    }
}

// 当接收到新的Intent时调用，用于重新初始化Activity状态。
@Override
protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    initActivityState(intent);
}

// 当Activity状态需要被保存时调用，用于保存当前笔记的状态。
@Override
protected void onSaveInstanceState(Bundle outState) {
    super.onSaveInstanceState(outState);
    // 如果笔记还没有保存，先保存笔记，以确保有ID可以保存状态。
    if (!mWorkingNote.existInDatabase()) {
        saveNote();
    }
    outState.putLong(Intent.EXTRA_UID, mWorkingNote.getNoteId());
    Log.d(TAG, "Save working note 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) {
    int []location = new int[2];
    view.getLocationOnScreen(location);
    int x = location[0];
    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);
    mFontSizeId = mSharedPrefs.getInt(PREFERENCE_FONT_SIZE, ResourceParser.BG_DEFAULT_FONT_SIZE);
    // 修复存储资源ID在SharedPreferences中的错误。
    if(mFontSizeId >= TextAppearanceResources.getResourcesSize()) {
        mFontSizeId = ResourceParser.BG_DEFAULT_FONT_SIZE;
    }
    mEditTextList = (LinearLayout) findViewById(R.id.note_edit_list);
}

// 当Activity暂停时调用，用于保存笔记数据。
@Override
protected void onPause() {
    super.onPause();
    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;
    }

    intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS, new int[] {
            mWorkingNote.getWidgetId()
    });

    sendBroadcast(intent);
    setResult(RESULT_OK, intent);
}

// 处理点击事件的方法。
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)) {
        // 如果点击的是背景颜色按钮，则更新笔记的背景颜色ID并隐藏选择器。
        findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility(
                View.GONE);
        mWorkingNote.setBgColorId(sBgSelectorBtnsMap.get(id));
        mNoteBgColorSelector.setVisibility(View.GONE);
    } else if (sFontSizeBtnsMap.containsKey(id)) {
        // 如果点击的是字体大小按钮，则更新笔记的字体大小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();
    // 然后调用基类的onBackPressed方法，完成默认的返回操作。
    super.onBackPressed();
}

private boolean clearSettingState() {
    // 检查背景颜色选择器是否可见，如果是，则隐藏它，并返回true表示状态已清除。
    if (mNoteBgColorSelector.getVisibility() == View.VISIBLE) {
        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) {
    // 在准备选项菜单时，首先检查Activity是否正在结束，如果是，则不进行任何操作。
    if (isFinishing()) {
        return true;
    }
    // 清除任何弹出的设置界面。
    clearSettingState();
    // 清除菜单中的所有项目。
    menu.clear();
    // 根据笔记所在的文件夹ID决定加载哪个菜单资源。
    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);
    }
    // 返回true表示菜单已经准备好。
    return true;
}

@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) {
                            // 删除当前笔记，并结束Activity。
                            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:
            // 获取当前笔记的内容并通过Intent分享。
            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;
    }
    // 返回true表示菜单项点击事件已处理。
    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.putExtra(Intent.EXTRA_TEXT, info);
    intent.setType("text/plain");
    // 启动一个新的Activity，分享笔记内容。
    context.startActivity(intent);
}

private void createNewNote() {
    // 首先保存当前编辑的笔记。
    saveNote();

    // 结束当前Activity，准备启动一个新的Activity。
    finish();
    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()) {
        HashSet<Long> ids = new HashSet<Long>();
        long id = mWorkingNote.getNoteId();
        if (id != Notes.ID_ROOT_FOLDER) {
            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() {
    // 检查是否有同步账户名被设置，如果有，则返回true表示是同步模式。
    return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0;
}

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 = 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) {
            // 如果set为false，则取消闹钟。
            alarmManager.cancel(pendingIntent);
        } else {
            // 如果set为true，则设置闹钟。
            alarmManager.set(AlarmManager.RTC_WAKEUP, date, pendingIntent);
        }
    } else {
        // 如果笔记ID不大于0，说明笔记未保存，记录错误日志，并提示用户输入内容。
        Log.e(TAG, "Clock alert setting error");
        showToast(R.string.error_note_empty_for_clock);
    }
}
// 当小部件数据发生变化时调用此方法。
public void onWidgetChanged() {
    updateWidget(); // 更新小部件以反映数据的变化。
}

// 当编辑框中的文本被删除时调用此方法。
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); // 将光标设置到追加文本的末尾。
}

// 当编辑框中按下回车键时调用此方法。
public void onEditTextEnter(int index, String text) {
    // 调试检查，确保索引没有超出编辑列表的范围。
    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"); // 按行分割文本。
    int index = 0; // 初始化索引。
    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); // 显示编辑列表。
}

// 获取高亮显示搜索结果的Spannable对象。
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; // 返回高亮显示的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; // 返回列表项视图。
}

// 文本变化时调用此方法，用于更新复选框的显示状态。
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);
    }
}

// 列表模式改变时调用此方法，用于在列表模式和编辑模式之间切换。
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) {
        // 如果保存成功，设置结果码为RESULT_OK，表示笔记已创建或编辑。
        setResult(RESULT_OK);
    }
    return saved; // 返回保存是否成功。
}

// 发送到桌面的方法，用于创建桌面快捷方式。
private void sendToDesktop() {
    // 在发送消息到桌面之前，确保当前编辑的笔记存在于数据库中。对于新笔记，首先需要保存它。
        if (!mWorkingNote.existInDatabase()) {
            saveNote();
        }

		if (mWorkingNote.getNoteId() > 0) {
			Intent sender = new Intent(); // 创建一个Intent用于发送快捷方式。
			Intent shortcutIntent = new Intent(this, NoteEditActivity.class); // 创建一个Intent用于打开笔记。
			shortcutIntent.setAction(Intent.ACTION_VIEW); // 设置动作为查看。
			shortcutIntent.putExtra(Intent.EXTRA_UID, mWorkingNote.getNoteId()); // 传递笔记ID。
			sender.putExtra(Intent.EXTRA_SHORTCUT_INTENT, shortcutIntent); // 设置快捷方式的Intent。
			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);
		}
    }

	// 创建快捷方式图标标题的方法，用于生成快捷方式的标题。
    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的提示。
    private void showToast(int resId) {
        showToast(resId, Toast.LENGTH_SHORT); // 调用另一个重载方法，设置提示的持续时间为短。
    }

	// 显示提示的方法，用于显示指定资源ID和持续时间的提示。
    private void showToast(int resId, int duration) {
        Toast.makeText(this, resId, duration).show();// 创建并显示提示。
    }
}
