Notesmaster/app/src/main/java/net/micode/notes/ui/DateTimePickerDialog.java

@@ -31,60 +31,113 @@ 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 {
+        /**
+         * 当日期时间设置完成时调用
+         * @param dialog 对话框实例
+         * @param date 选择的日期时间（毫秒值）
+         */
         void OnDateTimeSet(AlertDialog dialog, long date);
     }
 
+    /**
+     * 构造函数，创建日期时间选择对话框
+     * @param context 上下文对象
+     * @param 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) {
+                                          int dayOfMonth, int hourOfDay, int minute) {
+                // 更新Calendar对象中的日期时间
                 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());
             }
         });
+
+        // 设置初始日期时间，并将秒数设为0
         mDate.setTimeInMillis(date);
         mDate.set(Calendar.SECOND, 0);
+
+        // 在日期时间选择器中显示初始日期时间
         mDateTimePicker.setCurrentDate(mDate.getTimeInMillis());
+
+        // 设置对话框按钮
         setButton(context.getString(R.string.datetime_dialog_ok), this);
         setButton2(context.getString(R.string.datetime_dialog_cancel), (OnClickListener)null);
+
+        // 根据系统设置确定是否使用24小时制
         set24HourView(DateFormat.is24HourFormat(this.getContext()));
+        // 更新对话框标题
         updateTitle(mDate.getTimeInMillis());
     }
 
+    /**
+     * 设置是否使用24小时制显示时间
+     * @param is24HourView true表示使用24小时制，false表示使用12小时制
+     */
     public void set24HourView(boolean is24HourView) {
         mIs24HourView = is24HourView;
     }
 
+    /**
+     * 设置日期时间选择完成后的回调监听器
+     * @param callBack 实现了OnDateTimeSetListener接口的回调对象
+     */
     public void setOnDateTimeSetListener(OnDateTimeSetListener callBack) {
         mOnDateTimeSetListener = callBack;
     }
 
+    /**
+     * 更新对话框标题，显示当前选择的日期时间
+     * @param date 日期时间（毫秒值）
+     */
     private void updateTitle(long date) {
+        // 设置日期时间显示格式标志
         int flag =
-            DateUtils.FORMAT_SHOW_YEAR |
-            DateUtils.FORMAT_SHOW_DATE |
-            DateUtils.FORMAT_SHOW_TIME;
+                DateUtils.FORMAT_SHOW_YEAR |
+                        DateUtils.FORMAT_SHOW_DATE |
+                        DateUtils.FORMAT_SHOW_TIME;
+        // 根据是否使用24小时制添加相应的格式标志
         flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_24HOUR;
+
+        // 更新对话框标题
         setTitle(DateUtils.formatDateTime(this.getContext(), date, flag));
     }
 
+    /**
+     * 处理对话框按钮点击事件
+     * @param arg0 对话框接口
+     * @param arg1 按钮标识
+     */
     public void onClick(DialogInterface arg0, int arg1) {
+        // 当点击"确定"按钮时，调用回调函数通知日期时间已设置
         if (mOnDateTimeSetListener != null) {
             mOnDateTimeSetListener.OnDateTimeSet(this, mDate.getTimeInMillis());
         }
     }
-
 }