Home | History | Annotate | Download | only in app 
      1 /*
      2  * Copyright (C) 2007 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 
     17 package android.app;
     18 
     19 import android.content.Context;
     20 import android.content.DialogInterface;
     21 import android.content.DialogInterface.OnClickListener;
     22 import android.os.Bundle;
     23 import android.util.TypedValue;
     24 import android.view.LayoutInflater;
     25 import android.view.View;
     26 import android.widget.Button;
     27 import android.widget.TimePicker;
     28 import android.widget.TimePicker.OnTimeChangedListener;
     29 import android.widget.TimePicker.ValidationCallback;
     30 
     31 import com.android.internal.R;
     32 
     33 /**
     34  * A dialog that prompts the user for the time of day using a {@link TimePicker}.
     35  *
     36  * <p>See the <a href="{@docRoot}guide/topics/ui/controls/pickers.html">Pickers</a>
     37  * guide.</p>
     38  */
     39 public class TimePickerDialog extends AlertDialog implements OnClickListener,
     40         OnTimeChangedListener {
     41 
     42     private static final String HOUR = "hour";
     43     private static final String MINUTE = "minute";
     44     private static final String IS_24_HOUR = "is24hour";
     45 
     46     private final TimePicker mTimePicker;
     47     private final OnTimeSetListener mTimeSetCallback;
     48 
     49     private final int mInitialHourOfDay;
     50     private final int mInitialMinute;
     51     private final boolean mIs24HourView;
     52 
     53     /**
     54      * The callback interface used to indicate the user is done filling in
     55      * the time (they clicked on the 'Done' button).
     56      */
     57     public interface OnTimeSetListener {
     58 
     59         /**
     60          * @param view The view associated with this listener.
     61          * @param hourOfDay The hour that was set.
     62          * @param minute The minute that was set.
     63          */
     64         void onTimeSet(TimePicker view, int hourOfDay, int minute);
     65     }
     66 
     67     /**
     68      * @param context Parent.
     69      * @param callBack How parent is notified.
     70      * @param hourOfDay The initial hour.
     71      * @param minute The initial minute.
     72      * @param is24HourView Whether this is a 24 hour view, or AM/PM.
     73      */
     74     public TimePickerDialog(Context context,
     75             OnTimeSetListener callBack,
     76             int hourOfDay, int minute, boolean is24HourView) {
     77         this(context, 0, callBack, hourOfDay, minute, is24HourView);
     78     }
     79 
     80     static int resolveDialogTheme(Context context, int resid) {
     81         if (resid == 0) {
     82             final TypedValue outValue = new TypedValue();
     83             context.getTheme().resolveAttribute(R.attr.timePickerDialogTheme, outValue, true);
     84             return outValue.resourceId;
     85         } else {
     86             return resid;
     87         }
     88     }
     89 
     90     /**
     91      * @param context Parent.
     92      * @param theme the theme to apply to this dialog
     93      * @param callBack How parent is notified.
     94      * @param hourOfDay The initial hour.
     95      * @param minute The initial minute.
     96      * @param is24HourView Whether this is a 24 hour view, or AM/PM.
     97      */
     98     public TimePickerDialog(Context context, int theme, OnTimeSetListener callBack, int hourOfDay,
     99             int minute, boolean is24HourView) {
    100         super(context, resolveDialogTheme(context, theme));
    101 
    102         mTimeSetCallback = callBack;
    103         mInitialHourOfDay = hourOfDay;
    104         mInitialMinute = minute;
    105         mIs24HourView = is24HourView;
    106 
    107         final Context themeContext = getContext();
    108         final LayoutInflater inflater = LayoutInflater.from(themeContext);
    109         final View view = inflater.inflate(R.layout.time_picker_dialog, null);
    110         setView(view);
    111         setButton(BUTTON_POSITIVE, themeContext.getString(R.string.ok), this);
    112         setButton(BUTTON_NEGATIVE, themeContext.getString(R.string.cancel), this);
    113         setButtonPanelLayoutHint(LAYOUT_HINT_SIDE);
    114 
    115         mTimePicker = (TimePicker) view.findViewById(R.id.timePicker);
    116         mTimePicker.setIs24HourView(mIs24HourView);
    117         mTimePicker.setCurrentHour(mInitialHourOfDay);
    118         mTimePicker.setCurrentMinute(mInitialMinute);
    119         mTimePicker.setOnTimeChangedListener(this);
    120         mTimePicker.setValidationCallback(mValidationCallback);
    121     }
    122 
    123     @Override
    124     public void onTimeChanged(TimePicker view, int hourOfDay, int minute) {
    125         /* do nothing */
    126     }
    127 
    128     @Override
    129     public void onClick(DialogInterface dialog, int which) {
    130         switch (which) {
    131             case BUTTON_POSITIVE:
    132                 if (mTimeSetCallback != null) {
    133                     mTimeSetCallback.onTimeSet(mTimePicker, mTimePicker.getCurrentHour(),
    134                             mTimePicker.getCurrentMinute());
    135                 }
    136                 break;
    137             case BUTTON_NEGATIVE:
    138                 cancel();
    139                 break;
    140         }
    141     }
    142 
    143     /**
    144      * Sets the current time.
    145      *
    146      * @param hourOfDay The current hour within the day.
    147      * @param minuteOfHour The current minute within the hour.
    148      */
    149     public void updateTime(int hourOfDay, int minuteOfHour) {
    150         mTimePicker.setCurrentHour(hourOfDay);
    151         mTimePicker.setCurrentMinute(minuteOfHour);
    152     }
    153 
    154     @Override
    155     public Bundle onSaveInstanceState() {
    156         final Bundle state = super.onSaveInstanceState();
    157         state.putInt(HOUR, mTimePicker.getCurrentHour());
    158         state.putInt(MINUTE, mTimePicker.getCurrentMinute());
    159         state.putBoolean(IS_24_HOUR, mTimePicker.is24HourView());
    160         return state;
    161     }
    162 
    163     @Override
    164     public void onRestoreInstanceState(Bundle savedInstanceState) {
    165         super.onRestoreInstanceState(savedInstanceState);
    166         final int hour = savedInstanceState.getInt(HOUR);
    167         final int minute = savedInstanceState.getInt(MINUTE);
    168         mTimePicker.setIs24HourView(savedInstanceState.getBoolean(IS_24_HOUR));
    169         mTimePicker.setCurrentHour(hour);
    170         mTimePicker.setCurrentMinute(minute);
    171     }
    172 
    173     private final ValidationCallback mValidationCallback = new ValidationCallback() {
    174         @Override
    175         public void onValidationChanged(boolean valid) {
    176             final Button positive = getButton(BUTTON_POSITIVE);
    177             if (positive != null) {
    178                 positive.setEnabled(valid);
    179             }
    180         }
    181     };
    182 }
    183