diff --git a/java/net/micode/notes/ui/DateTimePickerDialog.java b/java/net/micode/notes/ui/DateTimePickerDialog.java index 2c47ba4..a71928a 100644 --- a/java/net/micode/notes/ui/DateTimePickerDialog.java +++ b/java/net/micode/notes/ui/DateTimePickerDialog.java @@ -14,6 +14,10 @@ * limitations under the License. */ +/** + * 日期时间选择器相关类 + * 提供用户友好的日期和时间选择界面,用于设置笔记提醒时间等功能 + */ package net.micode.notes.ui; import java.util.Calendar; @@ -29,62 +33,130 @@ 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(); + // 是否使用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) { + // 更新内部日期对象的年、月、日、时、分 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; + + // 使用DateFormat格式化日期时间并设置为对话框标题 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()); } } - } \ No newline at end of file