From 4f540113535ab227a2f6cd4c9f024036fe55202f Mon Sep 17 00:00:00 2001 From: lixing <15206816379@163.com> Date: Wed, 25 Dec 2024 23:24:19 +0800 Subject: [PATCH] 1 --- src/AlarmAlertActivity.java | 196 +++++++ src/AlarmInitReceiver.java | 110 ++++ src/AlarmReceiver.java | 47 ++ src/DateTimePicker.java | 526 +++++++++++++++++++ src/DateTimePickerDialog.java | 98 ++++ src/DropdownMenu.java | 67 +++ src/FoldersListAdapter.java | 88 ++++ src/NoteEditActivity.java | 936 ++++++++++++++++++++++++++++++++++ src/NoteEditText.java | 228 +++++++++ src/NoteItemData.java | 259 ++++++++++ 10 files changed, 2555 insertions(+) create mode 100644 src/AlarmAlertActivity.java create mode 100644 src/AlarmInitReceiver.java create mode 100644 src/AlarmReceiver.java create mode 100644 src/DateTimePicker.java create mode 100644 src/DateTimePickerDialog.java create mode 100644 src/DropdownMenu.java create mode 100644 src/FoldersListAdapter.java create mode 100644 src/NoteEditActivity.java create mode 100644 src/NoteEditText.java create mode 100644 src/NoteItemData.java diff --git a/src/AlarmAlertActivity.java b/src/AlarmAlertActivity.java new file mode 100644 index 0000000..1116628 --- /dev/null +++ b/src/AlarmAlertActivity.java @@ -0,0 +1,196 @@ +java +/* + * 版权所有 (c) 2010-2011, MiCode 开源社区 (www.micode.net) + * + * 本文件根据 Apache License, Version 2.0 (以下简称“许可证”) 授权使用。 + * 除非符合许可证的要求，否则您不得使用本文件。 + * 您可以在以下网址获取许可证副本： + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * 除非适用法律要求或以书面形式同意，根据许可证分发的软件 + * 将在“按现状”的基础上分发， + * 不提供任何明示或暗示的保证或条件。 + * 请参阅许可证以了解控制权限和 + * 许可证下的限制。 + */ + +// 声明当前类所在的包名，这是组织代码和资源的一种方式。 +package net.micode.notes.ui; + +// 导入Activity类，它是Android应用中的一个组件，用于提供用户界面。 +import android.app.Activity; + +// 导入AlertDialog类，它是一个对话框，可以包含标题、消息、按钮等，用于向用户显示信息或接收用户输入。 +import android.app.AlertDialog; + +// 导入Context类，它提供了关于应用环境的全局信息，是许多Android API调用的必需参数。 +import android.content.Context; + +// 导入DialogInterface接口，它是AlertDialog和Dialog类的父接口，用于处理对话框事件（如按钮点击）。 +import android.content.DialogInterface; + +// 导入Intent类，它是Android中用于不同组件（如Activity、Service、BroadcastReceiver）之间通信的主要机制。 +import android.content.Intent; + +// 导入AudioManager类，它用于管理音频输出，如调整音量、设置铃声模式等。 +import android.media.AudioManager; + +// 导入MediaPlayer类，它用于播放音频和视频文件。 +import android.media.MediaPlayer; + +// 导入RingtoneManager类，它用于访问和播放设备上的铃声。 +import android.media.RingtoneManager; + +// 导入Uri类，它表示一个统一资源标识符（URI），用于标识一个资源的位置。 +import android.net.Uri; + +// 导入Bundle类，它用于传递数据，通常用于Activity之间的数据传递。 +import android.os.Bundle; + +// 导入PowerManager类，它用于控制设备的电源状态，如唤醒设备或保持屏幕常亮。 +import android.os.PowerManager; + +// 导入Settings类，它包含了访问系统级设置的API，如音量、屏幕亮度等。 +import android.provider.Settings; + +// 导入Window类，它表示一个窗口，通常用于设置Activity的窗口属性，如全屏模式、无标题栏等。 +import android.view.Window; + +// 导入WindowManager类，它用于管理窗口的布局和属性，如设置窗口的尺寸、位置、透明度等。 +import android.view.WindowManager; + +// 导入R类，它是一个自动生成的类，包含了应用中所有的资源ID，如布局、字符串、图片等。 +import net.micode.notes.R; + +// 导入Notes类，这可能是自定义的，用于封装与笔记相关的数据访问逻辑（如数据库操作）。 +import net.micode.notes.data.Notes; + +// 导入DataUtils类，这可能是自定义的工具类，用于执行一些与数据相关的实用功能。 +import net.micode.notes.tool.DataUtils; + +// 导入IOException类，它是Java中的一个异常类，表示输入输出操作失败或中断。 +import java.io.IOException; + +// 闹钟提醒活动类，用于显示提醒对话框并播放提醒声音 +public class AlarmAlertActivity extends Activity implements DialogInterface.OnClickListener, DialogInterface.OnDismissListener { + // 笔记ID + private long mNoteId; + // 笔记摘要 + private String mSnippet; + // 摘要预览最大长度 + private static final int SNIPPET_PREW_MAX_LEN = 60; + // 播放器对象 + MediaPlayer mPlayer; + + @Override + protected void onCreate(Bundle savedInstanceState) { + super.onCreate(savedInstanceState); + // 请求无标题窗口特性 + requestWindowFeature(Window.FEATURE_NO_TITLE); + + final Window win = getWindow(); + // 允许在锁屏时显示窗口 + win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED); + + // 如果屏幕未点亮，则添加保持屏幕点亮、点亮屏幕等标志 + if (!isScreenOn()) { + win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON + | WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON + | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON + | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR); + } + + // 从启动此活动的Intent中获取笔记ID和摘要 + Intent intent = getIntent(); + try { + mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1)); + mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId); + // 如果摘要超过最大长度，则截断并添加省略号 + mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet.substring(0, SNIPPET_PREW_MAX_LEN) + getResources().getString(R.string.notelist_string_info) : mSnippet; + } catch (IllegalArgumentException e) { + e.printStackTrace(); + return; + } + + mPlayer = new MediaPlayer(); + // 如果笔记在数据库中可见且类型为笔记，则显示对话框并播放提醒声音 + if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) { + showActionDialog(); + playAlarmSound(); + } else { + finish(); // 否则结束活动 + } + } + + // 检查屏幕是否点亮 + private boolean isScreenOn() { + PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE); + return pm.isScreenOn(); + } + + // 播放提醒声音 + private void playAlarmSound() { + Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM); + + // 检查静音模式是否影响闹钟声音 + int silentModeStreams = Settings.System.getInt(getContentResolver(), Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0); + + if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM)) != 0) { + mPlayer.setAudioStreamType(silentModeStreams); + } else { + mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM); + } + try { + mPlayer.setDataSource(this, url); + mPlayer.prepare(); + mPlayer.setLooping(true); // 设置循环播放 + mPlayer.start(); + } catch (Exception e) { + e.printStackTrace(); + } + } + + // 显示操作对话框 + private void showActionDialog() { + AlertDialog.Builder dialog = new AlertDialog.Builder(this); + dialog.setTitle(R.string.app_name); + dialog.setMessage(mSnippet); + dialog.setPositiveButton(R.string.notealert_ok, this); // 确定按钮 + // 如果屏幕已点亮，则添加取消按钮 + if (isScreenOn()) { + dialog.setNegativeButton(R.string.notealert_enter, this); + } + dialog.show().setOnDismissListener(this); // 设置对话框消失监听器 + } + + // 按钮点击事件处理 + public void onClick(DialogInterface dialog, int which) { + switch (which) { + case DialogInterface.BUTTON_NEGATIVE: // 取消按钮点击事件 + Intent intent = new Intent(this, NoteEditActivity.class); + intent.setAction(Intent.ACTION_VIEW); + intent.putExtra(Intent.EXTRA_UID, mNoteId); + startActivity(intent); // 跳转到笔记编辑活动 + break; + default: + break; + } + } + + // 对话框消失事件处理 + public void onDismiss(DialogInterface dialog) { + stopAlarmSound(); // 停止播放提醒声音 + finish(); // 结束活动 + } + + // 停止播放提醒声音 + private void stopAlarmSound() { + if (mPlayer != null) { + mPlayer.stop(); + mPlayer.release(); // 释放资源 + mPlayer = null; + } + } +} +//这段代码是一个Android应用程序的一部分，用于实现闹钟提醒功能。当触发提醒时，它会显示一个对话框，显示笔记的摘要，并播放提醒声音。用户可以选择点击确定按钮关闭对话框和声音，或者如果屏幕已点亮，还可以选择点击取消按钮进入笔记编辑界面。 \ No newline at end of file diff --git a/src/AlarmInitReceiver.java b/src/AlarmInitReceiver.java new file mode 100644 index 0000000..7dc5290 --- /dev/null +++ b/src/AlarmInitReceiver.java @@ -0,0 +1,110 @@ +/* + * 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. + */ + +// 声明当前类所在的包名，这是Android项目结构的一部分，用于组织代码和资源。 +package net.micode.notes.ui; + +// 导入Android框架中的AlarmManager类，用于设置闹钟（提醒）在特定时间触发。 +import android.app.AlarmManager; + +// 导入PendingIntent类，它代表一个将要执行的动作的引用，通常与AlarmManager或NotificationManager一起使用。 +import android.app.PendingIntent; + +// 导入BroadcastReceiver类，它是一个可以接收并响应来自其他应用或系统的广播消息的组件。 +import android.content.BroadcastReceiver; + +// 导入ContentUris类，它提供了一些静态方法，用于操作URI，特别是与内容提供者交互时生成或解析特定记录的URI。 +import android.content.ContentUris; + +// 导入Context类，它提供了关于应用环境的全局信息，是许多Android API调用的必需参数。 +import android.content.Context; + +// 导入Intent类，它是Android中用于不同组件（如Activity、Service、BroadcastReceiver）之间通信的主要机制。 +import android.content.Intent; + +// 导入Cursor类，它用于遍历查询数据库返回的结果集。 +import android.database.Cursor; + +// 导入Notes类，这可能是自定义的，用于封装与笔记相关的数据访问逻辑（如数据库操作）。 +import net.micode.notes.data.Notes; + +// 导入NoteColumns类，这通常是Notes类的一个内部类，用于定义笔记数据表中的列名。 +import net.micode.notes.data.Notes.NoteColumns; + + +/** + * AlarmInitReceiver 类：一个 BroadcastReceiver，用于初始化闹钟。 + * + * 当接收到广播时，此接收器会查询数据库中所有设置了提醒日期且提醒日期在当前时间之后的笔记。 + * 对于每个符合条件的笔记，它会设置一个 AlarmManager 闹钟，该闹钟会在笔记的提醒日期触发 AlarmReceiver。 + * + * 具体步骤如下： + * 1. 获取当前时间。 + * 2. 查询数据库中所有提醒日期在当前时间之后且类型为普通笔记的条目。 + * 3. 遍历查询结果，为每个符合条件的笔记设置闹钟。 + * - 创建一个指向 AlarmReceiver 的 Intent，并设置其数据为笔记的 URI。 + * - 创建一个 PendingIntent，以便在闹钟触发时广播该 Intent。 + * - 使用 AlarmManager 设置一个闹钟，在笔记的提醒日期触发 PendingIntent。 + */ +public class AlarmInitReceiver extends BroadcastReceiver { + + // 定义查询投影，只选择 ID 和 提醒日期 字段 + private static final String [] PROJECTION = new String [] { + NoteColumns.ID, + NoteColumns.ALERTED_DATE + }; + + // 定义投影中字段的索引 + private static final int COLUMN_ID = 0; + private static final int COLUMN_ALERTED_DATE = 1; + + @Override + public void onReceive(Context context, Intent intent) { + // 获取当前时间 + long currentDate = System.currentTimeMillis(); + + // 查询数据库中所有提醒日期在当前时间之后且类型为普通笔记的条目 + Cursor c = context.getContentResolver().query(Notes.CONTENT_NOTE_URI, + PROJECTION, + NoteColumns.ALERTED_DATE + ">? AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE, + new String[] { String.valueOf(currentDate) }, + null); + + // 如果查询结果不为空，则遍历结果 + if (c != null) { + if (c.moveToFirst()) { + do { + // 获取笔记的提醒日期 + long alertDate = c.getLong(COLUMN_ALERTED_DATE); + + // 创建一个指向 AlarmReceiver 的 Intent，并设置其数据为笔记的 URI + Intent sender = new Intent(context, AlarmReceiver.class); + sender.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, c.getLong(COLUMN_ID))); + + // 创建一个 PendingIntent，以便在闹钟触发时广播该 Intent + PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, sender, 0); + + // 获取 AlarmManager 实例，并设置闹钟 + AlarmManager alarmManager = (AlarmManager) context.getSystemService(Context.ALARM_SERVICE); + alarmManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent); + } while (c.moveToNext()); + } + // 关闭游标 + c.close(); + } + } +} +//AlarmInitReceiver 是一个 BroadcastReceiver，用于根据数据库中笔记的提醒日期设置闹钟。 \ No newline at end of file diff --git a/src/AlarmReceiver.java b/src/AlarmReceiver.java new file mode 100644 index 0000000..0befc08 --- /dev/null +++ b/src/AlarmReceiver.java @@ -0,0 +1,47 @@ +/* + * 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; + +// 导入BroadcastReceiver类，它是一个可以接收并响应来自其他应用或系统的广播消息的组件。 +// 在Android中，广播是一种在组件之间传递信息的机制。 +import android.content.BroadcastReceiver; + +// 导入Context类，它提供了关于应用环境的全局信息。 +// Context是一个抽象类，它的实现类（如Activity、Service等）允许访问特定资源和类， +// 以及调用应用级别的操作，如启动活动、广播和接收意图等。 +import android.content.Context; + +// 导入Intent类，它是Android中用于不同组件（如Activity、Service、BroadcastReceiver） +// 之间通信以及请求动作的主要机制。Intent可以携带数据，并指定要执行的动作。 +import android.content.Intent; + +// 定义一个名为AlarmReceiver的类，继承自BroadcastReceiver +public class AlarmReceiver extends BroadcastReceiver { + // 重写onReceive方法，用于接收广播并处理 + @Override + public void onReceive(Context context, Intent intent) { + // 设置Intent的目标Activity为AlarmAlertActivity + intent.setClass(context, AlarmAlertActivity.class); + // 为Intent添加FLAG_ACTIVITY_NEW_TASK标志，表示在新的任务栈中启动Activity + intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); + // 使用context启动目标Activity + context.startActivity(intent); + } +} + +// AlarmReceiver是一个BroadcastReceiver子类，用于接收广播并在接收到广播时启动AlarmAlertActivity。 diff --git a/src/DateTimePicker.java b/src/DateTimePicker.java new file mode 100644 index 0000000..c57c635 --- /dev/null +++ b/src/DateTimePicker.java @@ -0,0 +1,526 @@ +/* + * 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 java.text.DateFormatSymbols; // 用于日期格式化的符号 +import java.util.Calendar; // 用于日期和时间操作的类 + +import net.micode.notes.R; // 导入项目的资源文件 + +import android.content.Context; // Android的上下文对象，用于访问应用程序的资源和类 +import android.text.format.DateFormat; // 用于格式化日期和时间 +import android.view.View; // 用于定义和操作视图的类 +import android.widget.FrameLayout; // 用于布局的类，可以包含其他视图 +import android.widget.NumberPicker; // 用于数字选择的控件 + +// DateTimePicker类继承自FrameLayout，用于选择日期和时间 +public class DateTimePicker extends FrameLayout { + // 定义一些常量 + private static final boolean DEFAULT_ENABLE_STATE = true; // 默认启用状态 + private static final int HOURS_IN_HALF_DAY = 12; // 半天的小时数 + private static final int HOURS_IN_ALL_DAY = 24; // 一天的小时数 + private static final int DAYS_IN_ALL_WEEK = 7; // 一周的天数 + private static final int DATE_SPINNER_MIN_VAL = 0; // 日期选择器的最小值 + private static final int DATE_SPINNER_MAX_VAL = DAYS_IN_ALL_WEEK - 1; // 日期选择器的最大值 + private static final int HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW = 0; // 24小时制下小时选择器的最小值 + private static final int HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW = 23; // 24小时制下小时选择器的最大值 + private static final int HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW = 1; // 12小时制下小时选择器的最小值 + private static final int HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW = 12; // 12小时制下小时选择器的最大值 + private static final int MINUT_SPINNER_MIN_VAL = 0; // 分钟选择器的最小值 + private static final int MINUT_SPINNER_MAX_VAL = 59; // 分钟选择器的最大值 + private static final int AMPM_SPINNER_MIN_VAL = 0; // AM/PM选择器的最小值 + private static final int AMPM_SPINNER_MAX_VAL = 1; // AM/PM选择器的最大值 + + // 定义NumberPicker控件 + private final NumberPicker mDateSpinner; // 日期选择器 + private final NumberPicker mHourSpinner; // 小时选择器 + private final NumberPicker mMinuteSpinner; // 分钟选择器 + private final NumberPicker mAmPmSpinner; // AM/PM选择器 + private Calendar mDate; // 用于存储日期和时间的Calendar对象 + + // 用于显示日期的字符串数组 + private String[] mDateDisplayValues = new String[DAYS_IN_ALL_WEEK]; + + // 一些状态标志 + private boolean mIsAm; // 是否为上午 + private boolean mIs24HourView; // 是否为24小时视图 + private boolean mIsEnabled = DEFAULT_ENABLE_STATE; // 是否启用 + private boolean mInitialising; // 是否正在初始化 + + // 定义日期时间改变监听器接口 + private OnDateTimeChangedListener mOnDateTimeChangedListener; + + // 当日期改变时的监听器 + private NumberPicker.OnValueChangeListener mOnDateChangedListener = new NumberPicker.OnValueChangeListener() { + @Override + public void onValueChange(NumberPicker picker, int oldVal, int newVal) { + // 当日期改变时，更新Calendar对象和日期选择器 + mDate.add(Calendar.DAY_OF_YEAR, newVal - oldVal); + updateDateControl(); + onDateTimeChanged(); + } + }; + + // 当小时改变时的监听器 + private NumberPicker.OnValueChangeListener mOnHourChangedListener = new NumberPicker.OnValueChangeListener() { + @Override + public void onValueChange(NumberPicker picker, int oldVal, int newVal) { + // 当小时改变时，更新Calendar对象和小时选择器 + boolean isDateChanged = false; + Calendar cal = Calendar.getInstance(); + // 处理12小时制的情况 + if (!mIs24HourView) { + // 如果从PM切换到AM，日期减1 + if (!mIsAm && oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY) { + cal.setTimeInMillis(mDate.getTimeInMillis()); + cal.add(Calendar.DAY_OF_YEAR, 1); + isDateChanged = true; + } else if (mIsAm && oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) { + cal.setTimeInMillis(mDate.getTimeInMillis()); + cal.add(Calendar.DAY_OF_YEAR, -1); + isDateChanged = true; + } + // 切换AM/PM + if (oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY || + oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) { + mIsAm = !mIsAm; + updateAmPmControl(); + } + } else { + // 处理24小时制的情况 + if (oldVal == HOURS_IN_ALL_DAY - 1 && newVal == 0) { + cal.setTimeInMillis(mDate.getTimeInMillis()); + cal.add(Calendar.DAY_OF_YEAR, 1); + isDateChanged = true; + } else if (oldVal == 0 && newVal == HOURS_IN_ALL_DAY - 1) { + cal.setTimeInMillis(mDate.getTimeInMillis()); + cal.add(Calendar.DAY_OF_YEAR, -1); + isDateChanged = true; + } + } + // 更新小时 + int newHour = mHourSpinner.getValue() % HOURS_IN_HALF_DAY + (mIsAm ? 0 : HOURS_IN_HALF_DAY); + mDate.set(Calendar.HOUR_OF_DAY, newHour); + onDateTimeChanged(); + if (isDateChanged) { + setCurrentYear(cal.get(Calendar.YEAR)); + setCurrentMonth(cal.get(Calendar.MONTH)); + setCurrentDay(cal.get(Calendar.DAY_OF_MONTH)); + } + } + }; + + // 当分钟改变时的监听器 + private NumberPicker.OnValueChangeListener mOnMinuteChangedListener = new NumberPicker.OnValueChangeListener() { + @Override + public void onValueChange(NumberPicker picker, int oldVal, int newVal) { + // 当分钟改变时，更新Calendar对象和分钟选择器 + int minValue = mMinuteSpinner.getMinValue(); + int maxValue = mMinuteSpinner.getMaxValue(); + int offset = 0; + if (oldVal == maxValue && newVal == minValue) { + offset += 1; + } else if (oldVal == minValue && newVal == maxValue) { + offset -= 1; + } + if (offset != 0) { + mDate.add(Calendar.HOUR_OF_DAY, offset); + mHourSpinner.setValue(getCurrentHour()); + updateDateControl(); + int newHour = getCurrentHourOfDay(); + if (newHour >= HOURS_IN_HALF_DAY) { + mIsAm = false; + updateAmPmControl(); + } else { + mIsAm = true; + updateAmPmControl(); + } + } + mDate.set(Calendar.MINUTE, newVal); + onDateTimeChanged(); + } + }; + + // 当AM/PM改变时的监听器 + private NumberPicker.OnValueChangeListener mOnAmPmChangedListener = new NumberPicker.OnValueChangeListener() { + @Override + public void onValueChange(NumberPicker picker, int oldVal, int newVal) { + // 当AM/PM改变时，更新Calendar对象和AM/PM选择器 + mIsAm = !mIsAm; + if (mIsAm) { + mDate.add(Calendar.HOUR_OF_DAY, -HOURS_IN_HALF_DAY); + } else { + mDate.add(Calendar.HOUR_OF_DAY, HOURS_IN_HALF_DAY); + } + updateAmPmControl(); + onDateTimeChanged(); + } + }; +} + +public interface OnDateTimeChangedListener { + // 定义一个接口，用于通知日期时间改变的监听器 + void onDateTimeChanged(DateTimePicker view, int year, int month, + int dayOfMonth, int hourOfDay, int minute); +} + +// DateTimePicker类的构造函数，接收一个Context对象 +public DateTimePicker(Context context) { + this(context, System.currentTimeMillis()); // 调用另一个构造函数，传入当前时间 +} + +// DateTimePicker类的构造函数，接收一个Context对象和一个时间戳 +public DateTimePicker(Context context, long date) { + this(context, date, DateFormat.is24HourFormat(context)); // 调用另一个构造函数，传入是否为24小时制 +} + +// DateTimePicker类的构造函数，接收一个Context对象、一个时间戳和一个布尔值表示是否为24小时制 +public DateTimePicker(Context context, long date, boolean is24HourView) { + super(context); // 调用父类的构造函数 + mDate = Calendar.getInstance(); // 获取当前日期和时间 + mInitialising = true; // 设置初始化标志为true + mIsAm = getCurrentHourOfDay() >= HOURS_IN_HALF_DAY; // 判断当前时间是否为AM + + // inflate布局，将XML布局文件转换成View对象 + inflate(context, R.layout.datetime_picker, this); + + // 初始化日期选择器，并设置监听器 + mDateSpinner = (NumberPicker) findViewById(R.id.date); + mDateSpinner.setMinValue(DATE_SPINNER_MIN_VAL); + mDateSpinner.setMaxValue(DATE_SPINNER_MAX_VAL); + mDateSpinner.setOnValueChangedListener(mOnDateChangedListener); + + // 初始化小时选择器，并设置监听器 + mHourSpinner = (NumberPicker) findViewById(R.id.hour); + mHourSpinner.setOnValueChangedListener(mOnHourChangedListener); + + // 初始化分钟选择器，并设置监听器 + mMinuteSpinner = (NumberPicker) findViewById(R.id.minute); + mMinuteSpinner.setMinValue(MINUT_SPINNER_MIN_VAL); + mMinuteSpinner.setMaxValue(MINUT_SPINNER_MAX_VAL); + mMinuteSpinner.setOnLongPressUpdateInterval(100); // 设置长按更新间隔 + mMinuteSpinner.setOnValueChangedListener(mOnMinuteChangedListener); + + // 初始化AM/PM选择器，并设置监听器 + String[] stringsForAmPm = new DateFormatSymbols().getAmPmStrings(); // 获取AM/PM的字符串数组 + mAmPmSpinner = (NumberPicker) findViewById(R.id.amPm); + mAmPmSpinner.setMinValue(AMPM_SPINNER_MIN_VAL); + mAmPmSpinner.setMaxValue(AMPM_SPINNER_MAX_VAL); + mAmPmSpinner.setDisplayedValues(stringsForAmPm); // 设置显示的值 + mAmPmSpinner.setOnValueChangedListener(mOnAmPmChangedListener); + + // 更新控件到初始状态 + updateDateControl(); + updateHourControl(); + updateAmPmControl(); + + // 设置是否为24小时制 + set24HourView(is24HourView); + + // 设置当前时间 + setCurrentDate(date); + + // 设置控件的启用状态 + setEnabled(isEnabled()); + + // 设置内容描述 + mInitialising = false; // 设置初始化标志为false +} + +@Override +public void setEnabled(boolean enabled) { + // 设置控件的启用状态 + if (mIsEnabled == enabled) { + return; // 如果已经是这个状态，则不进行操作 + } + super.setEnabled(enabled); // 调用父类的方法设置启用状态 + mDateSpinner.setEnabled(enabled); // 设置日期选择器的启用状态 + mMinuteSpinner.setEnabled(enabled); // 设置分钟选择器的启用状态 + mHourSpinner.setEnabled(enabled); // 设置小时选择器的启用状态 + mAmPmSpinner.setEnabled(enabled); // 设置AM/PM选择器的启用状态 + mIsEnabled = enabled; // 更新启用状态标志 +} + +@Override +public boolean isEnabled() { + // 返回控件的启用状态 + return mIsEnabled; +} + +/** + * Get the current date in millis + * + * @return the current date in millis + */ +public long getCurrentDateInTimeMillis() { + // 获取当前日期的时间戳 + return mDate.getTimeInMillis(); +} + +/** + * Set the current date + * + * @param year The current year + * @param month The current month + * @param dayOfMonth The current dayOfMonth + * @param hourOfDay The current hourOfDay + * @param minute The current minute + */ +public void setCurrentDate(int year, int month, + int dayOfMonth, int hourOfDay, int minute) { + // 设置当前日期和时间 + setCurrentYear(year); // 设置年份 + setCurrentMonth(month); // 设置月份 + setCurrentDay(dayOfMonth); // 设置日期 + setCurrentHour(hourOfDay); // 设置小时 + setCurrentMinute(minute); // 设置分钟 +} + +/** + * Get current year + * + * @return The current year + */ +public int getCurrentYear() { + // 获取当前年份 + return mDate.get(Calendar.YEAR); // 从mDate中获取年份 +} + +/** + * Set current year + * + * @param year The current year + */ +public void setCurrentYear(int year) { + // 设置当前年份 + if (!mInitialising && year == getCurrentYear()) { + return; // 如果不是初始化状态且年份未改变，则返回 + } + mDate.set(Calendar.YEAR, year); // 更新mDate中的年份 + updateDateControl(); // 更新日期控件的显示 + onDateTimeChanged(); // 通知日期时间已改变 +} + +/** + * Get current month in the year + * + * @return The current month in the year + */ +public int getCurrentMonth() { + // 获取当前月份 + return mDate.get(Calendar.MONTH); // 从mDate中获取月份 +} + +/** + * Set current month in the year + * + * @param month The month in the year + */ +public void setCurrentMonth(int month) { + // 设置当前月份 + if (!mInitialising && month == getCurrentMonth()) { + return; // 如果不是初始化状态且月份未改变，则返回 + } + mDate.set(Calendar.MONTH, month); // 更新mDate中的月份 + updateDateControl(); // 更新日期控件的显示 + onDateTimeChanged(); // 通知日期时间已改变 +} + +/** + * Get current day of the month + * + * @return The day of the month + */ +public int getCurrentDay() { + // 获取当前日期 + return mDate.get(Calendar.DAY_OF_MONTH); // 从mDate中获取日期 +} + +/** + * Set current day of the month + * + * @param dayOfMonth The day of the month + */ +public void setCurrentDay(int dayOfMonth) { + // 设置当前日期 + if (!mInitialising && dayOfMonth == getCurrentDay()) { + return; // 如果不是初始化状态且日期未改变，则返回 + } + mDate.set(Calendar.DAY_OF_MONTH, dayOfMonth); // 更新mDate中的日期 + updateDateControl(); // 更新日期控件的显示 + onDateTimeChanged(); // 通知日期时间已改变 +} + +/** + * Get current hour in 24 hour mode, in the range (0~23) + * @return The current hour in 24 hour mode + */ +public int getCurrentHourOfDay() { + // 获取当前小时（24小时制），范围为0到23 + return mDate.get(Calendar.HOUR_OF_DAY); // 从mDate中获取小时 +} + +private int getCurrentHour() { + // 获取当前小时，根据是否为24小时制返回不同的值 + if (mIs24HourView) { + return getCurrentHourOfDay(); // 如果是24小时制，直接返回当前小时 + } else { + int hour = getCurrentHourOfDay(); // 获取当前小时 + // 如果小时大于12，返回小时减去12（转换为12小时制） + if (hour > HOURS_IN_HALF_DAY) { + return hour - HOURS_IN_HALF_DAY; + } else { + // 如果小时为0，返回12；否则返回当前小时 + return hour == 0 ? HOURS_IN_HALF_DAY : hour; + } + } +} + +/** + * Set current hour in 24 hour mode, in the range (0~23) + * + * @param hourOfDay 当前小时（24小时制） + */ +public void setCurrentHour(int hourOfDay) { + // 设置当前小时 + if (!mInitialising && hourOfDay == getCurrentHourOfDay()) { + return; // 如果不是初始化状态且小时未改变，则返回 + } + mDate.set(Calendar.HOUR_OF_DAY, hourOfDay); // 更新mDate中的小时 + if (!mIs24HourView) { + // 如果不是24小时制，更新AM/PM状态 + if (hourOfDay >= HOURS_IN_HALF_DAY) { + mIsAm = false; // 设置为PM + if (hourOfDay > HOURS_IN_HALF_DAY) { + hourOfDay -= HOURS_IN_HALF_DAY; // 转换为12小时制 + } + } else { + mIsAm = true; // 设置为AM + if (hourOfDay == 0) { + hourOfDay = HOURS_IN_HALF_DAY; // 如果小时为0，设置为12 + } + } + updateAmPmControl(); // 更新AM/PM控件 + } + mHourSpinner.setValue(hourOfDay); // 更新小时选择器的值 + onDateTimeChanged(); // 通知日期时间已改变 +} + +/** + * Get currentMinute + * + * @return The Current Minute + */ +public int getCurrentMinute() { + // 获取当前分钟 + return mDate.get(Calendar.MINUTE); // 从mDate中获取分钟 +} + +/** + * Set current minute + */ +public void setCurrentMinute(int minute) { + // 设置当前分钟 + if (!mInitialising && minute == getCurrentMinute()) { + return; // 如果不是初始化状态且分钟未改变，则返回 + } + mMinuteSpinner.setValue(minute); // 更新分钟选择器的值 + mDate.set(Calendar.MINUTE, minute); // 更新mDate中的分钟 + onDateTimeChanged(); // 通知日期时间已改变 +} + +/** + * @return true if this is in 24 hour view else false. + */ +public boolean is24HourView() { + // 返回当前是否为24小时制 + return mIs24HourView; // 返回24小时制状态 +} + +/** + * Set whether in 24 hour or AM/PM mode. + * + * @param is24HourView True for 24 hour mode. False for AM/PM mode. + */ +public void set24HourView(boolean is24HourView) { + // 设置是否为24小时制或AM/PM模式 + if (mIs24HourView == is24HourView) { + return; // 如果当前状态与传入状态相同，则返回 + } + mIs24HourView = is24HourView; // 更新24小时制状态 + mAmPmSpinner.setVisibility(is24HourView ? View.GONE : View.VISIBLE); // 根据模式设置AM/PM选择器的可见性 + int hour = getCurrentHourOfDay(); // 获取当前小时 + updateHourControl(); // 更新小时控件 + setCurrentHour(hour); // 设置当前小时 + updateAmPmControl(); // 更新AM/PM控件 +} + +private void updateDateControl() { + // 更新日期选择器的显示值 + Calendar cal = Calendar.getInstance(); // 获取当前时间 + cal.setTimeInMillis(mDate.getTimeInMillis()); // 设置为当前日期 + cal.add(Calendar.DAY_OF_YEAR, -DAYS_IN_ALL_WEEK / 2 - 1); // 调整为显示的起始日期 + mDateSpinner.setDisplayedValues(null); // 清空显示值 + // 填充日期显示值 + for (int i = 0; i < DAYS_IN_ALL_WEEK; ++i) { + cal.add(Calendar.DAY_OF_YEAR, 1); // 增加一天 + mDateDisplayValues[i] = (String) DateFormat.format("MM.dd EEEE", cal); // 格式化日期 + } + mDateSpinner.setDisplayedValues(mDateDisplayValues); // 设置日期选择器的显示值 + mDateSpinner.setValue(DAYS_IN_ALL_WEEK / 2); // 设置选择器的当前值为中间值 + mDateSpinner.invalidate(); // 刷新选择器 +} + +private void updateAmPmControl() { + // 更新AM/PM选择器的显示 + if (mIs24HourView) { + mAmPmSpinner.setVisibility(View.GONE); // 隐藏AM/PM选择器 + } else { + int index = mIsAm ? Calendar.AM : Calendar.PM; // 根据当前状态设置索引 + mAmPmSpinner.setValue(index); // 设置AM/PM选择器的值 + mAmPmSpinner.setVisibility(View.VISIBLE); // 显示AM/PM选择器 + } +} + +private void updateHourControl() { + // 更新小时选择器的范围 + if (mIs24HourView) { + mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW); // 设置24小时制下的最小值 + mHourSpinner.setMaxValue(HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW); // 设置24小时制下的最大值 + } else { + mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW); // 设置12小时制下的最小值 + mHourSpinner.setMaxValue(HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW); // 设置12小时制下的最大值 + } +} + +/** + * Set the callback that indicates the 'Set' button has been pressed. + * @param callback the callback, if null will do nothing + */ +public void setOnDateTimeChangedListener(OnDateTimeChangedListener callback) { + // 设置日期时间改变的监听器 + mOnDateTimeChangedListener = callback; // 更新监听器 +} + +private void onDateTimeChanged() { + // 通知日期时间已改变 + if (mOnDateTimeChangedListener != null) { + // 如果监听器不为空，调用其方法 + mOnDateTimeChangedListener.onDateTimeChanged(this, getCurrentYear(), + getCurrentMonth(), getCurrentDay(), getCurrentHourOfDay(), getCurrentMinute()); + } +} \ No newline at end of file diff --git a/src/DateTimePickerDialog.java b/src/DateTimePickerDialog.java new file mode 100644 index 0000000..749d6ff --- /dev/null +++ b/src/DateTimePickerDialog.java @@ -0,0 +1,98 @@ +/* + * 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 java.util.Calendar; // 导入用于日期和时间操作的类 + +import net.micode.notes.R; // 导入项目的资源文件 +import net.micode.notes.ui.DateTimePicker; // 导入DateTimePicker类 +import net.micode.notes.ui.DateTimePicker.OnDateTimeChangedListener; // 导入日期时间变化监听器接口 + +import android.app.AlertDialog; // 导入AlertDialog类 +import android.content.Context; // 导入上下文类 +import android.content.DialogInterface; // 导入对话框接口 +import android.content.DialogInterface.OnClickListener; // 导入对话框点击监听器接口 +import android.text.format.DateFormat; // 导入日期格式化类 +import android.text.format.DateUtils; // 导入日期工具类 + +// 自定义的日期时间选择对话框类，继承自AlertDialog并实现OnClickListener接口 +public class DateTimePickerDialog extends AlertDialog implements OnClickListener { + + private Calendar mDate = Calendar.getInstance(); // 用于存储当前日期和时间 + private boolean mIs24HourView; // 是否为24小时制 + private OnDateTimeSetListener mOnDateTimeSetListener; // 日期时间设置监听器 + private DateTimePicker mDateTimePicker; // 日期时间选择器实例 + + // 定义日期时间设置监听器接口 + public interface OnDateTimeSetListener { + void OnDateTimeSet(AlertDialog dialog, long date); // 设置日期时间的方法 + } + + // 构造函数，接收上下文和时间戳 + public DateTimePickerDialog(Context context, long date) { + super(context); // 调用父类构造函数 + mDateTimePicker = new DateTimePicker(context); // 创建日期时间选择器实例 + setView(mDateTimePicker); // 设置对话框的视图为日期时间选择器 + // 设置日期时间变化监听器 + mDateTimePicker.setOnDateTimeChangedListener(new OnDateTimeChangedListener() { + public void onDateTimeChanged(DateTimePicker view, int year, int month, + int dayOfMonth, int hourOfDay, int minute) { + // 当日期时间变化时，更新mDate对象 + mDate.set(Calendar.YEAR, year); + mDate.set(Calendar.MONTH, month); + mDate.set(Calendar.DAY_OF_MONTH, dayOfMonth); + mDate.set(Calendar.HOUR_OF_DAY, hourOfDay); + mDate.set(Calendar.MINUTE, minute); + updateTitle(mDate.getTimeInMillis()); // 更新对话框标题 + } + }); + mDate.setTimeInMillis(date); // 设置mDate为传入的时间戳 + mDate.set(Calendar.SECOND, 0); // 将秒数设置为0 + mDateTimePicker.setCurrentDate(mDate.getTimeInMillis()); // 设置日期时间选择器的当前日期 + setButton(context.getString(R.string.datetime_dialog_ok), this); // 设置“确定”按钮 + setButton2(context.getString(R.string.datetime_dialog_cancel), (OnClickListener)null); // 设置“取消”按钮 + set24HourView(DateFormat.is24HourFormat(this.getContext())); // 设置24小时制 + updateTitle(mDate.getTimeInMillis()); // 更新对话框标题 + } + + // 设置是否为24小时制 + public void set24HourView(boolean is24HourView) { + mIs24HourView = is24HourView; // 更新24小时制状态 + } + + // 设置日期时间设置监听器 + public void setOnDateTimeSetListener(OnDateTimeSetListener callBack) { + mOnDateTimeSetListener = callBack; // 更新监听器 + } + + // 更新对话框标题 + private void updateTitle(long date) { + int flag = + DateUtils.FORMAT_SHOW_YEAR | // 显示年份 + DateUtils.FORMAT_SHOW_DATE | // 显示日期 + DateUtils.FORMAT_SHOW_TIME; // 显示时间 + flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_12HOUR; // 根据模式设置24小时或12小时格式 + setTitle(DateUtils.formatDateTime(this.getContext(), date, flag)); // 格式化并设置对话框标题 + } + + // 处理按钮点击事件 + public void onClick(DialogInterface arg0, int arg1) { + if (mOnDateTimeSetListener != null) { + // 如果监听器不为空，调用其方法 + mOnDateTimeSetListener.OnDateTimeSet(this, mDate.getTimeInMillis()); + } + } +} \ No newline at end of file diff --git a/src/DropdownMenu.java b/src/DropdownMenu.java new file mode 100644 index 0000000..3f79e11 --- /dev/null +++ b/src/DropdownMenu.java @@ -0,0 +1,67 @@ +/* + * 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.content.Context; // 导入上下文类 +import android.view.Menu; // 导入菜单类 +import android.view.MenuItem; // 导入菜单项类 +import android.view.View; // 导入视图类 +import android.view.View.OnClickListener; // 导入视图点击监听器接口 +import android.widget.Button; // 导入按钮类 +import android.widget.PopupMenu; // 导入弹出菜单类 +import android.widget.PopupMenu.OnMenuItemClickListener; // 导入弹出菜单项点击监听器接口 + +import net.micode.notes.R; // 导入项目的资源文件 + +// 自定义下拉菜单类 +public class DropdownMenu { + private Button mButton; // 按钮实例 + private PopupMenu mPopupMenu; // 弹出菜单实例 + private Menu mMenu; // 菜单实例 + + // 构造函数，接收上下文、按钮和菜单资源ID + public DropdownMenu(Context context, Button button, int menuId) { + mButton = button; // 初始化按钮 + mButton.setBackgroundResource(R.drawable.dropdown_icon); // 设置按钮背景为下拉图标 + mPopupMenu = new PopupMenu(context, mButton); // 创建弹出菜单，指定上下文和锚点视图 + mMenu = mPopupMenu.getMenu(); // 获取菜单实例 + mPopupMenu.getMenuInflater().inflate(menuId, mMenu); // 从资源ID加载菜单项 + // 设置按钮的点击事件，显示弹出菜单 + mButton.setOnClickListener(new OnClickListener() { + public void onClick(View v) { + mPopupMenu.show(); // 显示弹出菜单 + } + }); + } + + // 设置下拉菜单项点击监听器 + public void setOnDropdownMenuItemClickListener(OnMenuItemClickListener listener) { + if (mPopupMenu != null) { + mPopupMenu.setOnMenuItemClickListener(listener); // 设置菜单项点击监听器 + } + } + + // 根据菜单项ID查找菜单项 + public MenuItem findItem(int id) { + return mMenu.findItem(id); // 返回对应ID的菜单项 + } + + // 设置按钮的标题 + public void setTitle(CharSequence title) { + mButton.setText(title); // 更新按钮文本为指定标题 + } +} \ No newline at end of file diff --git a/src/FoldersListAdapter.java b/src/FoldersListAdapter.java new file mode 100644 index 0000000..4fa2f4a --- /dev/null +++ b/src/FoldersListAdapter.java @@ -0,0 +1,88 @@ +/* + * 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.content.Context; // 导入上下文类 +import android.database.Cursor; // 导入游标类，用于访问数据库查询结果 +import android.view.View; // 导入视图类 +import android.view.ViewGroup; // 导入视图组类 +import android.widget.CursorAdapter; // 导入游标适配器类 +import android.widget.LinearLayout; // 导入线性布局类 +import android.widget.TextView; // 导入文本视图类 + +import net.micode.notes.R; // 导入项目的资源文件 +import net.micode.notes.data.Notes; // 导入Notes类，包含笔记数据模型 +import net.micode.notes.data.Notes.NoteColumns; // 导入笔记列定义 + +// 自定义的文件夹列表适配器类，继承自CursorAdapter +public class FoldersListAdapter extends CursorAdapter { + // 定义查询笔记数据库时需要的列 + public static final String [] PROJECTION = { + NoteColumns.ID, // 笔记ID + NoteColumns.SNIPPET // 笔记摘要 + }; + + // 定义列索引常量 + public static final int ID_COLUMN = 0; // ID列索引 + public static final int NAME_COLUMN = 1; // 名称列索引 + + // 构造函数，接收上下文和游标 + public FoldersListAdapter(Context context, Cursor c) { + super(context, c); // 调用父类构造函数 + } + + // 创建新的列表项视图 + @Override + public View newView(Context context, Cursor cursor, ViewGroup parent) { + return new FolderListItem(context); // 返回一个新的FolderListItem视图 + } + + // 绑定数据到列表项视图 + @Override + public void bindView(View view, Context context, Cursor cursor) { + if (view instanceof FolderListItem) { + // 获取文件夹名称，如果是根文件夹则使用特殊字符串 + String folderName = (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context + .getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN); + ((FolderListItem) view).bind(folderName); // 将文件夹名称绑定到视图 + } + } + + // 根据位置获取文件夹名称 + public String getFolderName(Context context, int position) { + Cursor cursor = (Cursor) getItem(position); // 获取指定位置的游标 + return (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context + .getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN); // 返回文件夹名称 + } + + // 自定义的文件夹列表项视图类，继承自LinearLayout + private class FolderListItem extends LinearLayout { + private TextView mName; // 用于显示文件夹名称的文本视图 + + // 构造函数，接收上下文 + public FolderListItem(Context context) { + super(context); + inflate(context, R.layout.folder_list_item, this); // 从XML布局文件中加载视图 + mName = (TextView) findViewById(R.id.tv_folder_name); // 获取文件夹名称文本视图 + } + + // 绑定文件夹名称到视图 + public void bind(String name) { + mName.setText(name); // 设置文本视图的文本 + } + } +} \ No newline at end of file diff --git a/src/NoteEditActivity.java b/src/NoteEditActivity.java new file mode 100644 index 0000000..3e13024 --- /dev/null +++ b/src/NoteEditActivity.java @@ -0,0 +1,936 @@ +/* + * 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; // 导入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; // 导入内容URI工具类 +import android.content.Context; // 导入上下文类 +import android.content.DialogInterface; // 导入对话框接口 +import android.content.Intent; // 导入意图类 +import android.content.SharedPreferences; // 导入共享偏好设置类 +import android.graphics.Paint; // 导入画笔类 +import android.os.Bundle; // 导入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; // 导入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; // 导入2x小部件提供者类 +import net.micode.notes.widget.NoteWidgetProvider_4x; // 导入4x小部件提供者类 + +import java.util.HashMap; // 导入哈希映射类 +import java.util.HashSet; // 导入哈希集合类 +import java.util.Map; // 导入映射类 +import java.util.regex.Matcher; // 导入正则表达式匹配器类 +import java.util.regex.Pattern; // 导入正则表达式类 + +// 笔记编辑活动类，继承自Activity +public class NoteEditActivity extends Activity implements OnClickListener, + NoteSettingChangedListener, OnTextViewChangeListener { + + // 头部视图持有者类，用于存储头部视图中的组件 + private class HeadViewHolder { + public TextView tvModified; // 最近修改时间文本视图 + public ImageView ivAlertIcon; // 警告图标视图 + public TextView tvAlertDate; // 警告日期文本视图 + public ImageView ibSetBgColor; // 设置背景颜色的图标视图 + } + + // 背景选择器按钮映射 + private static final Map sBgSelectorBtnsMap = new HashMap(); + 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(); + 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(); + 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(); + 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; // 正则表达式模式 + +@Override +protected void onCreate(Bundle savedInstanceState) { + super.onCreate(savedInstanceState); // 调用父类的onCreate方法 + this.setContentView(R.layout.note_edit); // 设置内容视图为note_edit布局 + + 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 + */ +@Override +protected void onRestoreInstanceState(Bundle savedInstanceState) { + super.onRestoreInstanceState(savedInstanceState); // 调用父类的onRestoreInstanceState方法 + 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)); // 添加UID到意图 + if (!initActivityState(intent)) { // 初始化活动状态 + finish(); // 如果状态初始化失败，则结束活动 + return; + } + Log.d(TAG, "Restoring from killed activity"); // 日志记录恢复活动状态 + } +} + +private boolean initActivityState(Intent intent) { + /** + * If the user specified the {@link Intent#ACTION_VIEW} but not provided with id, + * then jump to the NotesListActivity + */ + mWorkingNote = null; // 初始化工作笔记为null + if (TextUtils.equals(Intent.ACTION_VIEW, intent.getAction())) { // 如果意图动作是查看 + long noteId = intent.getLongExtra(Intent.EXTRA_UID, 0); // 获取笔记ID + mUserQuery = ""; + + /** + * Starting from the searched result + */ + if (intent.hasExtra(SearchManager.EXTRA_DATA_KEY)) { // 如果有搜索结果 + noteId = Long.parseLong(intent.getStringExtra(SearchManager.EXTRA_DATA_KEY)); // 获取搜索结果中的笔记ID + 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())) { // 如果意图动作是插入或编辑 + // New note + long folderId = intent.getLongExtra(Notes.INTENT_EXTRA_FOLDER_ID, 0); // 获取文件夹ID + int widgetId = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID); // 获取小部件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)); // 获取背景资源ID + + // Parse call-record note + 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) { // 如果根据电话号码和通话日期获取到笔记ID + 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; // 返回成功 +} +@Override +protected void onResume() { + super.onResume(); // 调用父类的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)); + + // 显示提醒头部 + showAlertHeader(); +} + +private void showAlertHeader() { + // 如果工作笔记有闹钟提醒 + if (mWorkingNote.hasClockAlert()) { + long time = System.currentTimeMillis(); // 获取当前时间 + // 如果当前时间超过了提醒时间 + if (time > mWorkingNote.getAlertDate()) { + mNoteHeaderHolder.tvAlertDate.setText(R.string.note_alert_expired); // 设置提醒时间为“已过期” + } else { + // 显示相对时间，例如“3小时前” + 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); // 调用父类的onNewIntent方法 + initActivityState(intent); // 重新初始化活动状态 +} + +@Override +protected void onSaveInstanceState(Bundle outState) { + super.onSaveInstanceState(outState); // 调用父类的onSaveInstanceState方法 + /** + * 对于没有笔记ID的新笔记，我们应该先保存它以生成ID。 + * 如果正在编辑的笔记不值得保存，那么没有ID，这等同于创建新笔记。 + */ + if (!mWorkingNote.existInDatabase()) { // 如果笔记不在数据库中 + saveNote(); // 保存笔记 + } + outState.putLong(Intent.EXTRA_UID, mWorkingNote.getNoteId()); // 将笔记ID保存到Bundle + Log.d(TAG, "Save working note id: " + mWorkingNote.getNoteId() + " onSaveInstanceState"); // 日志记录保存的笔记ID +} + +@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); // 调用父类的dispatchTouchEvent方法 +} + +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); + // 获取字体大小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} + */ + if(mFontSizeId >= TextAppearanceResources.getResourcesSize()) { + mFontSizeId = ResourceParser.BG_DEFAULT_FONT_SIZE; + } + // 初始化编辑文本列表 + mEditTextList = (LinearLayout) findViewById(R.id.note_edit_list); +} + +@Override +protected void onPause() { + super.onPause(); // 调用父类的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; + } + + // 添加小部件ID到意图 + intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS, new int[] { + mWorkingNote.getWidgetId() + }); + + // 发送广播更新小部件 + sendBroadcast(intent); + setResult(RESULT_OK, intent); // 设置结果码和意图 +} + +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); // 隐藏当前选中的背景颜色 + mWorkingNote.setBgColorId(sBgSelectorBtnsMap.get(id)); // 更新工作笔记的背景颜色ID + mNoteBgColorSelector.setVisibility(View.GONE); // 隐藏背景颜色选择器 + } else if (sFontSizeBtnsMap.containsKey(id)) { // 如果点击的是字体大小选择器按钮 + findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.GONE); // 隐藏当前选中的字体大小 + mFontSizeId = sFontSizeBtnsMap.get(id); // 更新字体大小ID + mSharedPrefs.edit().putInt(PREFERENCE_FONT_SIZE, mFontSizeId).commit(); // 保存字体大小ID到共享偏好设置 + 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(); // 调用父类的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; + } + return false; // 没有设置状态被清除，返回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; // 返回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) { + 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 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 = new Intent(Intent.ACTION_SEND); + intent.putExtra(Intent.EXTRA_TEXT, info); // 设置分享的文本内容 + intent.setType("text/plain"); // 设置分享的内容类型 + context.startActivity(intent); // 启动分享意图 +} + +private void createNewNote() { + // 保存当前编辑的笔记 + saveNote(); + // 结束当前活动，以确保新的笔记编辑活动可以启动 + finish(); + // 创建新的笔记编辑意图 + Intent intent = new Intent(this, NoteEditActivity.class); + intent.setAction(Intent.ACTION_INSERT_OR_EDIT); // 设置动作为插入或编辑 + intent.putExtra(Notes.INTENT_EXTRA_FOLDER_ID, mWorkingNote.getFolderId()); // 添加文件夹ID + startActivity(intent); // 启动新的笔记编辑活动 +} +private void deleteCurrentNote() { + // 如果笔记存在于数据库中 + if (mWorkingNote.existInDatabase()) { + HashSet ids = new HashSet(); // 创建一个ID集合 + long id = mWorkingNote.getNoteId(); // 获取笔记ID + // 如果笔记ID不是根文件夹ID（一个特殊的ID） + if (id != Notes.ID_ROOT_FOLDER) { + ids.add(id); // 将笔记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; +} + +public void onClockAlertChanged(long date, boolean set) { + /** + * 用户可能为未保存的笔记设置闹钟，因此在设置闹钟之前，我们应该先保存笔记 + */ + if (!mWorkingNote.existInDatabase()) { // 如果笔记不在数据库中 + saveNote(); // 保存笔记 + } + if (mWorkingNote.getNoteId() > 0) { // 如果笔记有ID + Intent intent = new Intent(this, AlarmReceiver.class); // 创建闹钟接收器的意图 + intent.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, mWorkingNote.getNoteId())); // 设置数据URI + 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 { + /** + * 用户输入为空（笔记不值得保存），我们没有笔记ID，提醒用户输入内容 + */ + 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); // 显示编辑文本列表 +} + +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; // 返回可变文本 +} + +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) { + /** + * 有两种模式从列表视图切换到编辑视图，打开一个笔记或创建/编辑一个笔记。 + * 打开笔记需要在返回编辑视图时恢复原来的列表位置，而创建新笔记则需要在列表顶部。 + * 这段代码中的{@link #RESULT_OK}用于标识创建/编辑状态 + */ + setResult(RESULT_OK); // 设置结果为OK，表示笔记已成功保存 + } + return saved; // 返回保存结果 +} + +private void sendToDesktop() { + /** + * 在发送消息到主屏幕之前，我们需要确保当前编辑的笔记存在于数据库中。 + * 因此，对于新笔记，首先保存它 + */ + if (!mWorkingNote.existInDatabase()) { // 如果笔记不在数据库中 + saveNote(); // 保存笔记 + } + + if (mWorkingNote.getNoteId() > 0) { // 如果笔记ID有效 + Intent sender = new Intent(); // 创建意图 + Intent shortcutIntent = new Intent(this, NoteEditActivity.class); // 创建快捷方式意图 + shortcutIntent.setAction(Intent.ACTION_VIEW); // 设置意图动作为查看 + shortcutIntent.putExtra(Intent.EXTRA_UID, mWorkingNote.getNoteId()); // 添加笔记ID到意图 + 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); // 显示错误提示 + } +} + +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.makeText(this, resId, duration).show(); // 创建并显示吐司 +} \ No newline at end of file diff --git a/src/NoteEditText.java b/src/NoteEditText.java new file mode 100644 index 0000000..f3fab98 --- /dev/null +++ b/src/NoteEditText.java @@ -0,0 +1,228 @@ +/* + * 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.content.Context; // 导入上下文类 +import android.graphics.Rect; // 导入矩形类 +import android.text.Layout; // 导入文本布局类 +import android.text.Selection; // 导入文本选择类 +import android.text.Spanned; // 导入可变文本类 +import android.text.TextUtils; // 导入文本工具类 +import android.text.style.URLSpan; // 导入URL样式类 +import android.util.AttributeSet; // 导入属性集类 +import android.util.Log; // 导入日志工具类 +import android.view.ContextMenu; // 导入上下文菜单类 +import android.view.KeyEvent; // 导入按键事件类 +import android.view.MenuItem; // 导入菜单项类 +import android.view.MenuItem.OnMenuItemClickListener; // 导入菜单项点击监听器接口 +import android.view.MotionEvent; // 导入触摸事件类 +import android.widget.EditText; // 导入编辑文本类 + +import net.micode.notes.R; // 导入项目的资源文件 + +import java.util.HashMap; // 导入哈希映射类 +import java.util.Map; // 导入映射类 + +// 自定义的编辑文本类，继承自EditText +public class NoteEditText extends EditText { + private static final String TAG = "NoteEditText"; // 定义日志标签 + private int mIndex; // 索引 + private int mSelectionStartBeforeDelete; // 删除前的选择起始位置 + + private static final String SCHEME_TEL = "tel:"; // 电话协议 + private static final String SCHEME_HTTP = "http:"; // HTTP协议 + private static final String SCHEME_EMAIL = "mailto:"; // 邮件协议 + + private static final Map sSchemaActionResMap = new HashMap(); // 协议动作资源映射 + static { + sSchemaActionResMap.put(SCHEME_TEL, R.string.note_link_tel); // 电话协议动作 + sSchemaActionResMap.put(SCHEME_HTTP, R.string.note_link_web); // HTTP协议动作 + sSchemaActionResMap.put(SCHEME_EMAIL, R.string.note_link_email); // 邮件协议动作 + } + + /** + * 由{@link NoteEditActivity}调用以删除或添加编辑文本 + */ + public interface OnTextViewChangeListener { + /** + * 当{@link KeyEvent#KEYCODE_DEL}发生且文本为空时删除当前编辑文本 + */ + void onEditTextDelete(int index, String text); + + /** + * 当{@link KeyEvent#KEYCODE_ENTER}发生时在当前编辑文本后添加编辑文本 + */ + void onEditTextEnter(int index, String text); + + /** + * 当文本变化时隐藏或显示项选项 + */ + void onTextChange(int index, boolean hasText); + } + + private OnTextViewChangeListener mOnTextViewChangeListener; // 文本变化监听器 + + public NoteEditText(Context context) { + super(context, null); // 调用父类构造函数 + mIndex = 0; // 初始化索引 + } + + public void setIndex(int index) { + mIndex = index; // 设置索引 + } + + public void setOnTextViewChangeListener(OnTextViewChangeListener listener) { + mOnTextViewChangeListener = listener; // 设置文本变化监听器 + } + + public NoteEditText(Context context, AttributeSet attrs) { + super(context, attrs, android.R.attr.editTextStyle); // 调用父类构造函数 + } + + public NoteEditText(Context context, AttributeSet attrs, int defStyle) { + super(context, attrs, defStyle); // 调用父类构造函数 + // TODO Auto-generated constructor stub + } + + @Override + public boolean onTouchEvent(MotionEvent event) { + switch (event.getAction()) { + case MotionEvent.ACTION_DOWN: + // 获取触摸事件的X和Y坐标 + int x = (int) event.getX(); + int y = (int) event.getY(); + // 调整坐标以适应总内边距和滚动 + x -= getTotalPaddingLeft(); + y -= getTotalPaddingTop(); + x += getScrollX(); + y += getScrollY(); + + // 获取文本布局 + Layout layout = getLayout(); + // 获取Y坐标对应的行 + int line = layout.getLineForVertical(y); + // 获取X坐标在行中的偏移量 + int off = layout.getOffsetForHorizontal(line, x); + // 设置选择位置 + Selection.setSelection(getText(), off); + break; + } + + return super.onTouchEvent(event); // 调用父类的onTouchEvent方法 + } + + @Override + public boolean onKeyDown(int keyCode, KeyEvent event) { + switch (keyCode) { + case KeyEvent.KEYCODE_ENTER: + if (mOnTextViewChangeListener != null) { + return false; // 如果有文本变化监听器，则消费事件 + } + break; + case KeyEvent.KEYCODE_DEL: + // 记录删除前的选择起始位置 + mSelectionStartBeforeDelete = getSelectionStart(); + break; + default: + break; + } + return super.onKeyDown(keyCode, event); // 调用父类的onKeyDown方法 + } +} + +@Override +public boolean onKeyUp(int keyCode, KeyEvent event) { + // 处理按键释放事件 + switch(keyCode) { + case KeyEvent.KEYCODE_DEL: // 如果是删除键 + if (mOnTextViewChangeListener != null) { // 如果设置了文本变化监听器 + if (0 == mSelectionStartBeforeDelete && mIndex != 0) { // 如果删除前的选择起始位置为0且索引不为0 + mOnTextViewChangeListener.onEditTextDelete(mIndex, getText().toString()); // 调用监听器的删除方法 + return true; // 消费事件 + } else { + Log.d(TAG, "OnTextViewChangeListener was not seted"); // 日志记录未设置监听器 + } + } else { + Log.d(TAG, "OnTextViewChangeListener was not seted"); // 日志记录未设置监听器 + } + break; + case KeyEvent.KEYCODE_ENTER: // 如果是回车键 + if (mOnTextViewChangeListener != null) { // 如果设置了文本变化监听器 + int selectionStart = getSelectionStart(); // 获取选择起始位置 + String text = getText().subSequence(selectionStart, length()).toString(); // 获取选择的文本 + setText(getText().subSequence(0, selectionStart)); // 更新文本，移除选择的文本 + mOnTextViewChangeListener.onEditTextEnter(mIndex + 1, text); // 调用监听器的添加方法 + } else { + Log.d(TAG, "OnTextViewChangeListener was not seted"); // 日志记录未设置监听器 + } + break; + default: + break; + } + return super.onKeyUp(keyCode, event); // 调用父类的onKeyUp方法 +} + +@Override +protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) { + // 处理焦点变化事件 + if (mOnTextViewChangeListener != null) { // 如果设置了文本变化监听器 + if (!focused && TextUtils.isEmpty(getText())) { // 如果失去焦点且文本为空 + mOnTextViewChangeListener.onTextChange(mIndex, false); // 调用监听器的文本变化方法，参数为无文本 + } else { + mOnTextViewChangeListener.onTextChange(mIndex, true); // 调用监听器的文本变化方法，参数为有文本 + } + } + super.onFocusChanged(focused, direction, previouslyFocusedRect); // 调用父类的onFocusChanged方法 +} + +@Override +protected void onCreateContextMenu(ContextMenu menu) { + // 创建上下文菜单 + if (getText() instanceof Spanned) { // 如果文本是可变文本 + int selStart = getSelectionStart(); // 获取选择起始位置 + int selEnd = getSelectionEnd(); // 获取选择结束位置 + + int min = Math.min(selStart, selEnd); // 获取选择范围的最小值 + int max = Math.max(selStart, selEnd); // 获取选择范围的最大值 + + final URLSpan[] urls = ((Spanned) getText()).getSpans(min, max, URLSpan.class); // 获取URL样式 + if (urls.length == 1) { // 如果有一个URL样式 + int defaultResId = 0; // 默认资源ID + for(String schema: sSchemaActionResMap.keySet()) { // 遍历协议动作资源映射 + if(urls[0].getURL().indexOf(schema) >= 0) { // 如果URL包含协议 + defaultResId = sSchemaActionResMap.get(schema); // 获取对应的资源ID + break; + } + } + + if (defaultResId == 0) { // 如果未找到对应的资源ID + defaultResId = R.string.note_link_other; // 使用其他链接的资源ID + } + + // 添加菜单项 + menu.add(0, 0, 0, defaultResId).setOnMenuItemClickListener( + new OnMenuItemClickListener() { + public boolean onMenuItemClick(MenuItem item) { + // 点击菜单项时的处理 + urls[0].onClick(NoteEditText.this); // 调用URL样式的点击事件 + return true; // 消费事件 + } + }); + } + } + super.onCreateContextMenu(menu); // 调用父类的onCreateContextMenu方法 +} \ No newline at end of file diff --git a/src/NoteItemData.java b/src/NoteItemData.java new file mode 100644 index 0000000..15617a3 --- /dev/null +++ b/src/NoteItemData.java @@ -0,0 +1,259 @@ +/* + * 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.content.Context; // 导入上下文类 +import android.database.Cursor; // 导入游标类 +import android.text.TextUtils; // 导入文本工具类 + +import net.micode.notes.data.Contact; // 导入联系人类 +import net.micode.notes.data.Notes; // 导入笔记数据类 +import net.micode.notes.data.Notes.NoteColumns; // 导入笔记列定义 +import net.micode.notes.tool.DataUtils; // 导入数据工具类 + +public class NoteItemData { + // 定义查询笔记数据库时需要的列 + static final String [] PROJECTION = new String [] { + NoteColumns.ID, + NoteColumns.ALERTED_DATE, + NoteColumns.BG_COLOR_ID, + NoteColumns.CREATED_DATE, + NoteColumns.HAS_ATTACHMENT, + NoteColumns.MODIFIED_DATE, + NoteColumns.NOTES_COUNT, + NoteColumns.PARENT_ID, + NoteColumns.SNIPPET, + NoteColumns.TYPE, + NoteColumns.WIDGET_ID, + NoteColumns.WIDGET_TYPE, + }; + + // 定义列索引常量 + private static final int ID_COLUMN = 0; + private static final int ALERTED_DATE_COLUMN = 1; + private static final int BG_COLOR_ID_COLUMN = 2; + private static final int CREATED_DATE_COLUMN = 3; + private static final int HAS_ATTACHMENT_COLUMN = 4; + private static final int MODIFIED_DATE_COLUMN = 5; + private static final int NOTES_COUNT_COLUMN = 6; + private static final int PARENT_ID_COLUMN = 7; + private static final int SNIPPET_COLUMN = 8; + private static final int TYPE_COLUMN = 9; + private static final int WIDGET_ID_COLUMN = 10; + private static final int WIDGET_TYPE_COLUMN = 11; + + // 定义类的成员变量 + private long mId; + private long mAlertDate; + private int mBgColorId; + private long mCreatedDate; + private boolean mHasAttachment; + private long mModifiedDate; + private int mNotesCount; + private long mParentId; + private String mSnippet; + private int mType; + private int mWidgetId; + private int mWidgetType; + private String mName; + private String mPhoneNumber; + + // 定义位置相关的成员变量 + private boolean mIsLastItem; + private boolean mIsFirstItem; + private boolean mIsOnlyOneItem; + private boolean mIsOneNoteFollowingFolder; + private boolean mIsMultiNotesFollowingFolder; + + public NoteItemData(Context context, Cursor cursor) { + // 从游标中获取数据并赋值给成员变量 + mId = cursor.getLong(ID_COLUMN); + mAlertDate = cursor.getLong(ALERTED_DATE_COLUMN); + mBgColorId = cursor.getInt(BG_COLOR_ID_COLUMN); + mCreatedDate = cursor.getLong(CREATED_DATE_COLUMN); + mHasAttachment = (cursor.getInt(HAS_ATTACHMENT_COLUMN) > 0) ? true : false; + mModifiedDate = cursor.getLong(MODIFIED_DATE_COLUMN); + mNotesCount = cursor.getInt(NOTES_COUNT_COLUMN); + mParentId = cursor.getLong(PARENT_ID_COLUMN); + mSnippet = cursor.getString(SNIPPET_COLUMN); + mSnippet = mSnippet.replace(NoteEditActivity.TAG_CHECKED, "").replace( + NoteEditActivity.TAG_UNCHECKED, ""); // 移除特殊标记 + mType = cursor.getInt(TYPE_COLUMN); + mWidgetId = cursor.getInt(WIDGET_ID_COLUMN); + mWidgetType = cursor.getInt(WIDGET_TYPE_COLUMN); + + mPhoneNumber = ""; + // 如果是通话记录文件夹中的笔记 + if (mParentId == Notes.ID_CALL_RECORD_FOLDER) { + mPhoneNumber = DataUtils.getCallNumberByNoteId(context.getContentResolver(), mId); + if (!TextUtils.isEmpty(mPhoneNumber)) { + mName = Contact.getContact(context, mPhoneNumber); + if (mName == null) { + mName = mPhoneNumber; // 如果没有联系人名称，则使用电话号码 + } + } + } + + if (mName == null) { + mName = ""; // 如果没有名称，则设置为空字符串 + } + checkPostion(cursor); // 检查位置 + } + + private void checkPostion(Cursor cursor) { + // 检查是否是最后一项 + mIsLastItem = cursor.isLast() ? true : false; + // 检查是否是第一项 + mIsFirstItem = cursor.isFirst() ? true : false; + // 检查是否只有一项 + mIsOnlyOneItem = (cursor.getCount() == 1); + mIsMultiNotesFollowingFolder = false; // 初始化多笔记标志为false + mIsOneNoteFollowingFolder = false; // 初始化单笔记标志为false + + // 如果是笔记类型且不是第一项 + if (mType == Notes.TYPE_NOTE && !mIsFirstItem) { + int position = cursor.getPosition(); // 获取当前位置 + // 移动到前一项 + if (cursor.moveToPrevious()) { + // 如果前一项是文件夹或系统笔记 + if (cursor.getInt(TYPE_COLUMN) == Notes.TYPE_FOLDER + || cursor.getInt(TYPE_COLUMN) == Notes.TYPE_SYSTEM) { + // 如果后面还有笔记 + if (cursor.getCount() > (position + 1)) { + mIsMultiNotesFollowingFolder = true; // 设置多笔记标志为true + } else { + mIsOneNoteFollowingFolder = true; // 设置单笔记标志为true + } + } + // 移回当前位置 + if (!cursor.moveToNext()) { + throw new IllegalStateException("cursor move to previous but can't move back"); + } + } + } + } +} + +public boolean isOneFollowingFolder() { + // 返回是否有单个笔记跟随文件夹 + return mIsOneNoteFollowingFolder; +} + +public boolean isMultiFollowingFolder() { + // 返回是否有多个笔记跟随文件夹 + return mIsMultiNotesFollowingFolder; +} + +public boolean isLast() { + // 返回是否是最后一项 + return mIsLastItem; +} + +public String getCallName() { + // 返回通话记录中的联系人名称 + return mName; +} + +public boolean isFirst() { + // 返回是否是第一项 + return mIsFirstItem; +} + +public boolean isSingle() { + // 返回是否只有一项 + return mIsOnlyOneItem; +} + +public long getId() { + // 返回笔记ID + return mId; +} + +public long getAlertDate() { + // 返回提醒日期 + return mAlertDate; +} + +public long getCreatedDate() { + // 返回创建日期 + return mCreatedDate; +} + +public boolean hasAttachment() { + // 返回是否有附件 + return mHasAttachment; +} + +public long getModifiedDate() { + // 返回修改日期 + return mModifiedDate; +} + +public int getBgColorId() { + // 返回背景颜色ID + return mBgColorId; +} + +public long getParentId() { + // 返回父ID，通常指文件夹ID + return mParentId; +} + +public int getNotesCount() { + // 返回笔记计数 + return mNotesCount; +} + +public long getFolderId () { + // 返回文件夹ID，与getParentId方法相同 + return mParentId; +} + +public int getType() { + // 返回笔记类型 + return mType; +} + +public int getWidgetType() { + // 返回小部件类型 + return mWidgetType; +} + +public int getWidgetId() { + // 返回小部件ID + return mWidgetId; +} + +public String getSnippet() { + // 返回笔记摘要 + return mSnippet; +} + +public boolean hasAlert() { + // 返回是否有提醒，即提醒日期是否大于0 + return (mAlertDate > 0); +} + +public boolean isCallRecord() { + // 返回是否是通话记录，即是否在通话记录文件夹中且电话号码不为空 + return (mParentId == Notes.ID_CALL_RECORD_FOLDER && !TextUtils.isEmpty(mPhoneNumber)); +} + +public static int getNoteType(Cursor cursor) { + // 从游标中获取笔记类型 + return cursor.getInt(TYPE_COLUMN); +} \ No newline at end of file