pq5n3hobs
/
xiaomi
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

注释代码4

Browse Source
pq5n3hobs 8 months ago
parent 881731d38a
commit 03df13f053
1 changed files with 272 additions and 0 deletions
Show Stats Download Patch File Download Diff File

272
DateTimePicker.java
Unescape View File

@ -0,0 +1,272 @@
/*
* 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.text.DateFormatSymbols;
import java.util.Calendar;
import net.micode.notes.R;
import android.content.Context;
import android.text.format.DateFormat;
import android.view.View;
import android.widget.FrameLayout;
import android.widget.NumberPicker;
// DateTimePicker类继承自FrameLayout，意味着它可以作为一个容器来承载其他视图组件，并且具备布局相关的特性
// 这个类主要用于实现一个日期和时间选择的自定义视图组件，方便在Android应用中让用户选择特定的日期和时间
public class DateTimePicker extends FrameLayout {
// 定义默认的启用状态，默认为启用（true），用于控制整个DateTimePicker组件及其内部子组件是否可用
private static final boolean DEFAULT_ENABLE_STATE = true;
// 半天包含的小时数，用于12小时制时间相关的计算和逻辑判断，例如区分上午和下午的时间范围
private static final int HOURS_IN_HALF_DAY = 12;
// 一整天包含的小时数，用于24小时制时间相关的操作和判断
private static final int HOURS_IN_ALL_DAY = 24;
// 一周包含的天数，用于日期选择器相关的范围设置和数据处理等操作
private static final int DAYS_IN_ALL_WEEK = 7;
// 日期选择器（NumberPicker）的最小值，通常从0开始，对应一周七天的索引等情况
private static final int DATE_SPINNER_MIN_VAL = 0;
// 日期选择器（NumberPicker）的最大值，设置为一周天数减1，因为索引从0开始
private static final int DATE_SPINNER_MAX_VAL = DAYS_IN_ALL_WEEK - 1;
// 24小时制视图下小时选择器（NumberPicker）的最小值，范围是0到23小时
private static final int HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW = 0;
// 24小时制视图下小时选择器（NumberPicker）的最大值，范围是0到23小时
private static final int HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW = 23;
// 12小时制视图下小时选择器（NumberPicker）的最小值，通常从1开始（上午1点）
private static final int HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW = 1;
// 12小时制视图下小时选择器（NumberPicker）的最大值，到12点结束（中午12点或者晚上12点）
private static final int HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW = 12;
// 分钟选择器（NumberPicker）的最小值，分钟范围从0开始
private static final int MINUT_SPINNER_MIN_VAL = 0;
// 分钟选择器（NumberPicker）的最大值，到59分钟结束
private static final int MINUT_SPINNER_MAX_VAL = 59;
// AM/PM选择器（NumberPicker）的最小值，通常0表示上午（AM），对应相关逻辑和显示设置
private static final int AMPM_SPINNER_MIN_VAL = 0;
// AM/PM选择器（NumberPicker）的最大值，通常1表示下午（PM），对应相关逻辑和显示设置
private static final int AMPM_SPINNER_MAX_VAL = 1;
// 用于显示日期的NumberPicker组件，用户可以通过它选择具体的日期（以一周内某天的形式呈现）
private final NumberPicker mDateSpinner;
// 用于显示小时的NumberPicker组件，根据设置的是24小时制还是12小时制，其显示范围和逻辑有所不同
private final NumberPicker mHourSpinner;
// 用于显示分钟的NumberPicker组件，分钟范围固定从0到59
private final NumberPicker mMinuteSpinner;
// 用于显示上午（AM）或下午（PM）的NumberPicker组件，仅在12小时制下可见并起作用
private final NumberPicker mAmPmSpinner;
// 用于存储当前选择的日期和时间信息的Calendar对象，方便进行日期和时间的计算、获取以及设置等操作
private Calendar mDate;
// 用于存储要在日期选择器中显示的一周七天的字符串表示形式，例如 "周一"、"周二" 等
private String[] mDateDisplayValues = new String[DAYS_IN_ALL_WEEK];
// 用于标记当前时间是上午（true）还是下午（false），在12小时制下使用，初始值根据当前时间判断
private boolean mIsAm;
// 用于标记是否处于24小时制视图模式（true表示24小时制，false表示12小时制），决定了小时选择器等相关组件的显示和操作逻辑
private boolean mIs24HourView;
// 用于记录整个DateTimePicker组件当前的启用状态，初始化为默认启用状态
private boolean mIsEnabled = DEFAULT_ENABLE_STATE;
// 用于标记是否正在初始化组件的过程中，在一些设置逻辑中避免不必要的重复操作或者冲突
private boolean mInitialising;
// 定义一个接口类型的成员变量，用于设置当日期和时间发生改变时的回调监听器，外部类可以实现该接口来响应时间日期的变化
private OnDateTimeChangedListener mOnDateTimeChangedListener;
// 为日期选择器（mDateSpinner）设置的监听器，当日期选择器的值发生改变时会触发此监听器的onValueChange方法
// 在此方法中，会根据日期选择器值的变化来更新对应的日期信息，同时通知其他相关组件更新显示，并触发整体的日期时间改变回调（如果有设置）
private NumberPicker.OnValueChangeListener mOnDateChangedListener = new NumberPicker.OnValueChangeListener() {
@Override
public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
// 根据日期选择器新值与旧值的差值，调整Calendar对象（mDate）中的日期，实现日期的增减操作
mDate.add(Calendar.DAY_OF_YEAR, newVal - oldVal);
// 更新日期相关的显示控制，例如更新日期选择器中显示的具体日期字符串等
updateDateControl();
// 触发日期时间改变的回调方法，通知外部监听者日期时间已发生变化
onDateTimeChanged();
}
};
// 为小时选择器（mHourSpinner）设置的监听器，当小时选择器的值发生改变时会触发此监听器的onValueChange方法
// 此方法内包含了复杂的逻辑来处理不同时间制（12小时制和24小时制）下小时变化时，日期、上午/下午标记以及其他相关组件显示和值的更新情况
private NumberPicker.OnValueChangeListener mOnHourChangedListener = new NumberPicker.OnValueChangeListener() {
@Override
public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
boolean isDateChanged = false;
Calendar cal = Calendar.getInstance();
if (!mIs24HourView) {
// 在12小时制下，如果当前不是上午且旧值是11（半天的最后一小时），新值变为12（中午12点，进入下午，可能涉及日期变化）
if (!mIsAm && oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY) {
cal.setTimeInMillis(mDate.getTimeInMillis());
cal.add(Calendar.DAY_OF_YEAR, 1);
isDateChanged = true;
}
// 在12小时制下，如果当前是上午且旧值是12（中午12点），新值变为11（上午11点，回到上午，可能涉及日期变化）
else if (mIsAm && oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) {
cal.setTimeInMillis(mDate.getTimeInMillis());
cal.add(Calendar.DAY_OF_YEAR, -1);
isDateChanged = true;
}
// 如果小时从11变为12或者从12变为11，意味着上午/下午状态改变
if (oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY ||
oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) {
mIsAm =!mIsAm;
updateAmPmControl();
}
} else {
// 在24小时制下，如果旧值是23（一天的最后一小时），新值变为0（进入新的一天，涉及日期变化）
if (oldVal == HOURS_IN_ALL_DAY - 1 && newVal == 0) {
cal.setTimeInMillis(mDate.getTimeInMillis());
cal.add(Calendar.DAY_OF_YEAR, 1);
isDateChanged = true;
}
// 在24小时制下，如果旧值是0（凌晨0点），新值变为23（回到前一天的最后一小时，涉及日期变化）
else if (oldVal == 0 && newVal == HOURS_IN_ALL_DAY - 1) {
cal.setTimeInMillis(mDate.getTimeInMillis());
cal.add(Calendar.DAY_OF_YEAR, -1);
isDateChanged = true;
}
}
// 根据当前是否为24小时制以及上午/下午状态，计算并设置当前的小时数到Calendar对象（mDate）中
int newHour = mHourSpinner.getValue() % HOURS_IN_HALF_DAY + (mIsAm? 0 : HOURS_IN_HALF_DAY);
mDate.set(Calendar.HOUR_OF_DAY, newHour);
// 触发日期时间改变的回调方法，通知外部监听者日期时间已发生变化
onDateTimeChanged();
if (isDateChanged) {
// 如果日期发生了变化，更新年份、月份、日等相关信息到对应的组件显示和内部存储中
setCurrentYear(cal.get(Calendar.YEAR));
setCurrentMonth(cal.get(Calendar.MONTH));
setCurrentDay(cal.get(Calendar.DAY_OF_MONTH));
}
}
};
// 为分钟选择器（mMinuteSpinner）设置的监听器，当分钟选择器的值发生改变时会触发此监听器的onValueChange方法
// 此方法中会根据分钟值的变化情况，处理可能涉及的小时、日期以及上午/下午等相关状态的更新，并触发日期时间改变回调
private NumberPicker.OnValueChangeListener mOnMinuteChangedListener = new NumberPicker.OnValueChangeListener() {
@Override
public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
int minValue = mMinuteSpinner.getMinValue();
int maxValue = mMinuteSpinner.getMaxValue();
int offset = 0;
// 如果分钟从最大值变为最小值，可能意味着时间跨越了一个小时边界，需要进行相应的时间调整
if (oldVal == maxValue && newVal == minValue) {
offset += 1;
} else if (oldVal == minValue && newVal == maxValue) {
offset -= 1;
}
if (offset!= 0) {
mDate.add(Calendar.HOUR_OF_DAY, offset);
mHourSpinner.setValue(getCurrentHour());
updateDateControl();
int newHour = getCurrentHourOfDay();
if (newHour >= HOURS_IN_HALF_DAY) {
mIsAm = false;
updateAmPmControl();
} else {
mIsAm = true;
updateAmPmControl();
}
}
mDate.set(Calendar.MINUTE, newVal);
onDateTimeChanged();
}
};
// 为AM/PM选择器（mAmPmSpinner）设置的监听器，当AM/PM选择器的值发生改变时会触发此监听器的onValueChange方法
// 此方法中会根据选择的上午/下午变化，相应地调整日期时间中的小时数，并更新相关组件显示，触发日期时间改变回调
private NumberPicker.OnValueChangeListener mOnAmPmChangedListener = new NumberPicker.OnValueChangeListener() {
@Override
public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
mIsAm =!mIsAm;
if (mIsAm) {
mDate.add(Calendar.HOUR_OF_DAY, -HOURS_IN_HALF_DAY);
} else {
mDate.add(Calendar.HOUR_OF_DAY, HOURS_IN_HALF_DAY);
}
updateAmPmControl();
onDateTimeChanged();
}
};
// 定义一个接口，用于外部类实现，当DateTimePicker中的日期和时间发生改变时，会回调此接口的onDateTimeChanged方法
// 外部类可以通过实现该接口获取到日期时间变化的具体信息，并进行相应的业务处理，比如更新显示、保存数据等操作
public interface OnDateTimeChangedListener {
void onDateTimeChanged(DateTimePicker view, int year, int month,
int dayOfMonth, int hourOfDay, int minute);
}
// 构造方法，调用另一个带有默认当前时间（System.currentTimeMillis()）的构造方法来初始化DateTimePicker组件
public DateTimePicker(Context context) {
this(context, System.currentTimeMillis());
}
// 构造方法，调用另一个带有是否为24小时制参数（DateFormat.is24HourFormat(context)）的构造方法来初始化DateTimePicker组件
// 传入的参数date用于设置初始的日期时间（以毫秒数表示，通常是从某个时间原点开始的时间戳）
public DateTimePicker(Context context, long date) {
this(context, date, DateFormat.is24HourFormat(context));
}
// 主要的构造方法，用于初始化DateTimePicker组件的各个属性、视图组件以及设置初始的日期时间、时间制等相关状态
public DateTimePicker(Context context, long date, boolean is24HourView) {
super(context);
// 获取一个表示当前时间的Calendar实例，后续用于设置和操作日期时间相关信息
mDate = Calendar.getInstance();
mInitialising = true;
// 根据当前小时数判断是上午还是下午（用于初始化12小时制下的初始上午/下午状态）
mIsAm = getCurrentHourOfDay() >= HOURS_IN_HALF_DAY;
// 加载布局文件（R.layout.datetime_picker）到当前的DateTimePicker组件中，该布局文件应该定义了包含日期、时间选择器等相关视图的结构
inflate(context, R.layout.datetime_picker, this);
// 获取布局文件中定义的日期选择器（NumberPicker）组件实例
mDateSpinner = (NumberPicker) findViewById(R.id.date);
// 设置日期选择器的最小值和最大值，对应一周七天的范围
mDateSpinner.setMinValue(DATE_SPINNER_MIN_VAL);
mDateSpinner.setMaxValue(DATE_SPINNER_MAX_VAL);
// 为日期选择器设置值改变监听器，当用户选择不同日期时触发相应逻辑
mDateSpinner.setOnValueChangedListener(mOnDateChangedListener);
// 获取布局文件中定义的小时选择器（NumberPicker）组件实例
mHourSpinner = (NumberPicker) findViewById(R.id.hour);
// 为小时选择器设置值改变监听器，用于处理小时值变化时的各种逻辑
mHourSpinner.setOnValueChangedListener(mOnHourChangedListener);
// 获取布局文件中定义的分钟选择器（NumberPicker）组件实例
mMinuteSpinner = (NumberPicker) findViewById(R.id.minute);
// 设置分钟选择器的最小值和最大值，对应分钟的0到59范围
mMinuteSpinner.setMinValue(MINUT_SPINNER_MIN_VAL);
mMinuteSpinner.setMaxValue(MINUT_SPINNER_MAX_VAL);
// 设置长按更新间隔，这里设置为100毫秒，用于控制长按操作时的数值更新频率（具体根据实际需求和用户体验调整）
mMinuteSpinner.setOnLongPressUpdateInterval(100);
// 为分钟选择器设置值改变监听器，处理分钟值变化的相关逻辑
mMinuteSpinner.setOnValueChangedListener(mOnMinuteChangedListener);
// 获取用于表示上午（AM）和下午（PM）的字符串数组，用于在AM/PM选择器中显示
String[] stringsForAmPm = new DateFormatSymbols().getAmPmStrings();
// 获取布局文件中定义的AM/PM选择器（NumberPicker）组件实例
mAmPmSpinner = (NumberPicker) findViewById(R.id.amPm);
// 设置AM/PM选择器的最小值和最大值，对应上午（0）和下午（1）的表示
mAmPmSpinner.setMinValue(AMPM_SPINNER_MIN_VAL);
mAmPmSpinner.setMaxValue(AMPM_SPINNER_MAX_VAL);
// 设置AM/PM选择器要显示的字符串值，即上午（AM）和下午（PM）的文本表示
mAmPmSpinner.setDisplayedValues(stringsForAmPm);
// 为AM/PM选择器设置值改变监听器，处理上午/下午选择变化的相关逻辑
mAmPm
Write Preview
Loading…
Cancel
Save