添加代码注释

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

@@ -1,17 +1,9 @@
 /*
  * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
  *
- * Licensed under the Apache License, Version 2.0 (the "License");
+ * 版权声明：本代码受Apache许可证2.0版本保护
- * you may not use this file except in compliance with the License.
+ * 您可以在遵守许可证的前提下使用、修改和分发本代码
- * You may obtain a copy of the License at
+ * 许可证全文可在http://www.apache.org/licenses/LICENSE-2.0获取
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
  */
 
 package net.micode.notes.ui;
@@ -29,59 +21,113 @@ import android.content.DialogInterface.OnClickListener;
 import android.text.format.DateFormat;
 import android.text.format.DateUtils;
 
+/**
+ * 日期时间选择对话框
+ * 功能：封装DateTimePicker控件，提供弹窗式的日期时间选择界面
+ * 特点：支持标题自动更新、24小时制/12小时制切换、确定/取消按钮
+ */
 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);
     }
 
+    /**
+     * 构造函数
+     * @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) {
+                // 更新日历对象
                 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());
+        
+        // 设置对话框按钮
         setButton(context.getString(R.string.datetime_dialog_ok), this);
         setButton2(context.getString(R.string.datetime_dialog_cancel), (OnClickListener)null);
+        
+        // 设置时间显示模式
         set24HourView(DateFormat.is24HourFormat(this.getContext()));
+        
+        // 初始化对话框标题
         updateTitle(mDate.getTimeInMillis());
     }
 
+    /**
+     * 设置时间显示模式
+     * @param is24HourView true为24小时制，false为12小时制
+     */
     public void set24HourView(boolean is24HourView) {
         mIs24HourView = is24HourView;
     }
 
+    /**
+     * 设置日期时间选择回调
+     * @param callBack 回调接口实现
+     */
     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;
+        
+        // 根据24小时制/12小时制设置相应标志
         flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_24HOUR;
+        
+        // 使用系统工具类格式化日期并设置为标题
         setTitle(DateUtils.formatDateTime(this.getContext(), date, flag));
     }
 
+    /**
+     * 点击事件处理
+     * 当用户点击确定按钮时触发
+     */
     public void onClick(DialogInterface arg0, int arg1) {
+        // 调用回调接口，传递选择的日期时间
         if (mOnDateTimeSetListener != null) {
             mOnDateTimeSetListener.OnDateTimeSet(this, mDate.getTimeInMillis());
         }