时间日期选择窗口注释

src/Notes-master/src/net/micode/notes/ui/DateTimePickerDialog.java

@@ -30,61 +30,78 @@ import android.text.format.DateFormat;
 import android.text.format.DateUtils;
 
 public class DateTimePickerDialog extends AlertDialog implements OnClickListener {
-
+    // 用于存储日期时间的Calendar对象
     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) {
+                // 当日期时间变化时更新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());
             }
         });
+        // 设置初始日期时间
         mDate.setTimeInMillis(date);
-        mDate.set(Calendar.SECOND, 0);
+        mDate.set(Calendar.SECOND, 0);  // 秒数设为0
         mDateTimePicker.setCurrentDate(mDate.getTimeInMillis());
+        // 设置确定和取消按钮
         setButton(context.getString(R.string.datetime_dialog_ok), this);
         setButton2(context.getString(R.string.datetime_dialog_cancel), (OnClickListener)null);
+        // 根据系统设置决定是否使用24小时制
         set24HourView(DateFormat.is24HourFormat(this.getContext()));
+        // 初始化对话框标题
         updateTitle(mDate.getTimeInMillis());
     }
 
+    // 设置是否使用24小时制显示时间
     public void set24HourView(boolean is24HourView) {
         mIs24HourView = is24HourView;
     }
 
+    // 设置日期时间设置完成的回调
     public void setOnDateTimeSetListener(OnDateTimeSetListener callBack) {
         mOnDateTimeSetListener = callBack;
     }
 
+    // 更新对话框标题显示当前日期时间
     private void updateTitle(long date) {
         int flag =
-            DateUtils.FORMAT_SHOW_YEAR |
-            DateUtils.FORMAT_SHOW_DATE |
-            DateUtils.FORMAT_SHOW_TIME;
+            DateUtils.FORMAT_SHOW_YEAR |      // 显示年份
+            DateUtils.FORMAT_SHOW_DATE |     // 显示日期
+            DateUtils.FORMAT_SHOW_TIME;       // 显示时间
         flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_24HOUR;
+        // 使用DateUtils格式化日期时间并设置为标题
         setTitle(DateUtils.formatDateTime(this.getContext(), date, flag));
     }
 
+    // 点击确定按钮时调用回调函数
     public void onClick(DialogInterface arg0, int arg1) {
         if (mOnDateTimeSetListener != null) {
             mOnDateTimeSetListener.OnDateTimeSet(this, mDate.getTimeInMillis());
         }
     }
-
 }