/*
 * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * 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
 *
 * 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;
 
import java.util.Calendar;
 
import net.micode.notes.R;
import net.micode.notes.ui.DateTimePicker;
import net.micode.notes.ui.DateTimePicker.OnDateTimeChangedListener;
 
import android.app.AlertDialog;
import android.content.Context;
import android.content.DialogInterface;
import android.content.DialogInterface.OnClickListener;
import android.text.format.DateFormat;
import android.text.format.DateUtils;
 
public class DateTimePickerDialog extends AlertDialog implements OnClickListener {
 
    private Calendar mDate = Calendar.getInstance();
    //创建一个Calendar类型的变量 mDate，方便时间的操作
    private boolean mIs24HourView;
    private OnDateTimeSetListener mOnDateTimeSetListener;
    //声明一个时间日期滚动选择控件 mOnDateTimeSetListener
    private DateTimePicker mDateTimePicker;
    //DateTimePicker控件，控件一般用于让用户可以从日期列表中选择单个值。
    //运行时，单击控件边上的下拉箭头，会显示为两个部分：一个下拉列表，一个用于选择日期的
 
    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);
        // 设置 Calendar 对象的月份（注意：月份从 0 开始，因此需要减去 1）
            mDate.set(Calendar.MONTH, month);
        // 设置 Calendar 对象的日
            mDate.set(Calendar.DAY_OF_MONTH, dayOfMonth);
        // 设置 Calendar 对象的小时
            mDate.set(Calendar.HOUR_OF_DAY, hourOfDay);
        // 设置 Calendar 对象的分钟
            mDate.set(Calendar.MINUTE, minute);
        }
    });

//这段代码是一个 Android 应用中使用的日期时间选择器的监听器设置。在监听器的onDateTimeChanged方法中，通过传递进来的参数，设置了一个 Calendar 对象的各个字段，以便后续使用。希望这样的注释对你理解代码有所帮助。
                //将视图中的各选项设置为系统当前时间
                updateTitle(mDate.getTimeInMillis());
            }
        });
        mDate.setTimeInMillis(date);
        //得到系统时间
        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);
        //设置按钮
        set24HourView(DateFormat.is24HourFormat(this.getContext()));
        //时间标准化打印
        updateTitle(mDate.getTimeInMillis());
    }
 
    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;             // 显示时间

    // 根据 24 小时制的设置，添加相应的标志
        flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_24HOUR;

    // 使用 DateUtils 类的 formatDateTime 方法，将长整型的日期时间格式化为字符串，并设置标题
        setTitle(DateUtils.formatDateTime(this.getContext(), date, flag));
    }
//android开发中常见日期管理工具类（API）——DateUtils：按照上下午显示时间
 
    // 当对话框按钮被点击时触发的方法，接收两个参数：DialogInterface 和 int
    public void onClick(DialogInterface arg0, int arg1) {
    // 检查是否设置了日期时间监听器
        if (mOnDateTimeSetListener != null) {
        // 调用监听器的 OnDateTimeSet 方法，传递当前对象和日期时间的毫秒表示
            mOnDateTimeSetListener.OnDateTimeSet(this, mDate.getTimeInMillis());
        }
    }
//第一个参数arg0是接收到点击事件的对话框
    //第二个参数arg1是该对话框上的按钮
 
}