From 9d222dac4bfa2cc978c5290d09c2c23fa69cfff1 Mon Sep 17 00:00:00 2001
From: "langcaijinjiangyan@outlook.com" <langcaijinjiangyan@outlook.com>
Date: Wed, 13 Dec 2023 11:58:03 +0800
Subject: [PATCH] Finish reading WoringNote.setAlertDate

---
 .../net/micode/notes/model/WorkingNote.java   | 12 +++++++-
 .../net/micode/notes/ui/NoteEditActivity.java | 28 +++++++++++++++++++
 2 files changed, 39 insertions(+), 1 deletion(-)

diff --git a/src/main/java/net/micode/notes/model/WorkingNote.java b/src/main/java/net/micode/notes/model/WorkingNote.java
index 747e586..4e5a4e7 100644
--- a/src/main/java/net/micode/notes/model/WorkingNote.java
+++ b/src/main/java/net/micode/notes/model/WorkingNote.java
@@ -229,12 +229,22 @@ public class WorkingNote {
         mNoteSettingStatusListener = l;
     }
 
-    //TODO add comments of this method
+    /**
+     * @Method      setAlertDate
+     * @Date        2023/12/13 11:43
+     * @param       date 提醒日期
+     * @param       set 动作（关闭或开启）
+     * @Author      lenovo
+     * @Return      void
+     * @Description 设置一个提醒时间
+     */
     public void setAlertDate(long date, boolean set) {
+        // 更新便签项中的提醒日期
         if (date != mAlertDate) {
             mAlertDate = date;
             mNote.setNoteValue(NoteColumns.ALERTED_DATE, String.valueOf(mAlertDate));
         }
+        // 设置提醒的监听事件
         if (mNoteSettingStatusListener != null) {
             mNoteSettingStatusListener.onClockAlertChanged(date, set);
         }
diff --git a/src/main/java/net/micode/notes/ui/NoteEditActivity.java b/src/main/java/net/micode/notes/ui/NoteEditActivity.java
index 90dc00a..22044e0 100644
--- a/src/main/java/net/micode/notes/ui/NoteEditActivity.java
+++ b/src/main/java/net/micode/notes/ui/NoteEditActivity.java
@@ -295,15 +295,32 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         showAlertHeader();
     }
 
+    /**
+     * @Method      showAlertHeader
+     * @Date        2023/12/13 11:32
+     * @Author      lenovo
+     * @Return      void
+     * @Description 在便签页面的上方栏显示提醒信息
+     */
     private void showAlertHeader() {
         if (mWorkingNote.hasClockAlert()) {
             long time = System.currentTimeMillis();
             if (time > mWorkingNote.getAlertDate()) {
+                // 闹钟时间大于当前时间, 显示 "Expired"， 闹钟失效
                 mNoteHeaderHolder.tvAlertDate.setText(R.string.note_alert_expired);
             } else {
+                // 显示正常闹钟信息
                 mNoteHeaderHolder.tvAlertDate.setText(DateUtils.getRelativeTimeSpanString(
                         mWorkingNote.getAlertDate(), time, DateUtils.MINUTE_IN_MILLIS));
             }
+            /**
+             * setVisibility()
+             * 用于设置空间的可见性
+             * VISIBLE 可见
+             * INVISIBLE 不可见，但是占用一个位置
+             * GNONE 不可见且不占用位置
+             * lenovo 2023/12/13 11:28
+            */
             mNoteHeaderHolder.tvAlertDate.setVisibility(View.VISIBLE);
             mNoteHeaderHolder.ivAlertIcon.setVisibility(View.VISIBLE);
         } else {
@@ -603,6 +620,15 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0;
     }
 
+    /**
+     * @Method      onClockAlertChanged
+     * @Date        2023/12/13 9:52
+     * @param       date
+     * @param       set 0 取消 1 设置
+     * @Author      lenovo
+     * @Return      void
+     * @Description 设置提醒的监听事件
+     */
     public void onClockAlertChanged(long date, boolean set) {
         /**
          * User could set clock to an unsaved note, so before setting the
@@ -618,8 +644,10 @@ public class NoteEditActivity extends Activity implements OnClickListener,
             AlarmManager alarmManager = ((AlarmManager) getSystemService(ALARM_SERVICE));
             showAlertHeader();
             if(!set) {
+                // 取消监听事件
                 alarmManager.cancel(pendingIntent);
             } else {
+                // 设置监听事件，到时间启动提醒
                 alarmManager.set(AlarmManager.RTC_WAKEUP, date, pendingIntent);
             }
         } else {