TimePickerDialog.java revision 4420ae875de711a91dc10f7f4dd5a9cc62221ac8 
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
17package android.app;
18
19import android.content.Context;
20import android.content.DialogInterface;
21import android.content.DialogInterface.OnClickListener;
22import android.os.Bundle;
23import android.util.TypedValue;
24import android.view.LayoutInflater;
25import android.view.View;
26import android.widget.TimePicker;
27import android.widget.TimePicker.OnTimeChangedListener;
28
29import com.android.internal.R;
30
31/**
32 * A dialog that prompts the user for the time of day using a
33 * {@link TimePicker}.
34 *
35 * <p>
36 * See the <a href="{@docRoot}guide/topics/ui/controls/pickers.html">Pickers</a>
37 * guide.
38 */
39public class TimePickerDialog extends AlertDialog implements OnClickListener,
40        OnTimeChangedListener {
41    private static final String HOUR = "hour";
42    private static final String MINUTE = "minute";
43    private static final String IS_24_HOUR = "is24hour";
44
45    private final TimePicker mTimePicker;
46    private final OnTimeSetListener mTimeSetListener;
47
48    private final int mInitialHourOfDay;
49    private final int mInitialMinute;
50    private final boolean mIs24HourView;
51
52    /**
53     * The callback interface used to indicate the user is done filling in
54     * the time (e.g. they clicked on the 'OK' button).
55     */
56    public interface OnTimeSetListener {
57        /**
58         * Called when the user is done setting a new time and the dialog has
59         * closed.
60         *
61         * @param view the view associated with this listener
62         * @param hourOfDay the hour that was set
63         * @param minute the minute that was set
64         */
65        void onTimeSet(TimePicker view, int hourOfDay, int minute);
66    }
67
68    /**
69     * Creates a new time picker dialog.
70     *
71     * @param context the parent context
72     * @param listener the listener to call when the time is set
73     * @param hourOfDay the initial hour
74     * @param minute the initial minute
75     * @param is24HourView whether this is a 24 hour view or AM/PM
76     */
77    public TimePickerDialog(Context context, OnTimeSetListener listener, int hourOfDay, int minute,
78            boolean is24HourView) {
79        this(context, 0, listener, hourOfDay, minute, is24HourView);
80    }
81
82    static int resolveDialogTheme(Context context, int resId) {
83        if (resId == 0) {
84            final TypedValue outValue = new TypedValue();
85            context.getTheme().resolveAttribute(R.attr.timePickerDialogTheme, outValue, true);
86            return outValue.resourceId;
87        } else {
88            return resId;
89        }
90    }
91
92    /**
93     * Creates a new time picker dialog with the specified theme.
94     *
95     * @param context the parent context
96     * @param themeResId the resource ID of the theme to apply to this dialog
97     * @param listener the listener to call when the time is set
98     * @param hourOfDay the initial hour
99     * @param minute the initial minute
100     * @param is24HourView Whether this is a 24 hour view, or AM/PM.
101     */
102    public TimePickerDialog(Context context, int themeResId, OnTimeSetListener listener,
103            int hourOfDay, int minute, boolean is24HourView) {
104        super(context, resolveDialogTheme(context, themeResId));
105
106        mTimeSetListener = listener;
107        mInitialHourOfDay = hourOfDay;
108        mInitialMinute = minute;
109        mIs24HourView = is24HourView;
110
111        final Context themeContext = getContext();
112
113
114        final TypedValue outValue = new TypedValue();
115        context.getTheme().resolveAttribute(R.attr.timePickerDialogTheme, outValue, true);
116
117        final LayoutInflater inflater = LayoutInflater.from(themeContext);
118        final View view = inflater.inflate(R.layout.time_picker_dialog, null);
119        setView(view);
120        setButton(BUTTON_POSITIVE, themeContext.getString(R.string.ok), this);
121        setButton(BUTTON_NEGATIVE, themeContext.getString(R.string.cancel), this);
122        setButtonPanelLayoutHint(LAYOUT_HINT_SIDE);
123
124        mTimePicker = (TimePicker) view.findViewById(R.id.timePicker);
125        mTimePicker.setIs24HourView(mIs24HourView);
126        mTimePicker.setCurrentHour(mInitialHourOfDay);
127        mTimePicker.setCurrentMinute(mInitialMinute);
128        mTimePicker.setOnTimeChangedListener(this);
129    }
130
131    @Override
132    public void onTimeChanged(TimePicker view, int hourOfDay, int minute) {
133        /* do nothing */
134    }
135
136    @Override
137    public void onClick(DialogInterface dialog, int which) {
138        switch (which) {
139            case BUTTON_POSITIVE:
140                if (mTimeSetListener != null) {
141                    mTimeSetListener.onTimeSet(mTimePicker, mTimePicker.getCurrentHour(),
142                            mTimePicker.getCurrentMinute());
143                }
144                break;
145            case BUTTON_NEGATIVE:
146                cancel();
147                break;
148        }
149    }
150
151    /**
152     * Sets the current time.
153     *
154     * @param hourOfDay The current hour within the day.
155     * @param minuteOfHour The current minute within the hour.
156     */
157    public void updateTime(int hourOfDay, int minuteOfHour) {
158        mTimePicker.setCurrentHour(hourOfDay);
159        mTimePicker.setCurrentMinute(minuteOfHour);
160    }
161
162    @Override
163    public Bundle onSaveInstanceState() {
164        final Bundle state = super.onSaveInstanceState();
165        state.putInt(HOUR, mTimePicker.getCurrentHour());
166        state.putInt(MINUTE, mTimePicker.getCurrentMinute());
167        state.putBoolean(IS_24_HOUR, mTimePicker.is24HourView());
168        return state;
169    }
170
171    @Override
172    public void onRestoreInstanceState(Bundle savedInstanceState) {
173        super.onRestoreInstanceState(savedInstanceState);
174        final int hour = savedInstanceState.getInt(HOUR);
175        final int minute = savedInstanceState.getInt(MINUTE);
176        mTimePicker.setIs24HourView(savedInstanceState.getBoolean(IS_24_HOUR));
177        mTimePicker.setCurrentHour(hour);
178        mTimePicker.setCurrentMinute(minute);
179    }
180}
181