diff --git a/doc/小米便签泛读报告.docx b/doc/小米便签泛读报告.docx new file mode 100644 index 0000000..02cc4f9 Binary files /dev/null and b/doc/小米便签泛读报告.docx differ diff --git a/src/net/micode/notes/ui/DateTimePicker.java b/src/net/micode/notes/ui/DateTimePicker.java index ba41998..d30dd31 100644 --- a/src/net/micode/notes/ui/DateTimePicker.java +++ b/src/net/micode/notes/ui/DateTimePicker.java @@ -29,8 +29,6 @@ import android.widget.NumberPicker; public class DateTimePicker extends FrameLayout { - //FrameLayout是布局模板之一 - //所有的子元素全部在屏幕的右上方 private static final boolean DEFAULT_ENABLE_STATE = true; private static final int HOURS_IN_HALF_DAY = 12; @@ -46,7 +44,7 @@ private static final int MINUT_SPINNER_MAX_VAL = 59; private static final int AMPM_SPINNER_MIN_VAL = 0; private static final int AMPM_SPINNER_MAX_VAL = 1; - //初始化控件 + private final NumberPicker mDateSpinner; private final NumberPicker mHourSpinner; private final NumberPicker mMinuteSpinner; @@ -54,7 +52,7 @@ //NumberPicker是数字选择器 //这里定义的四个变量全部是在设置闹钟时需要选择的变量（如日期、时、分、上午或者下午） private Calendar mDate; - //定义了Calendar类型的变量mDate，用于操作时间 + //定义Calendar类型的变量，用于操作时间 private String[] mDateDisplayValues = new String[DAYS_IN_ALL_WEEK]; private boolean mIsAm; @@ -74,49 +72,47 @@ updateDateControl(); onDateTimeChanged(); } - };//OnValueChangeListener，这是时间改变监听器，这里主要是对日期的监听 - //将现在日期的值传递给mDate；updateDateControl是同步操作 + };//时间改变监听器，记录日期的改变 private NumberPicker.OnValueChangeListener mOnHourChangedListener = new NumberPicker.OnValueChangeListener() { - //这里是对 小时（Hour） 的监听 + //对小时的记录监听 @Override public void onValueChange(NumberPicker picker, int oldVal, int newVal) { boolean isDateChanged = false; Calendar cal = Calendar.getInstance(); - //声明一个Calendar的变量cal，便于后续的操作 if (!mIs24HourView) { 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小时制时，晚上11点和12点交替时对日期的更改 + //12小时制时，前一天晚上11点和12点交替时对日期的更改 } 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; } - //这里是对于12小时制时，凌晨11点和12点交替时对日期的更改 + //12小时制时，当天晚上凌晨11点和12点交替时对日期的更改 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(); - }//这里是对于12小时制时，中午11点和12点交替时对AM和PM的更改 + }//12小时制时，中午11点和12点交替时对AM和PM的更改 } else { if (oldVal == HOURS_IN_ALL_DAY - 1 && newVal == 0) { cal.setTimeInMillis(mDate.getTimeInMillis()); cal.add(Calendar.DAY_OF_YEAR, 1); isDateChanged = true; - //这里是对于24小时制时，晚上11点和12点交替时对日期的更改 + //24小时制时，前一天晚上11点和12点交替时对日期的更改 } else if (oldVal == 0 && newVal == HOURS_IN_ALL_DAY - 1) { cal.setTimeInMillis(mDate.getTimeInMillis()); cal.add(Calendar.DAY_OF_YEAR, -1); isDateChanged = true; - } - } //这里是对于12小时制时，凌晨11点和12点交替时对日期的更改 + }//24小时制时，当天晚上凌晨11点和12点交替时对日期的更改 + } int newHour = mHourSpinner.getValue() % HOURS_IN_HALF_DAY + (mIsAm ? 0 : HOURS_IN_HALF_DAY); - //通过数字选择器对newHour的赋值 + //初始化 mDate.set(Calendar.HOUR_OF_DAY, newHour); - //通过set函数将新的Hour值传给mDate + //将新的Hour值传给mDate onDateTimeChanged(); if (isDateChanged) { setCurrentYear(cal.get(Calendar.YEAR)); @@ -128,19 +124,19 @@ private NumberPicker.OnValueChangeListener mOnMinuteChangedListener = new NumberPicker.OnValueChangeListener() { @Override - //这里是对 分钟（Minute）改变的监听 + //对分钟改变的记录监听 public void onValueChange(NumberPicker picker, int oldVal, int newVal) { int minValue = mMinuteSpinner.getMinValue(); int maxValue = mMinuteSpinner.getMaxValue(); int offset = 0; - //设置offset，作为小时改变的一个记录数据 + //记录小时hour改变 if (oldVal == maxValue && newVal == minValue) { offset += 1; } else if (oldVal == minValue && newVal == maxValue) { offset -= 1; } - //如果原值为59，新值为0，则offset加1 - //如果原值为0，新值为59，则offset减1 + //如果旧值为59，新值为0，则offset+1 + //如果旧值为0，新值为59，则offset-1 if (offset != 0) { mDate.add(Calendar.HOUR_OF_DAY, offset); mHourSpinner.setValue(getCurrentHour()); @@ -181,22 +177,18 @@ public DateTimePicker(Context context) { this(context, System.currentTimeMillis()); - }//通过对数据库的访问，获取当前的系统时间 + }//访问数据库，获取当前的系统时间（1970至今的seconds） public DateTimePicker(Context context, long date) { this(context, date, DateFormat.is24HourFormat(context)); - }//上面函数的得到的是一个天文数字（1970至今的秒数），需要DateFormat将其变得有意义 - + }//转换得到的系统时间 + //获取系统时间 public DateTimePicker(Context context, long date, boolean is24HourView) { super(context); - //获取系统时间 mDate = Calendar.getInstance(); mInitialising = true; mIsAm = getCurrentHourOfDay() >= HOURS_IN_HALF_DAY; inflate(context, R.layout.datetime_picker, this); - //如果当前Activity里用到别的layout，比如对话框layout - //还要设置这个layout上的其他组件的内容，就必须用inflate()方法先将对话框的layout找出来 - //然后再用findViewById()找到它上面的其它组件 mDateSpinner = (NumberPicker) findViewById(R.id.date); mDateSpinner.setMinValue(DATE_SPINNER_MIN_VAL); mDateSpinner.setMaxValue(DATE_SPINNER_MAX_VAL); @@ -232,6 +224,7 @@ // set the content descriptions mInitialising = false; } + //没看懂 @Override public void setEnabled(boolean enabled) { @@ -244,14 +237,12 @@ mHourSpinner.setEnabled(enabled); mAmPmSpinner.setEnabled(enabled); mIsEnabled = enabled; - } - //存在疑问！！！！！！！！！！！！！setEnabled的作用 - //下面的代码通过原程序的注释已经比较清晰，另外可以通过函数名来判断 - //下面的各函数主要是对上面代码引用到的各函数功能的实现 + }//检查日期和时间选择器是否可用 + @Override public boolean isEnabled() { return mIsEnabled; - } + }//感觉有点多余 /** * Get the current date in millis @@ -272,7 +263,7 @@ cal.setTimeInMillis(date); setCurrentDate(cal.get(Calendar.YEAR), cal.get(Calendar.MONTH), cal.get(Calendar.DAY_OF_MONTH), cal.get(Calendar.HOUR_OF_DAY), cal.get(Calendar.MINUTE)); - }//实现函数功能——设置当前的时间，参数是date + }//设置当前的时间，参数是日期 /** * Set the current date @@ -290,7 +281,7 @@ setCurrentDay(dayOfMonth); setCurrentHour(hourOfDay); setCurrentMinute(minute); - }//实现函数功能——设置当前的时间，参数是各详细的变量 + }//设置当前的时间，参数是具体的时间 /** * Get current year