From 52b38446bdc4d729c3c04f235508af5a79aecfde Mon Sep 17 00:00:00 2001 From: pv4gs5wt7 <2508757972@qq.com> Date: Thu, 27 Mar 2025 19:31:50 +0800 Subject: [PATCH] zhushi2 --- .../micode/notes/ui/AlarmAlertActivity.java | 47 +++ .../micode/notes/ui/AlarmInitReceiver.java | 30 +- .../net/micode/notes/ui/AlarmReceiver.java | 5 + .../net/micode/notes/ui/DateTimePicker.java | 163 +++++++++ .../micode/notes/ui/DateTimePickerDialog.java | 31 ++ src/src/net/micode/notes/ui/DropdownMenu.java | 27 ++ .../micode/notes/ui/FoldersListAdapter.java | 37 +- .../net/micode/notes/ui/NoteEditActivity.java | 329 ++++++++++++++++-- src/src/net/micode/notes/ui/NoteEditText.java | 94 ++++- src/src/net/micode/notes/ui/NoteItemData.java | 55 ++- .../micode/notes/ui/NotesListActivity.java | 186 ++++++++++ 11 files changed, 937 insertions(+), 67 deletions(-) diff --git a/src/src/net/micode/notes/ui/AlarmAlertActivity.java b/src/src/net/micode/notes/ui/AlarmAlertActivity.java index 85723be..657a3b4 100644 --- a/src/src/net/micode/notes/ui/AlarmAlertActivity.java +++ b/src/src/net/micode/notes/ui/AlarmAlertActivity.java @@ -41,19 +41,26 @@ import java.io.IOException; public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener { + // 定义笔记ID和笔记摘要 private long mNoteId; private String mSnippet; + // 定义笔记摘要的最大预览长度 private static final int SNIPPET_PREW_MAX_LEN = 60; + // 定义MediaPlayer对象用于播放闹钟声音 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 @@ -61,11 +68,15 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR); } + // 获取启动当前Activity的Intent Intent intent = getIntent(); try { + // 从Intent中获取笔记ID mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1)); + // 根据笔记ID获取笔记摘要 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; @@ -74,35 +85,47 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD return; } + // 初始化MediaPlayer对象 mPlayer = new MediaPlayer(); + // 如果笔记在数据库中可见，则显示操作对话框并播放闹钟声音 if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) { showActionDialog(); playAlarmSound(); } else { + // 否则结束当前Activity finish(); } } + // 判断屏幕是否亮起 private boolean isScreenOn() { PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE); return pm.isScreenOn(); } + // 播放闹钟声音 private void playAlarmSound() { + // 获取默认闹钟铃声的Uri Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM); + // 获取当前静音模式下的音频流设置 int silentModeStreams = Settings.System.getInt(getContentResolver(), Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0); + // 如果闹钟音频流在静音模式下受影响，则设置MediaPlayer的音频流类型为静音模式下的音频流类型 if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM)) != 0) { mPlayer.setAudioStreamType(silentModeStreams); } else { mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM); } try { + // 设置MediaPlayer的数据源 mPlayer.setDataSource(this, url); + // 准备MediaPlayer mPlayer.prepare(); + // 设置MediaPlayer循环播放 mPlayer.setLooping(true); + // 开始播放 mPlayer.start(); } catch (IllegalArgumentException e) { // TODO Auto-generated catch block @@ -119,39 +142,63 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD } } + // 定义一个私有方法showActionDialog，用于显示一个操作对话框 private void showActionDialog() { + // 创建一个AlertDialog.Builder对象，用于构建对话框 AlertDialog.Builder dialog = new AlertDialog.Builder(this); + // 设置对话框的标题，使用资源文件中的app_name字符串 dialog.setTitle(R.string.app_name); + // 设置对话框的消息内容，使用成员变量mSnippet的值 dialog.setMessage(mSnippet); + // 设置对话框的确定按钮，按钮文本使用资源文件中的notealert_ok字符串，点击事件监听器为当前对象 dialog.setPositiveButton(R.string.notealert_ok, this); + // 检查屏幕是否处于开启状态 if (isScreenOn()) { + // 如果屏幕开启，则设置对话框的取消按钮，按钮文本使用资源文件中的notealert_enter字符串，点击事件监听器为当前对象 dialog.setNegativeButton(R.string.notealert_enter, this); } + // 显示对话框，并设置对话框消失时的监听器为当前对象 dialog.show().setOnDismissListener(this); } + // 定义一个方法来处理对话框点击事件 public void onClick(DialogInterface dialog, int which) { + // 使用switch语句根据点击的按钮类型进行不同的处理 switch (which) { + // 如果点击的是否定按钮（例如“取消”或“否”） case DialogInterface.BUTTON_NEGATIVE: + // 创建一个新的Intent对象，用于启动NoteEditActivity Intent intent = new Intent(this, NoteEditActivity.class); + // 设置Intent的动作类型为查看（ACTION_VIEW） intent.setAction(Intent.ACTION_VIEW); + // 向Intent中添加一个额外的数据，即笔记的ID intent.putExtra(Intent.EXTRA_UID, mNoteId); + // 启动NoteEditActivity，传递Intent对象 startActivity(intent); break; + // 默认情况下，不进行任何操作 default: break; } } + // 定义一个方法，当对话框被取消或关闭时调用 public void onDismiss(DialogInterface dialog) { + // 调用stopAlarmSound方法，停止报警声音 stopAlarmSound(); + // 调用finish方法，结束当前Activity finish(); } + // 停止报警声音的方法 private void stopAlarmSound() { + // 检查mPlayer对象是否不为空，以避免空指针异常 if (mPlayer != null) { + // 调用mPlayer的stop方法停止播放声音 mPlayer.stop(); + // 调用mPlayer的release方法释放资源 mPlayer.release(); + // 将mPlayer对象设置为null，表示不再使用 mPlayer = null; } } diff --git a/src/src/net/micode/notes/ui/AlarmInitReceiver.java b/src/src/net/micode/notes/ui/AlarmInitReceiver.java index f221202..6db582e 100644 --- a/src/src/net/micode/notes/ui/AlarmInitReceiver.java +++ b/src/src/net/micode/notes/ui/AlarmInitReceiver.java @@ -30,35 +30,51 @@ import net.micode.notes.data.Notes.NoteColumns; public class AlarmInitReceiver extends BroadcastReceiver { + // 定义查询所需的列 private static final String [] PROJECTION = new String [] { - NoteColumns.ID, - NoteColumns.ALERTED_DATE + NoteColumns.ID, // 笔记的ID + NoteColumns.ALERTED_DATE // 笔记的提醒日期 }; - private static final int COLUMN_ID = 0; - private static final int COLUMN_ALERTED_DATE = 1; + + + // 定义列的索引 + private static final int COLUMN_ID = 0; // ID列的索引 + 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); + new String[] { String.valueOf(currentDate) }, // 查询条件参数 + null); // 排序参数 + // 如果查询结果不为空 if (c != null) { + // 如果有记录 if (c.moveToFirst()) { + // 遍历所有记录 do { + // 获取提醒日期 long alertDate = c.getLong(COLUMN_ALERTED_DATE); + // 创建一个新的Intent，用于启动AlarmReceiver Intent sender = new Intent(context, AlarmReceiver.class); + // 设置Intent的数据URI，包含笔记的ID sender.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, c.getLong(COLUMN_ID))); + // 创建PendingIntent，用于延迟执行Intent PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, sender, 0); + // 获取AlarmManager服务 AlarmManager alermManager = (AlarmManager) context .getSystemService(Context.ALARM_SERVICE); + // 设置闹钟，在指定时间唤醒设备并执行Intent alermManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent); - } while (c.moveToNext()); + } while (c.moveToNext()); // 移动到下一条记录 } + // 关闭Cursor c.close(); } } diff --git a/src/src/net/micode/notes/ui/AlarmReceiver.java b/src/src/net/micode/notes/ui/AlarmReceiver.java index 54e503b..a05e61f 100644 --- a/src/src/net/micode/notes/ui/AlarmReceiver.java +++ b/src/src/net/micode/notes/ui/AlarmReceiver.java @@ -20,11 +20,16 @@ import android.content.BroadcastReceiver; import android.content.Context; import android.content.Intent; +// 定义一个名为AlarmReceiver的类，继承自BroadcastReceiver，用于接收广播消息 public class AlarmReceiver extends BroadcastReceiver { + // 重写onReceive方法，该方法会在接收到广播时被调用 @Override public void onReceive(Context context, Intent intent) { + // 将Intent的目标组件设置为AlarmAlertActivity类，即指定广播接收后要启动的Activity intent.setClass(context, AlarmAlertActivity.class); + // 向Intent中添加FLAG_ACTIVITY_NEW_TASK标志，表示启动一个新的任务来承载该Activity intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); + // 使用上下文context启动Activity，传入设置好的Intent对象 context.startActivity(intent); } } diff --git a/src/src/net/micode/notes/ui/DateTimePicker.java b/src/src/net/micode/notes/ui/DateTimePicker.java index 496b0cd..9a0d587 100644 --- a/src/src/net/micode/notes/ui/DateTimePicker.java +++ b/src/src/net/micode/notes/ui/DateTimePicker.java @@ -30,40 +30,66 @@ import android.widget.NumberPicker; 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; + // 24小时制小时选择器的最小值 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; + // 12小时制小时选择器的最小值 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; + // 分钟选择器的最小值 private static final int MINUT_SPINNER_MIN_VAL = 0; + // 分钟选择器的最大值 private static final int MINUT_SPINNER_MAX_VAL = 59; + // AM/PM选择器的最小值 private static final int AMPM_SPINNER_MIN_VAL = 0; + // AM/PM选择器的最大值 private static final int AMPM_SPINNER_MAX_VAL = 1; + // 日期选择器 private final NumberPicker mDateSpinner; + // 小时选择器 private final NumberPicker mHourSpinner; + // 分钟选择器 private final NumberPicker mMinuteSpinner; + // AM/PM选择器 private final NumberPicker mAmPmSpinner; + // 日期对象 private Calendar mDate; + // 日期显示值数组 private String[] mDateDisplayValues = new String[DAYS_IN_ALL_WEEK]; + // 是否为AM private boolean mIsAm; + // 是否为24小时制 private boolean mIs24HourView; + // 是否启用 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) { @@ -73,6 +99,7 @@ public class DateTimePicker extends FrameLayout { } }; + // 小时变化监听器 private NumberPicker.OnValueChangeListener mOnHourChangedListener = new NumberPicker.OnValueChangeListener() { @Override public void onValueChange(NumberPicker picker, int oldVal, int newVal) { @@ -115,6 +142,7 @@ public class DateTimePicker extends FrameLayout { } }; + // 分钟变化监听器 private NumberPicker.OnValueChangeListener mOnMinuteChangedListener = new NumberPicker.OnValueChangeListener() { @Override public void onValueChange(NumberPicker picker, int oldVal, int newVal) { @@ -144,6 +172,7 @@ public class DateTimePicker extends FrameLayout { } }; + // AM/PM变化监听器 private NumberPicker.OnValueChangeListener mOnAmPmChangedListener = new NumberPicker.OnValueChangeListener() { @Override public void onValueChange(NumberPicker picker, int oldVal, int newVal) { @@ -158,39 +187,62 @@ public class DateTimePicker extends FrameLayout { } }; + // 日期时间变化监听器接口 public interface OnDateTimeChangedListener { void onDateTimeChanged(DateTimePicker view, int year, int month, int dayOfMonth, int hourOfDay, int minute); } + // 构造函数 + // 构造函数，用于创建DateTimePicker对象 + // 参数context：上下文对象，用于获取应用环境和资源 public DateTimePicker(Context context) { + // 调用另一个构造函数，传入当前系统时间作为默认时间 + // System.currentTimeMillis()：获取当前系统时间的毫秒值 this(context, System.currentTimeMillis()); } + // 构造函数，用于创建DateTimePicker对象 + // 参数context：上下文对象，用于获取系统资源和配置 + // 参数date：初始日期时间，以毫秒为单位的长整型数值 public DateTimePicker(Context context, long date) { + // 调用另一个构造函数，传入上下文对象、初始日期时间和是否使用24小时制 + // DateFormat.is24HourFormat(context)方法用于判断当前系统是否使用24小时制 this(context, date, DateFormat.is24HourFormat(context)); } + // 构造函数，用于初始化DateTimePicker对象 public DateTimePicker(Context context, long date, boolean is24HourView) { + // 调用父类的构造函数，传入上下文 super(context); + // 初始化Calendar对象，用于存储日期和时间 mDate = Calendar.getInstance(); + // 设置初始化标志为true，表示正在初始化 mInitialising = true; + // 判断当前时间是上午还是下午 mIsAm = getCurrentHourOfDay() >= HOURS_IN_HALF_DAY; + // 加载布局文件datetime_picker.xml，并将其添加到当前视图 inflate(context, R.layout.datetime_picker, this); + // 获取日期选择器NumberPicker，并设置其最小值和最大值 mDateSpinner = (NumberPicker) findViewById(R.id.date); mDateSpinner.setMinValue(DATE_SPINNER_MIN_VAL); mDateSpinner.setMaxValue(DATE_SPINNER_MAX_VAL); + // 设置日期选择器的值变化监听器 mDateSpinner.setOnValueChangedListener(mOnDateChangedListener); + // 获取小时选择器NumberPicker，并设置其值变化监听器 mHourSpinner = (NumberPicker) findViewById(R.id.hour); mHourSpinner.setOnValueChangedListener(mOnHourChangedListener); + // 获取分钟选择器NumberPicker，并设置其最小值、最大值和长按更新间隔 mMinuteSpinner = (NumberPicker) findViewById(R.id.minute); mMinuteSpinner.setMinValue(MINUT_SPINNER_MIN_VAL); mMinuteSpinner.setMaxValue(MINUT_SPINNER_MAX_VAL); mMinuteSpinner.setOnLongPressUpdateInterval(100); + // 设置分钟选择器的值变化监听器 mMinuteSpinner.setOnValueChangedListener(mOnMinuteChangedListener); + // 获取上午/下午选择器NumberPicker，并设置其显示值和值变化监听器 String[] stringsForAmPm = new DateFormatSymbols().getAmPmStrings(); mAmPmSpinner = (NumberPicker) findViewById(R.id.amPm); mAmPmSpinner.setMinValue(AMPM_SPINNER_MIN_VAL); @@ -216,19 +268,28 @@ public class DateTimePicker extends FrameLayout { @Override public void setEnabled(boolean enabled) { + // 检查当前状态是否与要设置的状态相同，如果相同则直接返回，避免重复设置 if (mIsEnabled == enabled) { return; } + // 调用父类的setEnabled方法，设置组件的基本启用状态 super.setEnabled(enabled); + // 设置日期选择器的启用状态 mDateSpinner.setEnabled(enabled); + // 设置分钟选择器的启用状态 mMinuteSpinner.setEnabled(enabled); + // 设置小时选择器的启用状态 mHourSpinner.setEnabled(enabled); + // 设置上午/下午选择器的启用状态 mAmPmSpinner.setEnabled(enabled); + // 更新当前组件的启用状态标志 mIsEnabled = enabled; } + // 重写父类或接口中的isEnabled方法 @Override public boolean isEnabled() { + // 返回成员变量mIsEnabled的值，表示当前对象是否启用 return mIsEnabled; } @@ -246,9 +307,13 @@ public class DateTimePicker extends FrameLayout { * * @param date The current date in millis */ + // 定义一个方法用于设置当前日期和时间 public void setCurrentDate(long date) { + // 获取一个Calendar实例 Calendar cal = Calendar.getInstance(); + // 将传入的日期（以毫秒为单位）设置到Calendar对象中 cal.setTimeInMillis(date); + // 调用另一个重载的setCurrentDate方法，传入年、月、日、小时和分钟 setCurrentDate(cal.get(Calendar.YEAR), cal.get(Calendar.MONTH), cal.get(Calendar.DAY_OF_MONTH), cal.get(Calendar.HOUR_OF_DAY), cal.get(Calendar.MINUTE)); } @@ -262,12 +327,18 @@ public class DateTimePicker extends FrameLayout { * @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); } @@ -276,7 +347,9 @@ public class DateTimePicker extends FrameLayout { * * @return The current year */ + // 定义一个公共方法，用于获取当前年份 public int getCurrentYear() { + // 调用mDate对象的get方法，传入Calendar.YEAR常量，获取当前年份 return mDate.get(Calendar.YEAR); } @@ -285,12 +358,17 @@ public class DateTimePicker extends FrameLayout { * * @param year The current year */ + // 设置当前年份的方法 public void setCurrentYear(int year) { + // 检查是否正在初始化且年份与当前年份相同，如果是则直接返回，不进行任何操作 if (!mInitialising && year == getCurrentYear()) { return; } + // 使用Calendar对象设置日期的年份为传入的年份 mDate.set(Calendar.YEAR, year); + // 更新日期控件，以反映新的年份 updateDateControl(); + // 调用方法处理日期时间变化，可能触发相关事件或更新UI onDateTimeChanged(); } @@ -299,7 +377,10 @@ public class DateTimePicker extends FrameLayout { * * @return The current month in the year */ + // 定义一个公共方法，用于获取当前月份 public int getCurrentMonth() { + // 调用mDate对象的get方法，传入Calendar.MONTH常量，获取当前月份 + // Calendar.MONTH的值是从0开始的，即0代表一月，1代表二月，依此类推 return mDate.get(Calendar.MONTH); } @@ -308,12 +389,18 @@ public class DateTimePicker extends FrameLayout { * * @param month The month in the year */ + // 设置当前月份的方法 public void setCurrentMonth(int month) { + // 检查是否正在初始化以及传入的月份是否与当前月份相同 + // 如果是，则直接返回，不进行任何操作 if (!mInitialising && month == getCurrentMonth()) { return; } + // 使用Calendar对象设置日期的月份 mDate.set(Calendar.MONTH, month); + // 更新日期控件，以反映新的月份设置 updateDateControl(); + // 调用方法处理日期时间变化，可能触发相关事件或更新UI onDateTimeChanged(); } @@ -322,7 +409,9 @@ public class DateTimePicker extends FrameLayout { * * @return The day of the month */ + // 定义一个公共方法，用于获取当前日期的天数 public int getCurrentDay() { + // 调用Calendar对象的get方法，传入Calendar.DAY_OF_MONTH常量，获取当前日期的天数 return mDate.get(Calendar.DAY_OF_MONTH); } @@ -331,12 +420,17 @@ public class DateTimePicker extends FrameLayout { * * @param dayOfMonth The day of the month */ + // 设置当前日期的天数 public void setCurrentDay(int dayOfMonth) { + // 检查是否正在初始化并且传入的天数与当前天数相同，如果是则直接返回 if (!mInitialising && dayOfMonth == getCurrentDay()) { return; } + // 使用Calendar对象设置日期的天数 mDate.set(Calendar.DAY_OF_MONTH, dayOfMonth); + // 更新日期控件 updateDateControl(); + // 触发日期时间变化事件 onDateTimeChanged(); } @@ -344,18 +438,28 @@ public class DateTimePicker extends FrameLayout { * Get current hour in 24 hour mode, in the range (0~23) * @return The current hour in 24 hour mode */ + // 定义一个公共方法，用于获取当前的小时数（24小时制） public int getCurrentHourOfDay() { + // 调用Calendar对象的get方法，传入Calendar.HOUR_OF_DAY常量，获取当前的小时数 return mDate.get(Calendar.HOUR_OF_DAY); } + // 获取当前小时数的私有方法 private int getCurrentHour() { + // 检查是否使用24小时制 if (mIs24HourView){ + // 如果是24小时制，直接返回当前的小时数 return getCurrentHourOfDay(); } else { + // 如果不是24小时制，先获取当前的小时数 int hour = getCurrentHourOfDay(); + // 检查当前小时数是否超过半天（12小时） if (hour > HOURS_IN_HALF_DAY) { + // 如果超过半天，返回当前小时数减去半天的小时数（转换为下午的小时数） return hour - HOURS_IN_HALF_DAY; } else { + // 如果当前小时数是0（表示午夜12点），则返回半天的小时数（12） + // 否则，直接返回当前小时数（表示上午的小时数） return hour == 0 ? HOURS_IN_HALF_DAY : hour; } } @@ -366,26 +470,37 @@ public class DateTimePicker extends FrameLayout { * * @param hourOfDay */ + // 设置当前小时的方法 public void setCurrentHour(int hourOfDay) { + // 检查是否正在初始化并且小时数是否与当前小时相同，如果是则直接返回 if (!mInitialising && hourOfDay == getCurrentHourOfDay()) { return; } + // 使用Calendar对象设置小时数 mDate.set(Calendar.HOUR_OF_DAY, hourOfDay); + // 检查是否为24小时制 if (!mIs24HourView) { + // 如果小时数大于等于半天的小时数（12小时），则设置为下午 if (hourOfDay >= HOURS_IN_HALF_DAY) { mIsAm = false; + // 如果小时数大于半天的小时数（12小时），则减去半天的小时数 if (hourOfDay > HOURS_IN_HALF_DAY) { hourOfDay -= HOURS_IN_HALF_DAY; } } else { + // 否则设置为上午 mIsAm = true; + // 如果小时数为0，则设置为半天的小时数（12小时） if (hourOfDay == 0) { hourOfDay = HOURS_IN_HALF_DAY; } } + // 更新上午/下午控件 updateAmPmControl(); } + // 设置小时选择器的值 mHourSpinner.setValue(hourOfDay); + // 触发时间变化事件 onDateTimeChanged(); } @@ -394,26 +509,36 @@ public class DateTimePicker extends FrameLayout { * * @return The Current Minute */ + // 定义一个公共方法，用于获取当前分钟数 public int getCurrentMinute() { + // 调用mDate对象的get方法，传入Calendar.MINUTE常量，获取当前时间的分钟数 return mDate.get(Calendar.MINUTE); } /** * Set current minute */ + // 设置当前分钟的方法 public void setCurrentMinute(int minute) { + // 检查是否正在初始化并且分钟值是否与当前分钟相同 if (!mInitialising && minute == getCurrentMinute()) { + // 如果是，则直接返回，不做任何操作 return; } + // 设置分钟选择器的值为传入的分钟值 mMinuteSpinner.setValue(minute); + // 更新日期对象的分钟字段为传入的分钟值 mDate.set(Calendar.MINUTE, minute); + // 调用方法通知时间已更改 onDateTimeChanged(); } /** * @return true if this is in 24 hour view else false. */ + // 定义一个公共的方法，用于判断是否为24小时制视图 public boolean is24HourView () { + // 返回成员变量mIs24HourView的值，该变量用于存储是否为24小时制的状态 return mIs24HourView; } @@ -422,48 +547,80 @@ public class DateTimePicker extends FrameLayout { * * @param is24HourView True for 24 hour mode. False for AM/PM mode. */ + // 设置24小时制视图 public void set24HourView(boolean is24HourView) { + // 如果当前24小时制视图状态与传入的参数相同，则直接返回，不做任何操作 if (mIs24HourView == is24HourView) { return; } + // 更新24小时制视图状态 mIs24HourView = is24HourView; + // 根据是否为24小时制视图，设置上午/下午选择器的可见性 + // 如果是24小时制，则隐藏上午/下午选择器；否则显示 mAmPmSpinner.setVisibility(is24HourView ? View.GONE : View.VISIBLE); + // 获取当前的小时数 int hour = getCurrentHourOfDay(); + // 更新小时控制部分 updateHourControl(); + // 设置当前小时数 setCurrentHour(hour); + // 更新上午/下午控制部分 updateAmPmControl(); } + // 更新日期控件的方法 private void updateDateControl() { + // 获取当前时间的Calendar实例 Calendar cal = Calendar.getInstance(); + // 将Calendar实例的时间设置为mDate的时间 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数组中 mDateDisplayValues[i] = (String) DateFormat.format("MM.dd EEEE", cal); } + // 设置日期选择器的显示值为更新后的日期数组 mDateSpinner.setDisplayedValues(mDateDisplayValues); + // 设置日期选择器的当前值为一周的中间日期 mDateSpinner.setValue(DAYS_IN_ALL_WEEK / 2); + // 刷新日期选择器，使其显示最新的值 mDateSpinner.invalidate(); } + // 定义一个私有方法updateAmPmControl，用于更新上午/下午选择控件的状态 private void updateAmPmControl() { + // 检查是否为24小时制视图 if (mIs24HourView) { + // 如果是24小时制视图，隐藏上午/下午选择控件 mAmPmSpinner.setVisibility(View.GONE); } else { + // 如果不是24小时制视图，根据当前是上午还是下午设置选择控件的值 int index = mIsAm ? Calendar.AM : Calendar.PM; + // 设置上午/下午选择控件的值为index mAmPmSpinner.setValue(index); + // 显示上午/下午选择控件 mAmPmSpinner.setVisibility(View.VISIBLE); } } + // 定义一个私有方法updateHourControl，用于更新小时选择器的范围 private void updateHourControl() { + // 检查是否是24小时制视图 if (mIs24HourView) { + // 如果是24小时制视图，设置小时选择器的最小值为HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW); + // 设置小时选择器的最大值为HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW mHourSpinner.setMaxValue(HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW); } else { + // 如果不是24小时制视图，设置小时选择器的最小值为HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW); + // 设置小时选择器的最大值为HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW mHourSpinner.setMaxValue(HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW); } } @@ -472,12 +629,18 @@ public class DateTimePicker extends FrameLayout { * 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 mOnDateTimeChangedListener = callback; } + // 定义一个私有方法，用于处理日期时间变化事件 private void onDateTimeChanged() { + // 检查是否已经设置了日期时间变化监听器 if (mOnDateTimeChangedListener != null) { + // 如果监听器不为空，则调用监听器的onDateTimeChanged方法 + // 传递当前对象以及当前的年、月、日、小时和分钟 mOnDateTimeChangedListener.onDateTimeChanged(this, getCurrentYear(), getCurrentMonth(), getCurrentDay(), getCurrentHourOfDay(), getCurrentMinute()); } diff --git a/src/src/net/micode/notes/ui/DateTimePickerDialog.java b/src/src/net/micode/notes/ui/DateTimePickerDialog.java index 2c47ba4..cc3f36c 100644 --- a/src/src/net/micode/notes/ui/DateTimePickerDialog.java +++ b/src/src/net/micode/notes/ui/DateTimePickerDialog.java @@ -31,30 +31,42 @@ import android.text.format.DateUtils; public class DateTimePickerDialog extends AlertDialog implements OnClickListener { + // 定义一个日历对象，用于存储日期和时间 private Calendar mDate = Calendar.getInstance(); + // 是否使用24小时制 private boolean mIs24HourView; + // 日期时间设置监听器 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.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.set(Calendar.SECOND, 0); mDateTimePicker.setCurrentDate(mDate.getTimeInMillis()); @@ -64,25 +76,44 @@ public class DateTimePickerDialog extends AlertDialog implements OnClickListener updateTitle(mDate.getTimeInMillis()); } + // 定义一个公共方法，用于设置是否使用24小时制视图 public void set24HourView(boolean is24HourView) { + // 将传入的布尔值参数is24HourView赋值给成员变量mIs24HourView mIs24HourView = is24HourView; } + // 定义一个方法用于设置日期时间设置监听器 public void setOnDateTimeSetListener(OnDateTimeSetListener callBack) { + // 将传入的监听器对象赋值给成员变量mOnDateTimeSetListener mOnDateTimeSetListener = callBack; } + // 定义一个私有方法updateTitle，用于更新标题，接收一个长整型参数date表示日期时间 private void updateTitle(long date) { + // 定义一个整型变量flag，用于存储日期时间的格式标志 int flag = + // 使用位或运算符将FORMAT_SHOW_YEAR标志添加到flag中，表示显示年份 DateUtils.FORMAT_SHOW_YEAR | + // 使用位或运算符将FORMAT_SHOW_DATE标志添加到flag中，表示显示日期 DateUtils.FORMAT_SHOW_DATE | + // 使用位或运算符将FORMAT_SHOW_TIME标志添加到flag中，表示显示时间 DateUtils.FORMAT_SHOW_TIME; + // 使用位或运算符将FORMAT_24HOUR标志添加到flag中 + // 如果mIs24HourView为true，则添加FORMAT_24HOUR标志，表示使用24小时制 + // 如果mIs24HourView为false，则也添加FORMAT_24HOUR标志，这里可能是一个逻辑错误，应该根据mIs24HourView的值决定是否添加该标志 flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_24HOUR; + // 调用DateUtils的formatDateTime方法，将日期时间格式化为字符串 + // this.getContext()获取当前上下文 + // date为要格式化的日期时间 + // flag为格式标志 setTitle(DateUtils.formatDateTime(this.getContext(), date, flag)); } + // 定义一个方法，当对话框被点击时触发 public void onClick(DialogInterface arg0, int arg1) { + // 检查mOnDateTimeSetListener是否不为空，确保有监听器注册 if (mOnDateTimeSetListener != null) { + // 调用mOnDateTimeSetListener的OnDateTimeSet方法，传递当前对象和日期的毫秒值 mOnDateTimeSetListener.OnDateTimeSet(this, mDate.getTimeInMillis()); } } diff --git a/src/src/net/micode/notes/ui/DropdownMenu.java b/src/src/net/micode/notes/ui/DropdownMenu.java index 613dc74..21e5be3 100644 --- a/src/src/net/micode/notes/ui/DropdownMenu.java +++ b/src/src/net/micode/notes/ui/DropdownMenu.java @@ -28,34 +28,61 @@ import android.widget.PopupMenu.OnMenuItemClickListener; import net.micode.notes.R; public class DropdownMenu { + // 声明一个Button对象，用于显示下拉菜单的按钮 private Button mButton; + // 声明一个PopupMenu对象，用于创建和管理下拉菜单 private PopupMenu mPopupMenu; + // 声明一个Menu对象，用于获取菜单项 private Menu mMenu; + // 构造方法，初始化DropdownMenu对象 public DropdownMenu(Context context, Button button, int menuId) { + // 将传入的Button对象赋值给mButton mButton = button; + // 设置按钮的背景资源为下拉图标 mButton.setBackgroundResource(R.drawable.dropdown_icon); + // 创建一个PopupMenu对象，传入上下文和按钮对象 mPopupMenu = new PopupMenu(context, mButton); + // 获取PopupMenu的Menu对象 mMenu = mPopupMenu.getMenu(); + // 使用PopupMenu的MenuInflater对象加载菜单布局文件 mPopupMenu.getMenuInflater().inflate(menuId, mMenu); + // 设置按钮的点击监听器 mButton.setOnClickListener(new OnClickListener() { + // 点击按钮时显示PopupMenu public void onClick(View v) { mPopupMenu.show(); } }); } + // 设置下拉菜单项的点击监听器 + // 定义一个方法用于设置下拉菜单项的点击监听器 public void setOnDropdownMenuItemClickListener(OnMenuItemClickListener listener) { + // 如果PopupMenu对象不为空，则设置菜单项点击监听器 if (mPopupMenu != null) { mPopupMenu.setOnMenuItemClickListener(listener); } } + // 根据菜单项的ID查找菜单项 public MenuItem findItem(int id) { + + // 调用mMenu对象的findItem方法，传入菜单项的id + // mMenu是一个菜单对象，用于管理菜单项 + // findItem方法用于在菜单中查找指定id的菜单项 + // id是菜单项的唯一标识符，通常是一个整型常量 + // 返回找到的菜单项对象，如果未找到则返回null return mMenu.findItem(id); } + // 设置按钮的标题 public void setTitle(CharSequence title) { + // 将传入的标题设置给按钮 + // 参数说明： + // CharSequence title - 要设置的标题文本 + // 功能说明： + // 该方法用于将传入的标题文本设置给成员变量mButton，即按钮的文本内容 mButton.setText(title); } } diff --git a/src/src/net/micode/notes/ui/FoldersListAdapter.java b/src/src/net/micode/notes/ui/FoldersListAdapter.java index 96b77da..9abdd16 100644 --- a/src/src/net/micode/notes/ui/FoldersListAdapter.java +++ b/src/src/net/micode/notes/ui/FoldersListAdapter.java @@ -30,50 +30,63 @@ import net.micode.notes.data.Notes.NoteColumns; public class FoldersListAdapter extends CursorAdapter { + // 定义查询的列 public static final String [] PROJECTION = { - NoteColumns.ID, - NoteColumns.SNIPPET + NoteColumns.ID, // 笔记ID + NoteColumns.SNIPPET // 笔记摘要 }; - public static final int ID_COLUMN = 0; - public static final int NAME_COLUMN = 1; + + // 定义列的索引 + public static final int ID_COLUMN = 0; // ID列的索引 + public static final int NAME_COLUMN = 1; // 名称列的索引 + + // 构造函数 public FoldersListAdapter(Context context, Cursor c) { super(context, c); // TODO Auto-generated constructor stub } + // 创建新的视图 @Override public View newView(Context context, Cursor cursor, ViewGroup parent) { - return new FolderListItem(context); + return new FolderListItem(context); // 返回一个新的FolderListItem视图 } + // 绑定数据到视图 @Override public void bindView(View view, Context context, Cursor cursor) { - if (view instanceof FolderListItem) { + if (view instanceof FolderListItem) { // 如果视图是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); + ((FolderListItem) view).bind(folderName); // 绑定文件夹名称到视图 } } + // 获取指定位置的文件夹名称 public String getFolderName(Context context, int position) { - Cursor cursor = (Cursor) getItem(position); + Cursor cursor = (Cursor) getItem(position); // 获取指定位置的Cursor + // 如果是根文件夹则显示特定的字符串 return (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context .getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN); } + // 内部类FolderListItem，继承自LinearLayout private class FolderListItem extends LinearLayout { - private TextView mName; + private TextView mName; // 文本视图，用于显示文件夹名称 + // 构造函数 public FolderListItem(Context context) { super(context); - inflate(context, R.layout.folder_list_item, this); - mName = (TextView) findViewById(R.id.tv_folder_name); + inflate(context, R.layout.folder_list_item, this); // 加载布局文件 + mName = (TextView) findViewById(R.id.tv_folder_name); // 获取布局中的文本视图 } + // 绑定文件夹名称到文本视图 public void bind(String name) { - mName.setText(name); + mName.setText(name); // 设置文本视图的文本 } } diff --git a/src/src/net/micode/notes/ui/NoteEditActivity.java b/src/src/net/micode/notes/ui/NoteEditActivity.java index 96a9ff8..2e49698 100644 --- a/src/src/net/micode/notes/ui/NoteEditActivity.java +++ b/src/src/net/micode/notes/ui/NoteEditActivity.java @@ -74,16 +74,18 @@ import java.util.regex.Pattern; public class NoteEditActivity extends Activity implements OnClickListener, NoteSettingChangedListener, OnTextViewChangeListener { + // 定义一个内部类，用于保存头部视图的引用 private class HeadViewHolder { - public TextView tvModified; + public TextView tvModified; // 显示修改日期的TextView - public ImageView ivAlertIcon; + public ImageView ivAlertIcon; // 显示提醒图标的ImageView - public TextView tvAlertDate; + public TextView tvAlertDate; // 显示提醒日期的TextView - public ImageView ibSetBgColor; + public ImageView ibSetBgColor; // 设置背景颜色的ImageView } + // 定义背景颜色选择按钮与背景颜色值的映射 private static final Map sBgSelectorBtnsMap = new HashMap(); static { sBgSelectorBtnsMap.put(R.id.iv_bg_yellow, ResourceParser.YELLOW); @@ -93,6 +95,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, 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); @@ -102,6 +105,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, 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); @@ -110,6 +114,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, 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); @@ -118,47 +123,55 @@ public class NoteEditActivity extends Activity implements OnClickListener, sFontSelectorSelectionMap.put(ResourceParser.TEXT_SUPER, R.id.iv_super_select); } - private static final String TAG = "NoteEditActivity"; + private static final String TAG = "NoteEditActivity"; // 日志标签 - private HeadViewHolder mNoteHeaderHolder; + private HeadViewHolder mNoteHeaderHolder; // 头部视图持有者 - private View mHeadViewPanel; + private View mHeadViewPanel; // 头部视图面板 - private View mNoteBgColorSelector; + private View mNoteBgColorSelector; // 背景颜色选择器 - private View mFontSizeSelector; + private View mFontSizeSelector; // 字体大小选择器 - private EditText mNoteEditor; + private EditText mNoteEditor; // 笔记编辑器 - private View mNoteEditorPanel; + private View mNoteEditorPanel; // 笔记编辑器面板 - private WorkingNote mWorkingNote; + private WorkingNote mWorkingNote; // 当前正在编辑的笔记 - private SharedPreferences mSharedPrefs; - private int mFontSizeId; + private SharedPreferences mSharedPrefs; // 共享偏好设置 + private int mFontSizeId; // 当前字体大小ID - private static final String PREFERENCE_FONT_SIZE = "pref_font_size"; + private static final String PREFERENCE_FONT_SIZE = "pref_font_size"; // 字体大小偏好设置键 - private static final int SHORTCUT_ICON_TITLE_MAX_LEN = 10; + 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'); + public static final String TAG_CHECKED = String.valueOf('\u221A'); // 已选中标签 + public static final String TAG_UNCHECKED = String.valueOf('\u25A1'); // 未选中标签 - private LinearLayout mEditTextList; + private LinearLayout mEditTextList; // 编辑文本列表 - private String mUserQuery; - private Pattern mPattern; + private String mUserQuery; // 用户查询字符串 + private Pattern mPattern; // 正则表达式模式 @Override + // 重写父类的方法，用于在Activity创建时调用 protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); + // 调用父类的onCreate方法，进行Activity的基本初始化 this.setContentView(R.layout.note_edit); + // 设置当前Activity的布局文件为R.layout.note_edit if (savedInstanceState == null && !initActivityState(getIntent())) { + // 检查savedInstanceState是否为null（即Activity是否是第一次创建） + // 并且调用initActivityState方法初始化Activity状态，如果返回false finish(); + // 结束当前Activity return; + // 结束方法执行，不再继续向下执行 } initResources(); + // 调用initResources方法，进行资源的初始化 } /** @@ -167,14 +180,21 @@ public class NoteEditActivity extends Activity implements OnClickListener, */ @Override protected void onRestoreInstanceState(Bundle savedInstanceState) { + // 调用父类的onRestoreInstanceState方法，确保父类的恢复逻辑得以执行 super.onRestoreInstanceState(savedInstanceState); + // 检查savedInstanceState是否不为空，并且包含特定的键(Intent.EXTRA_UID) if (savedInstanceState != null && savedInstanceState.containsKey(Intent.EXTRA_UID)) { + // 创建一个新的Intent对象，指定动作为查看(Intent.ACTION_VIEW) Intent intent = new Intent(Intent.ACTION_VIEW); + // 将savedInstanceState中存储的UID值取出，并放入Intent的额外数据中 intent.putExtra(Intent.EXTRA_UID, savedInstanceState.getLong(Intent.EXTRA_UID)); + // 调用initActivityState方法，传入intent，尝试初始化活动状态 + // 如果初始化失败，则调用finish()方法结束当前活动 if (!initActivityState(intent)) { finish(); return; } + // 使用Log.d输出调试信息，表示正在从被杀死的活动中恢复 Log.d(TAG, "Restoring from killed activity"); } } @@ -263,26 +283,41 @@ public class NoteEditActivity extends Activity implements OnClickListener, } @Override + // 重写父类的方法，表示这个方法是一个覆盖方法 protected void onResume() { + // 调用父类的onResume方法，确保父类的逻辑得以执行 super.onResume(); + // 调用initNoteScreen方法，初始化笔记屏幕 initNoteScreen(); } + // 初始化笔记屏幕的显示 private void initNoteScreen() { + // 设置笔记编辑器的文本外观，根据字体大小ID获取对应的文本外观资源 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()); + // 设置笔记头部视图的修改时间文本 + // 使用DateUtils格式化日期时间，显示日期、时间、年份 mNoteHeaderHolder.tvModified.setText(DateUtils.formatDateTime(this, mWorkingNote.getModifiedDate(), DateUtils.FORMAT_SHOW_DATE | DateUtils.FORMAT_NUMERIC_DATE | DateUtils.FORMAT_SHOW_TIME @@ -295,31 +330,48 @@ public class NoteEditActivity extends Activity implements OnClickListener, showAlertHeader(); } + // 定义一个私有方法用于显示提醒头部信息 private void showAlertHeader() { + // 检查当前工作笔记是否有闹钟提醒 if (mWorkingNote.hasClockAlert()) { + // 获取当前系统时间 long time = System.currentTimeMillis(); + // 比较当前时间与提醒时间 if (time > mWorkingNote.getAlertDate()) { + // 如果当前时间大于提醒时间，说明提醒已过期 + // 设置提醒日期文本为“提醒已过期” mNoteHeaderHolder.tvAlertDate.setText(R.string.note_alert_expired); } else { + // 如果当前时间小于提醒时间，说明提醒还未到 + // 使用DateUtils工具类获取相对时间字符串 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 + // 重写父类的方法，当Activity接收到新的Intent时调用 protected void onNewIntent(Intent intent) { super.onNewIntent(intent); + // 调用父类的onNewIntent方法，确保父类的逻辑得以执行 initActivityState(intent); + // 调用initActivityState方法，传入新的Intent，用于初始化或更新Activity的状态 } @Override protected void onSaveInstanceState(Bundle outState) { + // 调用父类的onSaveInstanceState方法，保存当前Activity的状态 super.onSaveInstanceState(outState); /** * For new note without note id, we should firstly save it to @@ -335,24 +387,36 @@ public class NoteEditActivity extends Activity implements OnClickListener, @Override public boolean dispatchTouchEvent(MotionEvent ev) { + // 检查笔记背景颜色选择器的可见性，并且判断触摸事件是否发生在选择器之外 if (mNoteBgColorSelector.getVisibility() == View.VISIBLE && !inRangeOfView(mNoteBgColorSelector, ev)) { + // 如果选择器可见且触摸事件发生在选择器之外，则隐藏选择器 mNoteBgColorSelector.setVisibility(View.GONE); + // 返回true表示事件已处理，不再传递 return true; } + // 检查字体大小选择器的可见性，并且判断触摸事件是否发生在选择器之外 if (mFontSizeSelector.getVisibility() == View.VISIBLE && !inRangeOfView(mFontSizeSelector, ev)) { + // 如果选择器可见且触摸事件发生在选择器之外，则隐藏选择器 mFontSizeSelector.setVisibility(View.GONE); + // 返回true表示事件已处理，不再传递 return true; } + // 如果上述条件都不满足，则调用父类的dispatchTouchEvent方法继续处理事件 return super.dispatchTouchEvent(ev); } + // 定义一个私有方法，用于判断给定的MotionEvent是否在指定View的可见范围内 private boolean inRangeOfView(View view, MotionEvent ev) { + // 创建一个整型数组，用于存储View在屏幕上的坐标位置 int []location = new int[2]; + // 获取View在屏幕上的绝对坐标位置，结果存储在location数组中 view.getLocationOnScreen(location); + // 从location数组中获取View的左上角x坐标 int x = location[0]; + // 从location数组中获取View的左上角y坐标 int y = location[1]; if (ev.getX() < x || ev.getX() > (x + view.getWidth()) @@ -363,28 +427,44 @@ public class NoteEditActivity extends Activity implements OnClickListener, return true; } + // 初始化资源的方法 private void initResources() { + // 获取标题面板的视图 mHeadViewPanel = findViewById(R.id.note_title); + // 创建一个HeadViewHolder对象来保存标题部分的视图 mNoteHeaderHolder = new HeadViewHolder(); + // 获取修改日期的TextView mNoteHeaderHolder.tvModified = (TextView) findViewById(R.id.tv_modified_date); + // 获取提醒图标的ImageView mNoteHeaderHolder.ivAlertIcon = (ImageView) findViewById(R.id.iv_alert_icon); + // 获取提醒日期的TextView mNoteHeaderHolder.tvAlertDate = (TextView) findViewById(R.id.tv_alert_date); + // 获取设置背景颜色的ImageView mNoteHeaderHolder.ibSetBgColor = (ImageView) findViewById(R.id.btn_set_bg_color); + // 为设置背景颜色的ImageView设置点击监听器 mNoteHeaderHolder.ibSetBgColor.setOnClickListener(this); + // 获取笔记编辑器的EditText mNoteEditor = (EditText) findViewById(R.id.note_edit_view); + // 获取笔记编辑面板的视图 mNoteEditorPanel = findViewById(R.id.sv_note_edit); + // 获取背景颜色选择器的视图 mNoteBgColorSelector = findViewById(R.id.note_bg_color_selector); + // 遍历背景颜色选择器的按钮ID集合，并为每个按钮设置点击监听器 for (int id : sBgSelectorBtnsMap.keySet()) { ImageView iv = (ImageView) findViewById(id); iv.setOnClickListener(this); } + // 获取字体大小选择器的视图 mFontSizeSelector = findViewById(R.id.font_size_selector); + // 遍历字体大小选择器的按钮ID集合，并为每个按钮设置点击监听器 for (int id : sFontSizeBtnsMap.keySet()) { View view = findViewById(id); view.setOnClickListener(this); }; + // 获取默认的SharedPreferences mSharedPrefs = PreferenceManager.getDefaultSharedPreferences(this); + // 从SharedPreferences中获取保存的字体大小ID，如果没有则使用默认值 mFontSizeId = mSharedPrefs.getInt(PREFERENCE_FONT_SIZE, ResourceParser.BG_DEFAULT_FONT_SIZE); /** * HACKME: Fix bug of store the resource id in shared preference. @@ -398,168 +478,256 @@ public class NoteEditActivity extends Activity implements OnClickListener, } @Override + // 重写父类中的onPause方法，该方法在Activity暂停时被调用 protected void onPause() { super.onPause(); + // 调用父类的onPause方法，确保父类的逻辑得以执行 if(saveNote()) { + // 调用saveNote方法保存笔记，如果保存成功（返回true），则执行以下代码 Log.d(TAG, "Note data was saved with length:" + mWorkingNote.getContent().length()); + // 使用Log.d方法记录调试信息，TAG为日志标签，内容为"Note data was saved with length:"加上笔记内容的长度 } clearSettingState(); + // 调用clearSettingState方法清除设置状态，确保在暂停时不会保留不必要的设置 } + // 更新小部件的方法 private void updateWidget() { + // 创建一个意图，用于发送广播，更新小部件 Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE); + // 根据当前工作笔记的小部件类型，设置对应的意图类 if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_2X) { + // 如果是小部件类型2x2，则设置意图类为NoteWidgetProvider_2x intent.setClass(this, NoteWidgetProvider_2x.class); } else if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_4X) { + // 如果是小部件类型4x4，则设置意图类为NoteWidgetProvider_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); + // 设置新的背景颜色ID mWorkingNote.setBgColorId(sBgSelectorBtnsMap.get(id)); + // 隐藏背景颜色选择器 mNoteBgColorSelector.setVisibility(View.GONE); } else if (sFontSizeBtnsMap.containsKey(id)) { + // 隐藏当前字体大小选择器的选中状态 findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.GONE); + // 设置新的字体大小ID mFontSizeId = sFontSizeBtnsMap.get(id); + // 将新的字体大小ID保存到SharedPreferences 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() { + // 调用clearSettingState方法，检查是否需要清除设置状态 if(clearSettingState()) { + // 如果clearSettingState返回true，表示需要清除设置状态，直接返回，不执行后续操作 return; } + // 调用saveNote方法，保存当前笔记 saveNote(); + // 调用父类的onBackPressed方法，执行默认的返回键操作 super.onBackPressed(); } + // 定义一个私有方法clearSettingState，用于清除设置状态 private boolean clearSettingState() { + // 检查笔记背景颜色选择器的可见性 if (mNoteBgColorSelector.getVisibility() == View.VISIBLE) { + // 如果笔记背景颜色选择器是可见的，将其设置为不可见 mNoteBgColorSelector.setVisibility(View.GONE); + // 返回true，表示成功隐藏了笔记背景颜色选择器 return true; } else if (mFontSizeSelector.getVisibility() == View.VISIBLE) { + // 如果字体大小选择器是可见的，将其设置为不可见 mFontSizeSelector.setVisibility(View.GONE); + // 返回true，表示成功隐藏了字体大小选择器 return true; } + // 如果笔记背景颜色选择器和字体大小选择器都不可见，返回false return false; } + // 定义一个方法，当背景颜色发生变化时调用 public void onBackgroundColorChanged() { + // 通过查找当前工作笔记的背景颜色ID，获取对应的视图，并将其设置为可见 findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility( View.VISIBLE); + // 设置笔记编辑面板的背景资源为当前工作笔记的背景颜色资源ID mNoteEditorPanel.setBackgroundResource(mWorkingNote.getBgColorResId()); + // 设置头部视图面板的背景资源为当前工作笔记的标题背景资源ID mHeadViewPanel.setBackgroundResource(mWorkingNote.getTitleBgResId()); } @Override public boolean onPrepareOptionsMenu(Menu menu) { + // 检查当前Activity是否正在 finishing（销毁中） if (isFinishing()) { + // 如果Activity正在销毁，则不执行后续操作，直接返回true 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) { + // 删除当前笔记 deleteCurrentNote(); + // 结束当前Activity 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; } + // 返回true表示事件已处理 return true; } + // 定义一个私有方法setReminder，用于设置提醒 private void setReminder() { + // 创建一个DateTimePickerDialog对象d，传入当前上下文和当前系统时间 DateTimePickerDialog d = new DateTimePickerDialog(this, System.currentTimeMillis()); + // 为DateTimePickerDialog对象设置一个时间设置监听器 d.setOnDateTimeSetListener(new OnDateTimeSetListener() { + // 当用户设置时间时，会调用此方法 public void OnDateTimeSet(AlertDialog dialog, long date) { + // 将设置的时间赋值给工作笔记的提醒日期，并标记为已设置 mWorkingNote.setAlertDate(date , true); } }); + // 显示DateTimePickerDialog对话框 d.show(); } @@ -567,10 +735,15 @@ public class NoteEditActivity extends Activity implements OnClickListener, * Share note to apps that support {@link Intent#ACTION_SEND} action * and {@text/plain} type */ + // 定义一个私有方法sendTo，用于发送信息 private void sendTo(Context context, String info) { + // 创建一个Intent对象，指定动作类型为ACTION_SEND，表示发送 Intent intent = new Intent(Intent.ACTION_SEND); + // 将要发送的信息添加到Intent中，使用EXTRA_TEXT键，info为要发送的文本内容 intent.putExtra(Intent.EXTRA_TEXT, info); + // 设置Intent的数据类型为"text/plain"，表示发送的是纯文本 intent.setType("text/plain"); + // 使用传入的Context对象启动Activity，将Intent传递给系统，系统会根据Intent的类型选择合适的Activity来处理发送操作 context.startActivity(intent); } @@ -586,28 +759,41 @@ public class NoteEditActivity extends Activity implements OnClickListener, startActivity(intent); } + // 删除当前笔记的方法 private void deleteCurrentNote() { + // 检查当前笔记是否存在于数据库中 if (mWorkingNote.existInDatabase()) { + // 创建一个HashSet用于存储要删除的笔记ID HashSet ids = new HashSet(); + // 获取当前笔记的ID long id = mWorkingNote.getNoteId(); + // 检查笔记ID是否为根文件夹ID，如果不是则添加到HashSet中 if (id != Notes.ID_ROOT_FOLDER) { ids.add(id); } else { + // 如果笔记ID为根文件夹ID，则记录错误日志 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); } + // 定义一个私有方法isSyncMode，用于判断当前是否处于同步模式 private boolean isSyncMode() { return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0; } @@ -642,33 +828,47 @@ public class NoteEditActivity extends Activity implements OnClickListener, } } + // 定义一个公共方法，当小部件发生变化时调用 public void onWidgetChanged() { + // 调用updateWidget方法来更新小部件 updateWidget(); } + // 定义一个方法，用于处理编辑文本框的删除操作 public void onEditTextDelete(int index, String text) { + // 获取当前编辑文本框列表中的子视图数量 int childCount = mEditTextList.getChildCount(); + // 如果只有一个编辑文本框，则直接返回，不做任何操作 if (childCount == 1) { return; } + // 从被删除的编辑文本框的下一个开始，遍历所有后续的编辑文本框 for (int i = index + 1; i < childCount; i++) { + // 获取当前编辑文本框的子视图，并设置其索引为当前索引减1 ((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); } @@ -691,31 +891,52 @@ public class NoteEditActivity extends Activity implements OnClickListener, } } + // 定义一个私有方法，用于将文本转换为列表模式 private void switchToListMode(String text) { + // 清除mEditTextList中的所有视图 mEditTextList.removeAllViews(); + // 将输入的文本按换行符分割成字符串数组 String[] items = text.split("\n"); + // 初始化索引变量 int index = 0; + // 遍历分割后的字符串数组 for (String item : items) { + // 检查当前字符串是否为空 if(!TextUtils.isEmpty(item)) { + // 如果不为空，将当前字符串作为列表项添加到mEditTextList中 mEditTextList.addView(getListItem(item, index)); + // 索引加1 index++; } } + // 添加一个空列表项到mEditTextList中 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对象，如果fullText为null，则使用空字符串 SpannableString spannable = new SpannableString(fullText == null ? "" : fullText); + // 检查用户查询字符串是否为空 if (!TextUtils.isEmpty(userQuery)) { + // 编译用户查询字符串为正则表达式模式 mPattern = Pattern.compile(userQuery); + // 创建一个匹配器，用于在fullText中查找匹配的用户查询字符串 Matcher m = mPattern.matcher(fullText); + // 初始化匹配的起始位置 int start = 0; + // 循环查找匹配的用户查询字符串 while (m.find(start)) { + // 在匹配的起始和结束位置之间设置背景颜色，以高亮显示查询结果 spannable.setSpan( + // 创建一个BackgroundColorSpan对象，设置高亮背景颜色 new BackgroundColorSpan(this.getResources().getColor( R.color.user_query_highlight)), m.start(), m.end(), Spannable.SPAN_INCLUSIVE_EXCLUSIVE); @@ -725,55 +946,88 @@ public class NoteEditActivity extends Activity implements OnClickListener, return spannable; } + // 定义一个私有方法，用于获取列表项的视图 private View getListItem(String item, int index) { + // 使用LayoutInflater从当前上下文中加载note_edit_list_item布局文件，并返回一个View对象 View view = LayoutInflater.from(this).inflate(R.layout.note_edit_list_item, null); + // 从视图中找到id为et_edit_text的NoteEditText控件 final NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text); + // 设置edit文本的样式，使用TextAppearanceResources类获取对应的样式资源ID edit.setTextAppearance(this, TextAppearanceResources.getTexAppearanceResource(mFontSizeId)); + // 从视图中找到id为cb_edit_item的CheckBox控件 CheckBox cb = ((CheckBox) view.findViewById(R.id.cb_edit_item)); + // 为CheckBox设置一个OnCheckedChangeListener监听器，用于处理选中状态变化 cb.setOnCheckedChangeListener(new OnCheckedChangeListener() { public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) { + // 如果CheckBox被选中 if (isChecked) { + // 设置edit文本的画笔标志，添加删除线效果 edit.setPaintFlags(edit.getPaintFlags() | Paint.STRIKE_THRU_TEXT_FLAG); } else { + // 如果CheckBox未被选中，设置edit文本的画笔标志，去除删除线效果 edit.setPaintFlags(Paint.ANTI_ALIAS_FLAG | Paint.DEV_KERN_TEXT_FLAG); } } }); + // 检查item字符串是否以TAG_CHECKED开头 if (item.startsWith(TAG_CHECKED)) { + // 如果是，设置CheckBox为选中状态 cb.setChecked(true); + // 设置edit文本的画笔标志，添加删除线效果 edit.setPaintFlags(edit.getPaintFlags() | Paint.STRIKE_THRU_TEXT_FLAG); + // 去除TAG_CHECKED部分，并去除首尾空格 item = item.substring(TAG_CHECKED.length(), item.length()).trim(); } else if (item.startsWith(TAG_UNCHECKED)) { + // 如果item字符串以TAG_UNCHECKED开头 cb.setChecked(false); + // 设置edit文本的画笔标志，去除删除线效果 edit.setPaintFlags(Paint.ANTI_ALIAS_FLAG | Paint.DEV_KERN_TEXT_FLAG); + // 去除TAG_UNCHECKED部分，并去除首尾空格 item = item.substring(TAG_UNCHECKED.length(), item.length()).trim(); } + // 设置edit控件的文本内容，并高亮显示用户查询的关键词 edit.setOnTextViewChangeListener(this); + // 设置edit控件的索引 edit.setIndex(index); + // 设置edit控件的文本内容，并高亮显示用户查询的关键词 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) { + // 获取指定索引位置的子视图，并找到其中的 R.id.cb_edit_item 视图，设置为可见 mEditTextList.getChildAt(index).findViewById(R.id.cb_edit_item).setVisibility(View.VISIBLE); } else { + // 如果没有文本内容，获取指定索引位置的子视图，并找到其中的 R.id.cb_edit_item 视图，设置为不可见 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 + " ", + + // 将工作笔记的文本中的未选中标签移除 + mWorkingNote.setWorkingText(mWorkingNote.getContent().replace(TAG_UNCHECKED + " ", "")); "")); } mNoteEditor.setText(getHighlightQueryResult(mWorkingNote.getContent(), mUserQuery)); @@ -782,32 +1036,50 @@ public class NoteEditActivity extends Activity implements OnClickListener, } } + // 定义一个私有方法getWorkingText，用于获取工作文本并返回是否有已选中的项 private boolean getWorkingText() { + // 初始化一个布尔变量hasChecked，用于标记是否有已选中的项 boolean hasChecked = false; + // 检查当前工作笔记是否处于清单模式 if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) { + // 创建一个StringBuilder对象，用于构建工作文本 StringBuilder sb = new StringBuilder(); + // 遍历mEditTextList中的所有子视图 for (int i = 0; i < mEditTextList.getChildCount(); i++) { + // 获取当前子视图 View view = mEditTextList.getChildAt(i); + // 从子视图中找到NoteEditText控件 NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text); + // 检查edit文本是否为空 if (!TextUtils.isEmpty(edit.getText())) { + // 检查子视图中的CheckBox是否被选中 if (((CheckBox) view.findViewById(R.id.cb_edit_item)).isChecked()) { + // 如果被选中，将选中标记和文本添加到StringBuilder中，并设置hasChecked为true sb.append(TAG_CHECKED).append(" ").append(edit.getText()).append("\n"); hasChecked = true; } else { + // 如果未被选中，将未选中标记和文本添加到StringBuilder中 sb.append(TAG_UNCHECKED).append(" ").append(edit.getText()).append("\n"); } } } + // 将构建好的字符串设置为工作笔记的工作文本 mWorkingNote.setWorkingText(sb.toString()); } else { + // 如果不是清单模式，直接将NoteEditor中的文本设置为工作笔记的工作文本 mWorkingNote.setWorkingText(mNoteEditor.getText().toString()); } + // 返回是否有已选中的项 return hasChecked; } + // 定义一个私有方法saveNote，用于保存笔记 private boolean saveNote() { + // 调用getWorkingText方法获取当前正在编辑的文本内容 getWorkingText(); + // 调用mWorkingNote对象的saveNote方法保存笔记，并将返回的布尔值赋给变量saved boolean saved = mWorkingNote.saveNote(); + // 如果笔记保存成功（saved为true） if (saved) { /** * There are two modes from List view to edit view, open one note, @@ -816,8 +1088,10 @@ public class NoteEditActivity extends Activity implements OnClickListener, * new node requires to the top of the list. This code * {@link #RESULT_OK} is used to identify the create/edit state */ + // 设置结果为RESULT_OK，表示操作成功 setResult(RESULT_OK); } + // 返回保存操作的结果 return saved; } @@ -856,18 +1130,29 @@ public class NoteEditActivity extends Activity implements OnClickListener, } } + // 定义一个私有方法，用于生成快捷图标标题 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; } + // 定义一个私有方法showToast，用于显示一个简短的Toast消息 private void showToast(int resId) { + // 调用另一个重载的showToast方法，传入resId和Toast.LENGTH_SHORT作为参数 + // resId是字符串资源的ID，Toast.LENGTH_SHORT表示Toast显示的时长为短时间 showToast(resId, Toast.LENGTH_SHORT); } + // 定义一个私有方法showToast，用于显示一个Toast消息 private void showToast(int resId, int duration) { + // 调用Toast类的静态方法makeText，创建一个Toast对象 + // this：当前上下文，通常是Activity + // resId：要显示的消息字符串的资源ID + // duration：Toast显示的时长，可以是Toast.LENGTH_SHORT或Toast.LENGTH_LONG Toast.makeText(this, resId, duration).show(); } } diff --git a/src/src/net/micode/notes/ui/NoteEditText.java b/src/src/net/micode/notes/ui/NoteEditText.java index 2afe2a8..a24662c 100644 --- a/src/src/net/micode/notes/ui/NoteEditText.java +++ b/src/src/net/micode/notes/ui/NoteEditText.java @@ -38,16 +38,22 @@ import java.util.HashMap; import java.util.Map; 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:" ; private static final String SCHEME_EMAIL = "mailto:" ; + // 链接方案与对应的操作资源ID映射 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); sSchemaActionResMap.put(SCHEME_EMAIL, R.string.note_link_email); @@ -77,131 +83,191 @@ public class NoteEditText extends EditText { private OnTextViewChangeListener mOnTextViewChangeListener; + // 构造函数，用于创建一个NoteEditText对象 public NoteEditText(Context context) { + // 调用父类的构造函数，传入当前上下文和null作为参数 super(context, null); + // 初始化成员变量mIndex，将其设置为0 mIndex = 0; } + // 定义一个公共方法，用于设置索引值 public void setIndex(int index) { + // 将传入的索引值赋值给成员变量mIndex mIndex = index; } + // 定义一个方法用于设置TextView内容变化的监听器 public void setOnTextViewChangeListener(OnTextViewChangeListener listener) { + // 将传入的监听器对象赋值给成员变量mOnTextViewChangeListener mOnTextViewChangeListener = listener; } + // 构造函数，用于创建NoteEditText对象 public NoteEditText(Context context, AttributeSet attrs) { + // 调用父类的构造函数，传入上下文对象和属性集，同时指定默认样式为android.R.attr.editTextStyle + // 这里的super关键字表示调用父类（可能是TextView或EditText）的构造函数 + // context: 上下文对象，用于获取资源和系统服务 + // attrs: 属性集，包含在XML布局文件中定义的属性 + // android.R.attr.editTextStyle: 指定默认的EditText样式 super(context, attrs, android.R.attr.editTextStyle); } + // 构造函数，用于创建NoteEditText对象 public NoteEditText(Context context, AttributeSet attrs, int defStyle) { + // 调用父类（可能是TextView或EditText）的构造函数，传入上下文、属性集和样式资源ID super(context, attrs, defStyle); // TODO Auto-generated constructor stub } @Override public boolean onTouchEvent(MotionEvent event) { + // 根据触摸事件的类型进行处理 switch (event.getAction()) { case MotionEvent.ACTION_DOWN: + // 获取触摸点的x坐标 int x = (int) event.getX(); + // 获取触摸点的y坐标 int y = (int) event.getY(); + // 调整x坐标，减去左侧的内边距 x -= getTotalPaddingLeft(); + // 调整y坐标，减去顶部的内边距 y -= getTotalPaddingTop(); + // 调整x坐标，加上视图的滚动偏移量 x += getScrollX(); + // 调整y坐标，加上视图的滚动偏移量 y += getScrollY(); + // 获取当前文本的布局 Layout layout = getLayout(); + // 根据y坐标获取触摸点所在的行 int line = layout.getLineForVertical(y); + // 根据x坐标和行号获取触摸点在该行中的偏移量 int off = layout.getOffsetForHorizontal(line, x); + // 设置文本的选中位置为触摸点所在的偏移量 Selection.setSelection(getText(), off); break; } + // 调用父类的onTouchEvent方法，继续处理触摸事件 return super.onTouchEvent(event); } @Override + // 重写 onKeyDown 方法，用于处理按键按下事件 public boolean onKeyDown(int keyCode, KeyEvent event) { + // 根据按键代码进行不同的处理 switch (keyCode) { case KeyEvent.KEYCODE_ENTER: + // 如果按键是回车键 if (mOnTextViewChangeListener != null) { - return false; + + // 如果存在文本视图内容变化监听器 + return false; // 返回 false，表示不处理该按键事件 } - break; + break; // 跳出 switch 语句 case KeyEvent.KEYCODE_DEL: + // 如果按键是删除键 mSelectionStartBeforeDelete = getSelectionStart(); - break; + + // 记录删除操作前的光标位置 + break; // 跳出 switch 语句 default: - break; + + // 如果是其他按键 + break; // 跳出 switch 语句 } + // 调用父类的 onKeyDown 方法，处理其他按键事件 return super.onKeyDown(keyCode, event); } @Override public boolean onKeyUp(int keyCode, KeyEvent event) { + // 根据按键代码进行不同的处理 switch(keyCode) { - case KeyEvent.KEYCODE_DEL: - if (mOnTextViewChangeListener != null) { - if (0 == mSelectionStartBeforeDelete && mIndex != 0) { + case KeyEvent.KEYCODE_DEL: // 处理删除键 + if (mOnTextViewChangeListener != null) { // 检查是否有设置文本变化监听器 + if (0 == mSelectionStartBeforeDelete && mIndex != 0) { // 检查删除位置是否在文本开始且不是第一个编辑框 + // 调用监听器的删除方法，传递当前编辑框索引和文本内容 mOnTextViewChangeListener.onEditTextDelete(mIndex, getText().toString()); - return true; + return true; // 返回true表示事件已处理 } } 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)); + 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: + default: // 其他按键不做处理 break; } + // 调用父类方法处理其他按键事件 return super.onKeyUp(keyCode, event); } @Override + // 重写父类的方法，当视图焦点状态改变时调用 protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) { + // 检查是否有文本变化监听器 if (mOnTextViewChangeListener != null) { + // 如果当前视图失去焦点且文本为空 if (!focused && TextUtils.isEmpty(getText())) { + // 调用监听器的onTextChange方法，通知文本为空 mOnTextViewChangeListener.onTextChange(mIndex, false); } else { + // 否则，调用监听器的onTextChange方法，通知文本不为空 mOnTextViewChangeListener.onTextChange(mIndex, true); } } + // 调用父类的onFocusChanged方法，确保父类的逻辑也被执行 super.onFocusChanged(focused, direction, previouslyFocusedRect); } @Override protected void onCreateContextMenu(ContextMenu menu) { + // 检查当前文本是否为Spanned类型 if (getText() instanceof Spanned) { + // 获取当前选中的文本的起始和结束位置 int selStart = getSelectionStart(); int selEnd = getSelectionEnd(); + // 确定选中文本的起始和结束位置 int min = Math.min(selStart, selEnd); int max = Math.max(selStart, selEnd); + // 获取选中文本中的URLSpan对象数组 final URLSpan[] urls = ((Spanned) getText()).getSpans(min, max, URLSpan.class); + // 如果只有一个URLSpan对象 if (urls.length == 1) { int defaultResId = 0; + // 遍历预定义的URL模式映射表 for(String schema: sSchemaActionResMap.keySet()) { + // 检查URL是否包含当前模式 if(urls[0].getURL().indexOf(schema) >= 0) { + // 如果匹配，获取对应的资源ID defaultResId = sSchemaActionResMap.get(schema); break; } } + // 如果没有匹配的模式，使用默认的资源ID if (defaultResId == 0) { defaultResId = R.string.note_link_other; } + // 向上下文菜单中添加一个菜单项 menu.add(0, 0, 0, defaultResId).setOnMenuItemClickListener( new OnMenuItemClickListener() { public boolean onMenuItemClick(MenuItem item) { diff --git a/src/src/net/micode/notes/ui/NoteItemData.java b/src/src/net/micode/notes/ui/NoteItemData.java index 0f5a878..ced076b 100644 --- a/src/src/net/micode/notes/ui/NoteItemData.java +++ b/src/src/net/micode/notes/ui/NoteItemData.java @@ -27,21 +27,23 @@ 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, + NoteColumns.ID, // 笔记ID + NoteColumns.ALERTED_DATE, // 提醒日期 + NoteColumns.BG_COLOR_ID, // 背景颜色ID + NoteColumns.CREATED_DATE, // 创建日期 + NoteColumns.HAS_ATTACHMENT, // 是否有附件 + NoteColumns.MODIFIED_DATE, // 修改日期 + NoteColumns.NOTES_COUNT, // 笔记数量 + NoteColumns.PARENT_ID, // 父ID + NoteColumns.SNIPPET, // 笔记摘要 + NoteColumns.TYPE, // 笔记类型 + NoteColumns.WIDGET_ID, // 小部件ID + NoteColumns.WIDGET_TYPE, // 小部件类型 }; + // 定义各个列在PROJECTION数组中的索引 private static final int ID_COLUMN = 0; private static final int ALERTED_DATE_COLUMN = 1; private static final int BG_COLOR_ID_COLUMN = 2; @@ -55,6 +57,7 @@ public class NoteItemData { 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; @@ -70,12 +73,14 @@ public class NoteItemData { private String mName; private String mPhoneNumber; + // 定义笔记项的位置相关标志 private boolean mIsLastItem; private boolean mIsFirstItem; private boolean mIsOnlyOneItem; private boolean mIsOneNoteFollowingFolder; private boolean mIsMultiNotesFollowingFolder; + // 构造函数，从Cursor中读取数据并初始化NoteItemData对象 public NoteItemData(Context context, Cursor cursor) { mId = cursor.getLong(ID_COLUMN); mAlertDate = cursor.getLong(ALERTED_DATE_COLUMN); @@ -93,6 +98,7 @@ public class NoteItemData { mWidgetType = cursor.getInt(WIDGET_TYPE_COLUMN); mPhoneNumber = ""; + // 如果父ID是通话记录文件夹，则获取通话号码和联系人名称 if (mParentId == Notes.ID_CALL_RECORD_FOLDER) { mPhoneNumber = DataUtils.getCallNumberByNoteId(context.getContentResolver(), mId); if (!TextUtils.isEmpty(mPhoneNumber)) { @@ -106,9 +112,11 @@ public class NoteItemData { if (mName == null) { mName = ""; } + // 检查笔记项的位置 checkPostion(cursor); } + // 检查笔记项在Cursor中的位置，并设置相应的标志 private void checkPostion(Cursor cursor) { mIsLastItem = cursor.isLast() ? true : false; mIsFirstItem = cursor.isFirst() ? true : false; @@ -116,6 +124,7 @@ public class NoteItemData { mIsMultiNotesFollowingFolder = false; mIsOneNoteFollowingFolder = false; + // 如果笔记类型是普通笔记且不是第一个笔记，则检查前一个笔记的类型 if (mType == Notes.TYPE_NOTE && !mIsFirstItem) { int position = cursor.getPosition(); if (cursor.moveToPrevious()) { @@ -134,90 +143,112 @@ public class NoteItemData { } } + // 判断是否只有一个笔记跟随文件夹 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; } + // 获取笔记ID public long getId() { return mId; } + // 获取提醒日期 public long getAlertDate() { return mAlertDate; } + // 获取创建日期 public long getCreatedDate() { return mCreatedDate; } + // 判断是否有附件 public boolean hasAttachment() { return mHasAttachment; } + // 获取修改日期 public long getModifiedDate() { return mModifiedDate; } + // 获取背景颜色ID public int getBgColorId() { return mBgColorId; } + // 获取父ID public long getParentId() { return mParentId; } + // 获取笔记数量 public int getNotesCount() { return mNotesCount; } + // 获取文件夹ID public long getFolderId () { return mParentId; } + // 获取笔记类型 public int getType() { return mType; } + // 获取小部件类型 public int getWidgetType() { return mWidgetType; } + // 获取小部件ID public int getWidgetId() { return mWidgetId; } + // 获取笔记摘要 public String getSnippet() { return mSnippet; } + // 判断是否有提醒 public boolean hasAlert() { return (mAlertDate > 0); } + // 判断是否是通话记录 public boolean isCallRecord() { return (mParentId == Notes.ID_CALL_RECORD_FOLDER && !TextUtils.isEmpty(mPhoneNumber)); } + // 静态方法，从Cursor中获取笔记类型 public static int getNoteType(Cursor cursor) { return cursor.getInt(TYPE_COLUMN); } diff --git a/src/src/net/micode/notes/ui/NotesListActivity.java b/src/src/net/micode/notes/ui/NotesListActivity.java index e843aec..075491c 100644 --- a/src/src/net/micode/notes/ui/NotesListActivity.java +++ b/src/src/net/micode/notes/ui/NotesListActivity.java @@ -79,107 +79,155 @@ import java.io.InputStreamReader; import java.util.HashSet; public class NotesListActivity extends Activity implements OnClickListener, OnItemLongClickListener { + // 定义查询文件夹笔记列表的令牌 private static final int FOLDER_NOTE_LIST_QUERY_TOKEN = 0; + // 定义查询文件夹列表的令牌 private static final int FOLDER_LIST_QUERY_TOKEN = 1; + // 定义文件夹菜单的删除选项 private static final int MENU_FOLDER_DELETE = 0; + // 定义文件夹菜单的查看选项 private static final int MENU_FOLDER_VIEW = 1; + // 定义文件夹菜单的更改名称选项 private static final int MENU_FOLDER_CHANGE_NAME = 2; + // 定义首选项中添加介绍的键 private static final String PREFERENCE_ADD_INTRODUCTION = "net.micode.notes.introduction"; + // 定义列表编辑状态枚举 private enum ListEditState { NOTE_LIST, SUB_FOLDER, CALL_RECORD_FOLDER }; + // 当前列表编辑状态 private ListEditState mState; + // 后台查询处理器 private BackgroundQueryHandler mBackgroundQueryHandler; + // 笔记列表适配器 private NotesListAdapter mNotesListAdapter; + // 笔记列表视图 private ListView mNotesListView; + // 添加新笔记按钮 private Button mAddNewNote; + // 是否分发事件 private boolean mDispatch; + // 原始Y坐标 private int mOriginY; + // 分发Y坐标 private int mDispatchY; + // 标题栏 private TextView mTitleBar; + // 当前文件夹ID private long mCurrentFolderId; + // 内容解析器 private ContentResolver mContentResolver; + // 多选模式回调 private ModeCallback mModeCallBack; + // 日志标签 private static final String TAG = "NotesListActivity"; + // 笔记列表视图滚动速率 public static final int NOTES_LISTVIEW_SCROLL_RATE = 30; + // 焦点笔记数据项 private NoteItemData mFocusNoteDataItem; + // 正常选择条件 private static final String NORMAL_SELECTION = NoteColumns.PARENT_ID + "=?"; + // 根文件夹选择条件 private static final String ROOT_FOLDER_SELECTION = "(" + NoteColumns.TYPE + "<>" + Notes.TYPE_SYSTEM + " AND " + NoteColumns.PARENT_ID + "=?)" + " OR (" + NoteColumns.ID + "=" + Notes.ID_CALL_RECORD_FOLDER + " AND " + NoteColumns.NOTES_COUNT + ">0)"; + // 打开笔记的请求代码 private final static int REQUEST_CODE_OPEN_NODE = 102; + // 新建笔记的请求代码 private final static int REQUEST_CODE_NEW_NODE = 103; @Override + // 重写父类的方法，这里是重写Activity类的onCreate方法 protected void onCreate(Bundle savedInstanceState) { + // 调用父类的onCreate方法，确保Activity正常创建 super.onCreate(savedInstanceState); + // 设置当前Activity的布局文件为note_list.xml setContentView(R.layout.note_list); + // 初始化资源，具体实现可能在initResources方法中定义 initResources(); /** * Insert an introduction when user firstly use this application */ + // 从原始资源文件中设置应用信息，可能是首次使用应用时的引导信息 setAppInfoFromRawRes(); } @Override + // 重写父类的方法，处理从其他Activity返回的结果 protected void onActivityResult(int requestCode, int resultCode, Intent data) { + // 检查返回结果是否为RESULT_OK，并且请求码为打开节点或新建节点 if (resultCode == RESULT_OK && (requestCode == REQUEST_CODE_OPEN_NODE || requestCode == REQUEST_CODE_NEW_NODE)) { + // 如果条件满足，调用适配器的changeCursor方法，传入null，刷新数据 mNotesListAdapter.changeCursor(null); } else { + // 如果条件不满足，调用父类的onActivityResult方法，继续处理结果 super.onActivityResult(requestCode, resultCode, data); } } + // 从原始资源文件中设置应用信息的方法 private void setAppInfoFromRawRes() { + // 获取SharedPreferences实例，用于存储和读取应用偏好设置 SharedPreferences sp = PreferenceManager.getDefaultSharedPreferences(this); + // 检查是否已经添加了介绍信息，如果没有则进行添加 if (!sp.getBoolean(PREFERENCE_ADD_INTRODUCTION, false)) { + // 创建StringBuilder用于构建读取的文本内容 StringBuilder sb = new StringBuilder(); InputStream in = null; try { + // 打开原始资源文件，文件名为introduction in = getResources().openRawResource(R.raw.introduction); + // 检查输入流是否为空 if (in != null) { + // 创建InputStreamReader和BufferedReader用于读取文件内容 InputStreamReader isr = new InputStreamReader(in); BufferedReader br = new BufferedReader(isr); + // 创建字符数组用于存储读取的字符 char [] buf = new char[1024]; int len = 0; + // 循环读取文件内容，直到读取完毕 while ((len = br.read(buf)) > 0) { + // 将读取的字符追加到StringBuilder中 sb.append(buf, 0, len); } } else { + // 如果输入流为空，则记录错误日志并返回 Log.e(TAG, "Read introduction file error"); return; } } catch (IOException e) { + // 捕获IO异常并打印堆栈信息，然后返回 e.printStackTrace(); return; } finally { + // 确保输入流被正确关闭 if(in != null) { try { in.close(); @@ -190,13 +238,18 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } } + // 创建一个空的WorkingNote对象 WorkingNote note = WorkingNote.createEmptyNote(this, Notes.ID_ROOT_FOLDER, AppWidgetManager.INVALID_APPWIDGET_ID, Notes.TYPE_WIDGET_INVALIDE, ResourceParser.RED); + // 设置工作文本为读取的介绍信息 note.setWorkingText(sb.toString()); + // 保存工作笔记 if (note.saveNote()) { + // 如果保存成功，更新SharedPreferences标记为已添加介绍信息 sp.edit().putBoolean(PREFERENCE_ADD_INTRODUCTION, true).commit(); } else { + // 如果保存失败，记录错误日志并返回 Log.e(TAG, "Save introduction note error"); return; } @@ -204,42 +257,70 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } @Override + // 重写父类的方法，表示这个方法是一个覆盖方法 protected void onStart() { + // 调用父类的onStart方法，确保父类的逻辑得以执行 super.onStart(); + // 调用startAsyncNotesListQuery方法，开始异步查询笔记列表 startAsyncNotesListQuery(); } + // 初始化资源的方法 private void initResources() { + // 获取当前Activity的内容解析器 mContentResolver = this.getContentResolver(); + // 创建一个后台查询处理器，用于在后台线程中执行查询操作 mBackgroundQueryHandler = new BackgroundQueryHandler(this.getContentResolver()); + // 设置当前文件夹ID为根文件夹ID mCurrentFolderId = Notes.ID_ROOT_FOLDER; + // 获取笔记列表视图 mNotesListView = (ListView) findViewById(R.id.notes_list); + // 向笔记列表视图添加一个页脚视图 mNotesListView.addFooterView(LayoutInflater.from(this).inflate(R.layout.note_list_footer, null), null, false); + // 设置笔记列表项的点击监听器 mNotesListView.setOnItemClickListener(new OnListItemClickListener()); + // 设置笔记列表项的长按监听器 mNotesListView.setOnItemLongClickListener(this); + // 创建并设置笔记列表适配器 mNotesListAdapter = new NotesListAdapter(this); mNotesListView.setAdapter(mNotesListAdapter); + // 获取添加新笔记的按钮 mAddNewNote = (Button) findViewById(R.id.btn_new_note); + // 设置添加新笔记按钮的点击监听器 mAddNewNote.setOnClickListener(this); + // 设置添加新笔记按钮的触摸监听器 mAddNewNote.setOnTouchListener(new NewNoteOnTouchListener()); + // 初始化触摸事件相关的变量 mDispatch = false; mDispatchY = 0; mOriginY = 0; + // 获取标题栏文本视图 mTitleBar = (TextView) findViewById(R.id.tv_title_bar); + // 设置当前状态为笔记列表状态 mState = ListEditState.NOTE_LIST; + // 创建并设置模式回调 mModeCallBack = new ModeCallback(); } + // 定义一个内部类ModeCallback，实现ListView.MultiChoiceModeListener和OnMenuItemClickListener接口 private class ModeCallback implements ListView.MultiChoiceModeListener, OnMenuItemClickListener { + // 声明DropdownMenu对象，用于显示下拉菜单 private DropdownMenu mDropDownMenu; + // 声明ActionMode对象，用于多选模式 private ActionMode mActionMode; + // 声明MenuItem对象，用于移动菜单项 private MenuItem mMoveMenu; + // 当ActionMode创建时调用，初始化菜单和视图 public boolean onCreateActionMode(ActionMode mode, Menu menu) { + // 加载菜单布局 getMenuInflater().inflate(R.menu.note_list_options, menu); + // 设置删除菜单项的点击监听器 menu.findItem(R.id.delete).setOnMenuItemClickListener(this); + // 获取移动菜单项 mMoveMenu = menu.findItem(R.id.move); + // 根据条件设置移动菜单项的可见性 if (mFocusNoteDataItem.getParentId() == Notes.ID_CALL_RECORD_FOLDER || DataUtils.getUserFolderCount(mContentResolver) == 0) { mMoveMenu.setVisible(false); @@ -247,20 +328,30 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt mMoveMenu.setVisible(true); mMoveMenu.setOnMenuItemClickListener(this); } + // 保存当前的ActionMode对象 mActionMode = mode; + // 设置笔记列表适配器为选择模式 mNotesListAdapter.setChoiceMode(true); + // 设置笔记列表不可长按 mNotesListView.setLongClickable(false); + // 隐藏添加新笔记的按钮 mAddNewNote.setVisibility(View.GONE); + // 加载自定义视图 View customView = LayoutInflater.from(NotesListActivity.this).inflate( R.layout.note_list_dropdown_menu, null); + // 设置ActionMode的自定义视图 mode.setCustomView(customView); + // 初始化下拉菜单 mDropDownMenu = new DropdownMenu(NotesListActivity.this, (Button) customView.findViewById(R.id.selection_menu), R.menu.note_list_dropdown); + // 设置下拉菜单项的点击监听器 mDropDownMenu.setOnDropdownMenuItemClickListener(new PopupMenu.OnMenuItemClickListener(){ public boolean onMenuItemClick(MenuItem item) { + // 切换全选/取消全选状态 mNotesListAdapter.selectAll(!mNotesListAdapter.isAllSelected()); + // 更新菜单 updateMenu(); return true; } @@ -269,7 +360,10 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt return true; } + // 更新菜单标题和选项状态 + // 更新菜单项的方法 private void updateMenu() { + // 获取当前选中的笔记数量 int selectedCount = mNotesListAdapter.getSelectedCount(); // Update dropdown menu String format = getResources().getString(R.string.menu_select_title, selectedCount); @@ -286,80 +380,120 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } } + // 定义一个方法，用于在ActionMode准备就绪时进行一些操作 public boolean onPrepareActionMode(ActionMode mode, Menu menu) { // TODO Auto-generated method stub + // 这是一个自动生成的代码注释，提示开发者这里可以添加自定义逻辑 + // 返回false，表示没有对菜单进行任何修改 return false; } + // 定义一个方法，用于处理ActionMode中的菜单项点击事件 public boolean onActionItemClicked(ActionMode mode, MenuItem item) { // TODO Auto-generated method stub + // 这是一个自动生成的代码注释，提示开发者此处需要实现具体的功能 + // 返回false，表示该点击事件未被处理 return false; } + // 当操作模式被销毁时调用的方法 public void onDestroyActionMode(ActionMode mode) { + // 设置笔记列表适配器的选择模式为false，即取消选择模式 mNotesListAdapter.setChoiceMode(false); + // 设置笔记列表视图的长按可点击性为true，即允许长按操作 mNotesListView.setLongClickable(true); + // 设置添加新笔记按钮的可见性为VISIBLE，即显示按钮 mAddNewNote.setVisibility(View.VISIBLE); } + // 定义一个公共方法，用于结束操作模式 public void finishActionMode() { + // 调用mActionMode对象的finish方法，结束当前的操作模式 mActionMode.finish(); } + // 定义一个方法，当列表项的选中状态发生变化时被调用 public void onItemCheckedStateChanged(ActionMode mode, int position, long id, boolean checked) { + // 调用适配器的方法，设置指定位置项的选中状态 mNotesListAdapter.setCheckedItem(position, checked); + // 更新菜单，可能是为了根据选中状态显示或隐藏某些菜单项 updateMenu(); } + // 定义一个方法来处理菜单项点击事件 public boolean onMenuItemClick(MenuItem item) { + // 检查当前选中的笔记数量是否为0 if (mNotesListAdapter.getSelectedCount() == 0) { + // 如果没有选中任何笔记，显示一个提示信息 Toast.makeText(NotesListActivity.this, getString(R.string.menu_select_none), Toast.LENGTH_SHORT).show(); + // 返回true表示事件已处理 return true; } + // 根据点击的菜单项ID进行不同的处理 switch (item.getItemId()) { case R.id.delete: + // 创建一个AlertDialog.Builder对象来构建删除确认对话框 AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.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_notes, mNotesListAdapter.getSelectedCount())); + // 设置对话框的确定按钮及其点击事件 builder.setPositiveButton(android.R.string.ok, new DialogInterface.OnClickListener() { public void onClick(DialogInterface dialog, int which) { + // 调用批量删除方法 batchDelete(); } }); + // 设置对话框的取消按钮 builder.setNegativeButton(android.R.string.cancel, null); + // 显示对话框 builder.show(); break; case R.id.move: + // 调用方法查询目标文件夹 startQueryDestinationFolders(); break; default: + // 如果点击的菜单项ID不在上述范围内，返回false表示未处理 return false; } + // 返回true表示事件已处理 return true; } } + // 定义一个内部类 NewNoteOnTouchListener，实现 OnTouchListener 接口，用于处理触摸事件 private class NewNoteOnTouchListener implements OnTouchListener { + // 重写 onTouch 方法，处理触摸事件 public boolean onTouch(View v, MotionEvent event) { + // 根据触摸事件的类型进行不同的处理 switch (event.getAction()) { case MotionEvent.ACTION_DOWN: { + // 获取当前窗口的显示对象 Display display = getWindowManager().getDefaultDisplay(); + // 获取屏幕的高度 int screenHeight = display.getHeight(); + // 获取“新建笔记”按钮视图的高度 int newNoteViewHeight = mAddNewNote.getHeight(); + // 计算触摸事件在屏幕中的起始位置 int start = screenHeight - newNoteViewHeight; + // 计算触摸事件的 Y 坐标 int eventY = start + (int) event.getY(); /** * Minus TitleBar's height */ if (mState == ListEditState.SUB_FOLDER) { + // 如果当前状态为子文件夹，减去标题栏的高度 eventY -= mTitleBar.getHeight(); start -= mTitleBar.getHeight(); } @@ -372,43 +506,63 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt * Notice that, if the background of the button changes, the formula should * also change. This is very bad, just for the UI designer's strong requirement. */ + // 判断触摸点是否在“新建笔记”按钮的透明部分 if (event.getY() < (event.getX() * (-0.12) + 94)) { + // 获取列表视图中的最后一个子视图 View view = mNotesListView.getChildAt(mNotesListView.getChildCount() - 1 - mNotesListView.getFooterViewsCount()); if (view != null && view.getBottom() > start && (view.getTop() < (start + 94))) { + // 记录原始触摸事件的 Y 坐标 mOriginY = (int) event.getY(); + // 计算需要分发的 Y 坐标 mDispatchY = eventY; + // 设置触摸事件的新位置 event.setLocation(event.getX(), mDispatchY); + // 标记需要分发事件 mDispatch = true; + // 分发触摸事件到列表视图 return mNotesListView.dispatchTouchEvent(event); } } break; } case MotionEvent.ACTION_MOVE: { + // 如果需要分发事件 if (mDispatch) { + // 更新需要分发的 Y 坐标 mDispatchY += (int) event.getY() - mOriginY; + // 设置触摸事件的新位置 event.setLocation(event.getX(), mDispatchY); + // 分发触摸事件到列表视图 return mNotesListView.dispatchTouchEvent(event); } break; } default: { + // 如果需要分发事件 if (mDispatch) { + // 设置触摸事件的新位置 event.setLocation(event.getX(), mDispatchY); + // 取消标记需要分发事件 mDispatch = false; + // 分发触摸事件到列表视图 return mNotesListView.dispatchTouchEvent(event); } break; } } + // 默认返回 false，表示未处理该触摸事件 return false; } }; + // 定义一个私有方法，用于启动异步的笔记列表查询 private void startAsyncNotesListQuery() { + // 根据当前文件夹ID是否为根文件夹，选择不同的查询条件 + // 如果当前文件夹ID等于根文件夹ID，则使用根文件夹的查询条件 + // 否则使用普通文件夹的查询条件 String selection = (mCurrentFolderId == Notes.ID_ROOT_FOLDER) ? ROOT_FOLDER_SELECTION : NORMAL_SELECTION; mBackgroundQueryHandler.startQuery(FOLDER_NOTE_LIST_QUERY_TOKEN, null, @@ -417,62 +571,94 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt }, NoteColumns.TYPE + " DESC," + NoteColumns.MODIFIED_DATE + " DESC"); } + // 定义一个私有的最终类 BackgroundQueryHandler，继承自 AsyncQueryHandler private final class BackgroundQueryHandler extends AsyncQueryHandler { + // 构造函数，接收一个 ContentResolver 对象，并调用父类的构造函数 public BackgroundQueryHandler(ContentResolver contentResolver) { super(contentResolver); } + // 重写 onQueryComplete 方法，在查询完成时被调用 @Override protected void onQueryComplete(int token, Object cookie, Cursor cursor) { + // 使用 switch 语句根据 token 的值来处理不同的查询结果 switch (token) { case FOLDER_NOTE_LIST_QUERY_TOKEN: + // 如果 token 是 FOLDER_NOTE_LIST_QUERY_TOKEN，则更新 mNotesListAdapter 的数据源 mNotesListAdapter.changeCursor(cursor); break; case FOLDER_LIST_QUERY_TOKEN: + // 如果 token 是 FOLDER_LIST_QUERY_TOKEN，则检查 cursor 是否不为空且包含数据 if (cursor != null && cursor.getCount() > 0) { + // 如果有数据，则显示文件夹列表菜单 showFolderListMenu(cursor); } else { + // 如果没有数据，则记录错误日志 Log.e(TAG, "Query folder failed"); } break; default: + // 如果 token 不匹配任何已知值，则直接返回 return; } } } + // 定义一个私有方法showFolderListMenu，用于显示文件夹列表菜单 private void showFolderListMenu(Cursor cursor) { + // 创建一个AlertDialog.Builder对象，用于构建对话框 AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this); + // 设置对话框的标题，标题内容来自资源文件中的menu_title_select_folder builder.setTitle(R.string.menu_title_select_folder); + // 创建一个FoldersListAdapter对象，用于适配文件夹列表数据 final FoldersListAdapter adapter = new FoldersListAdapter(this, cursor); + // 设置对话框的适配器，用于显示文件夹列表 builder.setAdapter(adapter, new DialogInterface.OnClickListener() { + // 当用户点击对话框中的某个选项时，执行此方法 public void onClick(DialogInterface dialog, int which) { + // 调用DataUtils的batchMoveToFolder方法，将选中的笔记批量移动到指定的文件夹 DataUtils.batchMoveToFolder(mContentResolver, mNotesListAdapter.getSelectedItemIds(), adapter.getItemId(which)); + // 显示一个Toast消息，提示用户笔记已移动到指定文件夹 Toast.makeText( NotesListActivity.this, + // 格式化字符串，显示移动的笔记数量和目标文件夹名称 getString(R.string.format_move_notes_to_folder, mNotesListAdapter.getSelectedCount(), adapter.getFolderName(NotesListActivity.this, which)), + // 设置Toast显示时长为短时间 Toast.LENGTH_SHORT).show(); + // 调用mModeCallBack的finishActionMode方法，结束当前的操作模式 mModeCallBack.finishActionMode(); } }); + // 显示对话框 builder.show(); } + // 定义一个私有方法用于创建新笔记 private void createNewNote() { + // 创建一个Intent对象，用于从当前Activity跳转到NoteEditActivity Intent intent = new Intent(this, NoteEditActivity.class); + // 设置Intent的动作类型为插入或编辑 intent.setAction(Intent.ACTION_INSERT_OR_EDIT); + // 向Intent中添加一个额外的数据，表示当前文件夹的ID intent.putExtra(Notes.INTENT_EXTRA_FOLDER_ID, mCurrentFolderId); + // 调用startActivityForResult方法启动NoteEditActivity，并传递Intent和请求码 + // 请求码用于在NoteEditActivity返回结果时标识这次请求 this.startActivityForResult(intent, REQUEST_CODE_NEW_NODE); } + // 定义一个私有方法batchDelete，用于批量删除选中的笔记 private void batchDelete() { + // 创建一个新的AsyncTask，用于在后台执行删除操作 new AsyncTask>() { + // 在后台执行删除操作 protected HashSet doInBackground(Void... unused) { + // 获取选中的笔记对应的AppWidgetAttribute集合 HashSet widgets = mNotesListAdapter.getSelectedWidget(); + // 检查当前是否处于同步模式 if (!isSyncMode()) { // if not synced, delete notes directly if (DataUtils.batchDeleteNotes(mContentResolver, mNotesListAdapter