test123/DateTimePickerDialog.java

/*
 * 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 {   /*定义了一个名为 DateTimePickerDialog 的公共类，它扩展了 AlertDialog 并实现了 OnClickListener 接口。*/

    private Calendar mDate = Calendar.getInstance();
    private boolean mIs24HourView;
    private OnDateTimeSetListener mOnDateTimeSetListener;
    private DateTimePicker mDateTimePicker;  /*声明了一些私有变量，用于存储日期时间信息、24小时格式标志、监听器和日期时间选择器。 */

    public interface OnDateTimeSetListener {
        void OnDateTimeSet(AlertDialog dialog, long date);
    }     /*定义了一个内部接口 OnDateTimeSetListener，用于接收日期时间设置事件的回调。 */

    public DateTimePickerDialog(Context context, long date) {
        super(context);   /*构造函数初始化父类 AlertDialog */
        mDateTimePicker = new DateTimePicker(context);
        setView(mDateTimePicker);/*创建一个 DateTimePicker 实例并设置为对话框的内容视图*/
        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());
            }
        });/*为 DateTimePicker 设置监听器，在日期时间改变时更新内部的日历对象，并调用 updateTitle 方法更新对话框标题 */
        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());
    }   /*初始化日期时间对象，并设置到 DateTimePicker 中。设置对话框的确认和取消按钮，并根据系统设置决定是否使用24小时制显示时间。最后更新对话框标题。 */

    public void set24HourView(boolean is24HourView) {
        mIs24HourView = is24HourView;
    }    /*设置是否使用24小时制显示时间的方法*/

    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;
        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());
        }
    }/*实现 OnClickListener 接口的 onClick 方法，当点击对话框上的按钮时，如果设置了监听器，则调用其 OnDateTimeSet 方法*/

}/*类定义结束*/