1

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;
-                 }
+                 }//24小时制时，当天晚上凌晨11点和12点交替时对日期的更改
-             } //这里是对于12小时制时，凌晨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
+             //如果旧值为59，新值为0，则offset+1
-             //如果原值为0，新值为59，则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