Java tutorial
/* * Copyright (C) 2013 The Android Open Source Project * * 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 com.codetroopers.betterpickers.radialtimepicker; import android.app.ActionBar.LayoutParams; import android.content.Context; import android.content.DialogInterface; import android.content.res.Resources; import android.content.res.TypedArray; import android.os.Bundle; import android.support.v4.app.DialogFragment; import android.support.v4.content.ContextCompat; import android.text.format.DateFormat; import android.util.Log; import android.view.KeyCharacterMap; import android.view.KeyEvent; import android.view.LayoutInflater; import android.view.View; import android.view.View.OnClickListener; import android.view.View.OnKeyListener; import android.view.ViewGroup; import android.view.Window; import android.widget.Button; import android.widget.RelativeLayout; import android.widget.TextView; import com.codetroopers.betterpickers.HapticFeedbackController; import com.codetroopers.betterpickers.OnDialogDismissListener; import com.codetroopers.betterpickers.R; import com.codetroopers.betterpickers.Utils; import com.codetroopers.betterpickers.numberpicker.NumberPickerErrorTextView; import com.codetroopers.betterpickers.radialtimepicker.RadialPickerLayout.OnValueSelectedListener; import com.nineoldandroids.animation.ObjectAnimator; import java.text.DateFormatSymbols; import java.util.ArrayList; import java.util.Calendar; import java.util.Locale; /** * Dialog to set a time. */ public class RadialTimePickerDialogFragment extends DialogFragment implements OnValueSelectedListener { private static final String TAG = "TimePickerDialog"; private static final String KEY_HOUR_OF_DAY = "hour_of_day"; private static final String KEY_MINUTE = "minute"; private static final String KEY_IS_24_HOUR_VIEW = "is_24_hour_view"; private static final String KEY_CURRENT_ITEM_SHOWING = "current_item_showing"; private static final String KEY_IN_KB_MODE = "in_kb_mode"; private static final String KEY_TYPED_TIMES = "typed_times"; private static final String KEY_STYLE = "theme"; private static final String KEY_FUTURE_MINUTES_LIMIT = "future_minutes_limit"; private static final String KEY_PAST_MINUTES_LIMIT = "past_minutes_limit"; private static final String KEY_CURRENT_DATE = "current_date"; private static final String KEY_PICKER_DATE = "picker_date"; public static final int HOUR_INDEX = 0; public static final int MINUTE_INDEX = 1; // NOT a real index for the purpose of what's showing. public static final int AMPM_INDEX = 2; // Also NOT a real index, just used for keyboard mode. public static final int ENABLE_PICKER_INDEX = 3; public static final int AM = 0; public static final int PM = 1; // Delay before starting the pulse animation, in ms. private static final int PULSE_ANIMATOR_DELAY = 300; private OnDialogDismissListener mDismissCallback; private OnTimeSetListener mCallback; private HapticFeedbackController mHapticFeedbackController; private Button mDoneButton; private TextView mHourView; private TextView mHourSpaceView; private TextView mMinuteView; private TextView mMinuteSpaceView; private TextView mAmPmTextView; private View mAmPmHitspace; private RadialPickerLayout mTimePicker; private TextView mTitleTextView; private NumberPickerErrorTextView mError; private int mSelectedColor; private int mUnselectedColor; private String mAmText; private String mPmText; private String mDoneText; private String mCancelText; private String mTitleText; private boolean mAllowAutoAdvance; private int mInitialHourOfDay; private int mInitialMinute; private Boolean mIs24HourMode; private int mStyleResId; private Integer mFutureMinutesLimit; private Integer mPastMinutesLimit; private Calendar mValidateDateTime; private Calendar mPickerDate; // For hardware IME input. private char mPlaceholderText; private String mDoublePlaceholderText; private String mDeletedKeyFormat; private boolean mInKbMode; private ArrayList<Integer> mTypedTimes; private Node mLegalTimesTree; private int mAmKeyCode; private int mPmKeyCode; // Accessibility strings. private String mHourPickerDescription; private String mSelectHours; private String mMinutePickerDescription; private String mSelectMinutes; /** * The callback interface used to indicate the user is done filling in the time (they clicked on the 'Set' button). */ public interface OnTimeSetListener { /** * @param dialog The view associated with this listener. * @param hourOfDay The hour that was set. * @param minute The minute that was set. */ void onTimeSet(RadialTimePickerDialogFragment dialog, int hourOfDay, int minute); } public RadialTimePickerDialogFragment() { Calendar calendar = Calendar.getInstance(); mInitialMinute = calendar.get(Calendar.MINUTE); mInitialHourOfDay = calendar.get(Calendar.HOUR_OF_DAY); mInKbMode = false; mStyleResId = R.style.BetterPickersRadialTimePickerDialog_PrimaryColor; } public RadialTimePickerDialogFragment setThemeDark() { mStyleResId = R.style.BetterPickersRadialTimePickerDialog_Dark; return this; } public RadialTimePickerDialogFragment setThemeLight() { mStyleResId = R.style.BetterPickersRadialTimePickerDialog_Light; return this; } /** * @param styleResId a style modeled after the styleable "BetterPickersRadialTimePickerDialog". * There is an example in the android-betterpickers sample under res/values/styles.xml */ public RadialTimePickerDialogFragment setThemeCustom(int styleResId) { mStyleResId = styleResId; return this; } public boolean isThemeDark() { return mStyleResId == R.style.BetterPickersRadialTimePickerDialog_Dark; } public RadialTimePickerDialogFragment setOnDismissListener(OnDialogDismissListener ondialogdismisslistener) { mDismissCallback = ondialogdismisslistener; return this; } public RadialTimePickerDialogFragment setOnTimeSetListener(OnTimeSetListener callback) { mCallback = callback; return this; } public RadialTimePickerDialogFragment setStartTime(int hourOfDay, int minute) { mInitialHourOfDay = hourOfDay; mInitialMinute = minute; mInKbMode = false; return this; } public RadialTimePickerDialogFragment setTitleText(String text) { mTitleText = text; return this; } public RadialTimePickerDialogFragment setDoneText(String text) { mDoneText = text; return this; } public RadialTimePickerDialogFragment setFutureMinutesLimit(Integer futureMinutesLimit) { this.mFutureMinutesLimit = futureMinutesLimit; return this; } public RadialTimePickerDialogFragment setPastMinutesLimit(Integer pastMinutesLimit) { this.mPastMinutesLimit = pastMinutesLimit; return this; } public RadialTimePickerDialogFragment setValidateDateTime(Calendar validateDateTime) { this.mValidateDateTime = validateDateTime; return this; } public RadialTimePickerDialogFragment setPickerDate(Calendar pickerDate) { this.mPickerDate = pickerDate; return this; } public RadialTimePickerDialogFragment setCancelText(String text) { mCancelText = text; return this; } public RadialTimePickerDialogFragment setForced24hFormat() { mIs24HourMode = true; return this; } public RadialTimePickerDialogFragment setForced12hFormat() { mIs24HourMode = false; return this; } /** * Autodetect is done by default if nothing is specified */ @Deprecated public RadialTimePickerDialogFragment setAutodetectDateFormat(Context context) { mIs24HourMode = DateFormat.is24HourFormat(context); return this; } @Override public void onDismiss(DialogInterface dialoginterface) { super.onDismiss(dialoginterface); if (mDismissCallback != null) { mDismissCallback.onDialogDismiss(dialoginterface); } } @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); if (savedInstanceState != null && savedInstanceState.containsKey(KEY_HOUR_OF_DAY) && savedInstanceState.containsKey(KEY_MINUTE) && savedInstanceState.containsKey(KEY_IS_24_HOUR_VIEW)) { mInitialHourOfDay = savedInstanceState.getInt(KEY_HOUR_OF_DAY); mInitialMinute = savedInstanceState.getInt(KEY_MINUTE); mIs24HourMode = savedInstanceState.getBoolean(KEY_IS_24_HOUR_VIEW); mInKbMode = savedInstanceState.getBoolean(KEY_IN_KB_MODE); mStyleResId = savedInstanceState.getInt(KEY_STYLE); if (savedInstanceState.containsKey(KEY_FUTURE_MINUTES_LIMIT)) { mFutureMinutesLimit = savedInstanceState.getInt(KEY_FUTURE_MINUTES_LIMIT); } if (savedInstanceState.containsKey(KEY_PAST_MINUTES_LIMIT)) { mPastMinutesLimit = savedInstanceState.getInt(KEY_PAST_MINUTES_LIMIT); } if (savedInstanceState.containsKey(KEY_CURRENT_DATE)) { mValidateDateTime = (Calendar) savedInstanceState.getSerializable(KEY_CURRENT_DATE); } if (savedInstanceState.containsKey(KEY_PICKER_DATE)) { mPickerDate = (Calendar) savedInstanceState.getSerializable(KEY_PICKER_DATE); } } else { if (mIs24HourMode == null) { mIs24HourMode = DateFormat.is24HourFormat(getContext()); } } } @Override public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { if (getShowsDialog()) { getDialog().getWindow().requestFeature(Window.FEATURE_NO_TITLE); } View view = inflater.inflate(R.layout.radial_time_picker_dialog, container, false); KeyboardListener keyboardListener = new KeyboardListener(); view.findViewById(R.id.time_picker_dialog).setOnKeyListener(keyboardListener); Resources res = getResources(); TypedArray themeColors = getActivity().obtainStyledAttributes(mStyleResId, R.styleable.BetterPickersDialogs); // Prepare some colors to use. int headerBgColor = themeColors.getColor(R.styleable.BetterPickersDialogs_bpHeaderBackgroundColor, ContextCompat.getColor(getActivity(), R.color.bpBlue)); int bodyBgColor = themeColors.getColor(R.styleable.BetterPickersDialogs_bpBodyBackgroundColor, ContextCompat.getColor(getActivity(), R.color.bpWhite)); int buttonBgColor = themeColors.getColor(R.styleable.BetterPickersDialogs_bpButtonsBackgroundColor, ContextCompat.getColor(getActivity(), R.color.bpWhite)); int buttonTextColor = themeColors.getColor(R.styleable.BetterPickersDialogs_bpButtonsTextColor, ContextCompat.getColor(getActivity(), R.color.bpBlue)); mSelectedColor = themeColors.getColor(R.styleable.BetterPickersDialogs_bpHeaderSelectedTextColor, ContextCompat.getColor(getActivity(), R.color.bpWhite)); mUnselectedColor = themeColors.getColor(R.styleable.BetterPickersDialogs_bpHeaderUnselectedTextColor, ContextCompat.getColor(getActivity(), R.color.radial_gray_light)); mHourPickerDescription = res.getString(R.string.hour_picker_description); mSelectHours = res.getString(R.string.select_hours); mMinutePickerDescription = res.getString(R.string.minute_picker_description); mSelectMinutes = res.getString(R.string.select_minutes); mHourView = (TextView) view.findViewById(R.id.hours); mHourView.setOnKeyListener(keyboardListener); mHourSpaceView = (TextView) view.findViewById(R.id.hour_space); mMinuteSpaceView = (TextView) view.findViewById(R.id.minutes_space); mMinuteView = (TextView) view.findViewById(R.id.minutes); mMinuteView.setOnKeyListener(keyboardListener); mAmPmTextView = (TextView) view.findViewById(R.id.ampm_label); mAmPmTextView.setOnKeyListener(keyboardListener); String[] amPmTexts = new DateFormatSymbols().getAmPmStrings(); mAmText = amPmTexts[0]; mPmText = amPmTexts[1]; mHapticFeedbackController = new HapticFeedbackController(getActivity()); mTimePicker = (RadialPickerLayout) view.findViewById(R.id.time_picker); mTimePicker.setOnValueSelectedListener(this); mTimePicker.setOnKeyListener(keyboardListener); mTimePicker.initialize(getActivity(), mHapticFeedbackController, mInitialHourOfDay, mInitialMinute, mIs24HourMode); int currentItemShowing = HOUR_INDEX; if (savedInstanceState != null && savedInstanceState.containsKey(KEY_CURRENT_ITEM_SHOWING)) { currentItemShowing = savedInstanceState.getInt(KEY_CURRENT_ITEM_SHOWING); } setCurrentItemShowing(currentItemShowing, false, true, true); mTimePicker.invalidate(); mHourView.setOnClickListener(new OnClickListener() { @Override public void onClick(View v) { setCurrentItemShowing(HOUR_INDEX, true, false, true); tryVibrate(); } }); mMinuteView.setOnClickListener(new OnClickListener() { @Override public void onClick(View v) { setCurrentItemShowing(MINUTE_INDEX, true, false, true); tryVibrate(); } }); mTitleTextView = (TextView) view.findViewById(R.id.time_picker_header); if (mTitleText != null) { mTitleTextView.setVisibility(View.VISIBLE); mTitleTextView.setText(mTitleText); } else { mTitleTextView.setVisibility(View.GONE); } mError = (NumberPickerErrorTextView) view.findViewById(R.id.error); if (hasTimeLimits()) { mError.setVisibility(View.INVISIBLE); } else { mError.setVisibility(View.GONE); } mDoneButton = (Button) view.findViewById(R.id.done_button); if (mDoneText != null) { mDoneButton.setText(mDoneText); } mDoneButton.setTextColor(buttonTextColor); mDoneButton.setOnClickListener(new OnClickListener() { @Override public void onClick(View v) { if (mInKbMode && isTypedTimeFullyLegal()) { finishKbMode(false); } else { tryVibrate(); } doneClickValidateAndCallback(); } }); mDoneButton.setOnKeyListener(keyboardListener); Button cancelButton = (Button) view.findViewById(R.id.cancel_button); if (mCancelText != null) { cancelButton.setText(mCancelText); } cancelButton.setTextColor(buttonTextColor); cancelButton.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { tryVibrate(); dismiss(); } }); // Enable or disable the AM/PM view. mAmPmHitspace = view.findViewById(R.id.ampm_hitspace); if (mIs24HourMode) { mAmPmTextView.setVisibility(View.GONE); RelativeLayout.LayoutParams paramsSeparator = new RelativeLayout.LayoutParams(LayoutParams.WRAP_CONTENT, LayoutParams.WRAP_CONTENT); paramsSeparator.addRule(RelativeLayout.CENTER_IN_PARENT); TextView separatorView = (TextView) view.findViewById(R.id.separator); separatorView.setLayoutParams(paramsSeparator); } else { mAmPmTextView.setVisibility(View.VISIBLE); updateAmPmDisplay(mInitialHourOfDay < 12 ? AM : PM); mAmPmHitspace.setOnClickListener(new OnClickListener() { @Override public void onClick(View v) { tryVibrate(); int amOrPm = mTimePicker.getIsCurrentlyAmOrPm(); if (amOrPm == AM) { amOrPm = PM; } else if (amOrPm == PM) { amOrPm = AM; } updateAmPmDisplay(amOrPm); mTimePicker.setAmOrPm(amOrPm); } }); } mAllowAutoAdvance = true; setHour(mInitialHourOfDay, true); setMinute(mInitialMinute); // Set up for keyboard mode. mDoublePlaceholderText = res.getString(R.string.time_placeholder); mDeletedKeyFormat = res.getString(R.string.deleted_key); mPlaceholderText = mDoublePlaceholderText.charAt(0); mAmKeyCode = mPmKeyCode = -1; generateLegalTimesTree(); if (mInKbMode) { mTypedTimes = savedInstanceState.getIntegerArrayList(KEY_TYPED_TIMES); tryStartingKbMode(-1); mHourView.invalidate(); } else if (mTypedTimes == null) { mTypedTimes = new ArrayList<Integer>(); } // Set the theme at the end so that the initialize()s above don't counteract the theme. mTimePicker.setTheme(themeColors); // Set the colors for each view based on the theme. view.findViewById(R.id.time_display_background).setBackgroundColor(headerBgColor); view.findViewById(R.id.ok_cancel_buttons_layout).setBackgroundColor(buttonBgColor); view.findViewById(R.id.time_display).setBackgroundColor(headerBgColor); view.findViewById(R.id.time_picker_error_holder).setBackgroundColor(headerBgColor); ((TextView) view.findViewById(R.id.separator)).setTextColor(mUnselectedColor); ((TextView) view.findViewById(R.id.ampm_label)).setTextColor(mUnselectedColor); mTimePicker.setBackgroundColor(bodyBgColor); return view; } private boolean hasTimeLimits() { return mFutureMinutesLimit != null || mPastMinutesLimit != null; } @Override public void onResume() { super.onResume(); mHapticFeedbackController.start(); } @Override public void onPause() { super.onPause(); mHapticFeedbackController.stop(); } public void tryVibrate() { mHapticFeedbackController.tryVibrate(); } private void updateAmPmDisplay(int amOrPm) { if (amOrPm == AM) { mAmPmTextView.setText(mAmText); Utils.tryAccessibilityAnnounce(mTimePicker, mAmText); mAmPmHitspace.setContentDescription(mAmText); } else if (amOrPm == PM) { mAmPmTextView.setText(mPmText); Utils.tryAccessibilityAnnounce(mTimePicker, mPmText); mAmPmHitspace.setContentDescription(mPmText); } else { mAmPmTextView.setText(mDoublePlaceholderText); } } @Override public void onSaveInstanceState(Bundle outState) { if (mTimePicker != null) { outState.putInt(KEY_HOUR_OF_DAY, mTimePicker.getHours()); outState.putInt(KEY_MINUTE, mTimePicker.getMinutes()); outState.putBoolean(KEY_IS_24_HOUR_VIEW, mIs24HourMode); outState.putInt(KEY_CURRENT_ITEM_SHOWING, mTimePicker.getCurrentItemShowing()); outState.putBoolean(KEY_IN_KB_MODE, mInKbMode); if (mFutureMinutesLimit != null) outState.putInt(KEY_FUTURE_MINUTES_LIMIT, mFutureMinutesLimit); if (mPastMinutesLimit != null) outState.putInt(KEY_PAST_MINUTES_LIMIT, mPastMinutesLimit); outState.putSerializable(KEY_CURRENT_DATE, mValidateDateTime); outState.putSerializable(KEY_PICKER_DATE, mPickerDate); if (mInKbMode) outState.putIntegerArrayList(KEY_TYPED_TIMES, mTypedTimes); outState.putInt(KEY_STYLE, mStyleResId); } } /** * Checks if the selected time lays too far in the future * * @return true if too far in the future, false if not */ public boolean isSelectionTooFarInTheFuture() { if (this.mPickerDate != null && this.mValidateDateTime != null && this.mFutureMinutesLimit != null) { Calendar selectedDate = Calendar.getInstance(); selectedDate.setTime(this.mPickerDate.getTime()); selectedDate.set(Calendar.HOUR_OF_DAY, mTimePicker.getHours()); selectedDate.set(Calendar.MINUTE, mTimePicker.getMinutes()); Calendar futureLimit = Calendar.getInstance(); futureLimit.setTime(this.mValidateDateTime.getTime()); futureLimit.add(Calendar.MINUTE, this.mFutureMinutesLimit); return selectedDate.compareTo(futureLimit) > 0; } return false; } /** * Checks if the selected time lays too far in the past * * @return true if too far in the past, false if not */ public boolean isSelectionTooFarInPast() { if (this.mPickerDate != null && this.mValidateDateTime != null && this.mPastMinutesLimit != null) { Calendar selectedDate = Calendar.getInstance(); selectedDate.setTime(this.mPickerDate.getTime()); selectedDate.set(Calendar.HOUR_OF_DAY, mTimePicker.getHours()); selectedDate.set(Calendar.MINUTE, mTimePicker.getMinutes()); Calendar pastLimit = Calendar.getInstance(); pastLimit.setTime(this.mValidateDateTime.getTime()); pastLimit.add(Calendar.MINUTE, -this.mPastMinutesLimit); return selectedDate.compareTo(pastLimit) < 0; } return false; } /** * Called when the done button is pressed. Validates the input and performs a callback if valid. */ public void doneClickValidateAndCallback() { if (isSelectionTooFarInTheFuture()) { if (mError != null) { mError.setText(getString(R.string.max_time_error)); mError.show(); } } else if (isSelectionTooFarInPast()) { if (mError != null) { mError.setText(getString(R.string.min_time_error)); mError.show(); } } else { if (mCallback != null) { mCallback.onTimeSet(RadialTimePickerDialogFragment.this, mTimePicker.getHours(), mTimePicker.getMinutes()); } dismiss(); } } /** * Called by the picker for updating the header display. */ @Override public void onValueSelected(int pickerIndex, int newValue, boolean autoAdvance) { if (hasTimeLimits()) { mError.hideImmediately(); } if (pickerIndex == HOUR_INDEX) { setHour(newValue, false); String announcement = String.format("%d", newValue); if (mAllowAutoAdvance && autoAdvance) { setCurrentItemShowing(MINUTE_INDEX, true, true, false); announcement += ". " + mSelectMinutes; } else { mTimePicker.setContentDescription(mHourPickerDescription + ": " + newValue); } Utils.tryAccessibilityAnnounce(mTimePicker, announcement); } else if (pickerIndex == MINUTE_INDEX) { setMinute(newValue); mTimePicker.setContentDescription(mMinutePickerDescription + ": " + newValue); } else if (pickerIndex == AMPM_INDEX) { updateAmPmDisplay(newValue); } else if (pickerIndex == ENABLE_PICKER_INDEX) { if (!isTypedTimeFullyLegal()) { mTypedTimes.clear(); } finishKbMode(true); } } private void setHour(int value, boolean announce) { String format; if (mIs24HourMode) { format = "%02d"; } else { format = "%d"; value = value % 12; if (value == 0) { value = 12; } } CharSequence text = String.format(format, value); mHourView.setText(text); mHourSpaceView.setText(text); if (announce) { Utils.tryAccessibilityAnnounce(mTimePicker, text); } } private void setMinute(int value) { if (value == 60) { value = 0; } CharSequence text = String.format(Locale.getDefault(), "%02d", value); Utils.tryAccessibilityAnnounce(mTimePicker, text); mMinuteView.setText(text); mMinuteSpaceView.setText(text); } // Show either Hours or Minutes. private void setCurrentItemShowing(int index, boolean animateCircle, boolean delayLabelAnimate, boolean announce) { mTimePicker.setCurrentItemShowing(index, animateCircle); TextView labelToAnimate; if (index == HOUR_INDEX) { int hours = mTimePicker.getHours(); if (!mIs24HourMode) { hours = hours % 12; } mTimePicker.setContentDescription(mHourPickerDescription + ": " + hours); if (announce) { Utils.tryAccessibilityAnnounce(mTimePicker, mSelectHours); } labelToAnimate = mHourView; } else { int minutes = mTimePicker.getMinutes(); mTimePicker.setContentDescription(mMinutePickerDescription + ": " + minutes); if (announce) { Utils.tryAccessibilityAnnounce(mTimePicker, mSelectMinutes); } labelToAnimate = mMinuteView; } int hourColor = (index == HOUR_INDEX) ? mSelectedColor : mUnselectedColor; int minuteColor = (index == MINUTE_INDEX) ? mSelectedColor : mUnselectedColor; mHourView.setTextColor(hourColor); mMinuteView.setTextColor(minuteColor); ObjectAnimator pulseAnimator = Utils.getPulseAnimator(labelToAnimate, 0.85f, 1.1f); if (delayLabelAnimate) { pulseAnimator.setStartDelay(PULSE_ANIMATOR_DELAY); } pulseAnimator.start(); } /** * For keyboard mode, processes key events. * * @param keyCode the pressed key. * @return true if the key was successfully processed, false otherwise. */ private boolean processKeyUp(int keyCode) { if (keyCode == KeyEvent.KEYCODE_ESCAPE || keyCode == KeyEvent.KEYCODE_BACK) { dismiss(); return true; } else if (keyCode == KeyEvent.KEYCODE_TAB) { if (mInKbMode) { if (isTypedTimeFullyLegal()) { finishKbMode(true); } return true; } } else if (keyCode == KeyEvent.KEYCODE_ENTER) { if (mInKbMode) { if (!isTypedTimeFullyLegal()) { return true; } finishKbMode(false); } doneClickValidateAndCallback(); return true; } else if (keyCode == KeyEvent.KEYCODE_DEL) { if (mInKbMode) { if (!mTypedTimes.isEmpty()) { int deleted = deleteLastTypedKey(); String deletedKeyStr; if (deleted == getAmOrPmKeyCode(AM)) { deletedKeyStr = mAmText; } else if (deleted == getAmOrPmKeyCode(PM)) { deletedKeyStr = mPmText; } else { deletedKeyStr = String.format("%d", getValFromKeyCode(deleted)); } Utils.tryAccessibilityAnnounce(mTimePicker, String.format(mDeletedKeyFormat, deletedKeyStr)); updateDisplay(true); } } } else if (keyCode == KeyEvent.KEYCODE_0 || keyCode == KeyEvent.KEYCODE_1 || keyCode == KeyEvent.KEYCODE_2 || keyCode == KeyEvent.KEYCODE_3 || keyCode == KeyEvent.KEYCODE_4 || keyCode == KeyEvent.KEYCODE_5 || keyCode == KeyEvent.KEYCODE_6 || keyCode == KeyEvent.KEYCODE_7 || keyCode == KeyEvent.KEYCODE_8 || keyCode == KeyEvent.KEYCODE_9 || (!mIs24HourMode && (keyCode == getAmOrPmKeyCode(AM) || keyCode == getAmOrPmKeyCode(PM)))) { if (!mInKbMode) { if (mTimePicker == null) { // Something's wrong, because time picker should definitely not be null. Log.e(TAG, "Unable to initiate keyboard mode, TimePicker was null."); return true; } mTypedTimes.clear(); tryStartingKbMode(keyCode); return true; } // We're already in keyboard mode. if (addKeyIfLegal(keyCode)) { updateDisplay(false); } return true; } return false; } /** * Try to start keyboard mode with the specified key, as long as the timepicker is not in the middle of a * touch-event. * * @param keyCode The key to use as the first press. Keyboard mode will not be started if the key is not legal to * start with. Or, pass in -1 to get into keyboard mode without a starting key. */ private void tryStartingKbMode(int keyCode) { if (mTimePicker.trySettingInputEnabled(false) && (keyCode == -1 || addKeyIfLegal(keyCode))) { mInKbMode = true; mDoneButton.setEnabled(false); updateDisplay(false); } } private boolean addKeyIfLegal(int keyCode) { // If we're in 24hour mode, we'll need to check if the input is full. If in AM/PM mode, // we'll need to see if AM/PM have been typed. if ((mIs24HourMode && mTypedTimes.size() == 4) || (!mIs24HourMode && isTypedTimeFullyLegal())) { return false; } mTypedTimes.add(keyCode); if (!isTypedTimeLegalSoFar()) { deleteLastTypedKey(); return false; } int val = getValFromKeyCode(keyCode); Utils.tryAccessibilityAnnounce(mTimePicker, String.format("%d", val)); // Automatically fill in 0's if AM or PM was legally entered. if (isTypedTimeFullyLegal()) { if (!mIs24HourMode && mTypedTimes.size() <= 3) { mTypedTimes.add(mTypedTimes.size() - 1, KeyEvent.KEYCODE_0); mTypedTimes.add(mTypedTimes.size() - 1, KeyEvent.KEYCODE_0); } mDoneButton.setEnabled(true); } return true; } /** * Traverse the tree to see if the keys that have been typed so far are legal as is, or may become legal as more * keys are typed (excluding backspace). */ private boolean isTypedTimeLegalSoFar() { Node node = mLegalTimesTree; for (int keyCode : mTypedTimes) { node = node.canReach(keyCode); if (node == null) { return false; } } return true; } /** * Check if the time that has been typed so far is completely legal, as is. */ private boolean isTypedTimeFullyLegal() { if (mIs24HourMode) { // For 24-hour mode, the time is legal if the hours and minutes are each legal. Note: // getEnteredTime() will ONLY call isTypedTimeFullyLegal() when NOT in 24hour mode. int[] values = getEnteredTime(null); return (values[0] >= 0 && values[1] >= 0 && values[1] < 60); } else { // For AM/PM mode, the time is legal if it contains an AM or PM, as those can only be // legally added at specific times based on the tree's algorithm. return (mTypedTimes.contains(getAmOrPmKeyCode(AM)) || mTypedTimes.contains(getAmOrPmKeyCode(PM))); } } private int deleteLastTypedKey() { int deleted = mTypedTimes.remove(mTypedTimes.size() - 1); if (!isTypedTimeFullyLegal()) { mDoneButton.setEnabled(false); } return deleted; } /** * Get out of keyboard mode. If there is nothing in typedTimes, revert to TimePicker's time. * * @param updateDisplays If true, update the displays with the relevant time. */ private void finishKbMode(boolean updateDisplays) { mInKbMode = false; if (!mTypedTimes.isEmpty()) { int values[] = getEnteredTime(null); mTimePicker.setTime(values[0], values[1]); if (!mIs24HourMode) { mTimePicker.setAmOrPm(values[2]); } mTypedTimes.clear(); } if (updateDisplays) { updateDisplay(false); mTimePicker.trySettingInputEnabled(true); } } /** * Update the hours, minutes, and AM/PM displays with the typed times. If the typedTimes is empty, either show an * empty display (filled with the placeholder text), or update from the timepicker's values. * * @param allowEmptyDisplay if true, then if the typedTimes is empty, use the placeholder text. Otherwise, revert to * the timepicker's values. */ private void updateDisplay(boolean allowEmptyDisplay) { if (!allowEmptyDisplay && mTypedTimes.isEmpty()) { int hour = mTimePicker.getHours(); int minute = mTimePicker.getMinutes(); setHour(hour, true); setMinute(minute); if (!mIs24HourMode) { updateAmPmDisplay(hour < 12 ? AM : PM); } setCurrentItemShowing(mTimePicker.getCurrentItemShowing(), true, true, true); mDoneButton.setEnabled(true); } else { Boolean[] enteredZeros = { false, false }; int[] values = getEnteredTime(enteredZeros); String hourFormat = enteredZeros[0] ? "%02d" : "%2d"; String minuteFormat = (enteredZeros[1]) ? "%02d" : "%2d"; String hourStr = (values[0] == -1) ? mDoublePlaceholderText : String.format(hourFormat, values[0]).replace(' ', mPlaceholderText); String minuteStr = (values[1] == -1) ? mDoublePlaceholderText : String.format(minuteFormat, values[1]).replace(' ', mPlaceholderText); mHourView.setText(hourStr); mHourSpaceView.setText(hourStr); mHourView.setTextColor(mUnselectedColor); mMinuteView.setText(minuteStr); mMinuteSpaceView.setText(minuteStr); mMinuteView.setTextColor(mUnselectedColor); if (!mIs24HourMode) { updateAmPmDisplay(values[2]); } } } private int getValFromKeyCode(int keyCode) { switch (keyCode) { case KeyEvent.KEYCODE_0: return 0; case KeyEvent.KEYCODE_1: return 1; case KeyEvent.KEYCODE_2: return 2; case KeyEvent.KEYCODE_3: return 3; case KeyEvent.KEYCODE_4: return 4; case KeyEvent.KEYCODE_5: return 5; case KeyEvent.KEYCODE_6: return 6; case KeyEvent.KEYCODE_7: return 7; case KeyEvent.KEYCODE_8: return 8; case KeyEvent.KEYCODE_9: return 9; default: return -1; } } /** * Get the currently-entered time, as integer values of the hours and minutes typed. * * @param enteredZeros A size-2 boolean array, which the caller should initialize, and which may then be used for * the caller to know whether zeros had been explicitly entered as either hours of minutes. This is helpful for * deciding whether to show the dashes, or actual 0's. * @return A size-3 int array. The first value will be the hours, the second value will be the minutes, and the * third will be either TimePickerDialog.AM or TimePickerDialog.PM. */ private int[] getEnteredTime(Boolean[] enteredZeros) { int amOrPm = -1; int startIndex = 1; if (!mIs24HourMode && isTypedTimeFullyLegal()) { int keyCode = mTypedTimes.get(mTypedTimes.size() - 1); if (keyCode == getAmOrPmKeyCode(AM)) { amOrPm = AM; } else if (keyCode == getAmOrPmKeyCode(PM)) { amOrPm = PM; } startIndex = 2; } int minute = -1; int hour = -1; for (int i = startIndex; i <= mTypedTimes.size(); i++) { int val = getValFromKeyCode(mTypedTimes.get(mTypedTimes.size() - i)); if (i == startIndex) { minute = val; } else if (i == startIndex + 1) { minute += 10 * val; if (enteredZeros != null && val == 0) { enteredZeros[1] = true; } } else if (i == startIndex + 2) { hour = val; } else if (i == startIndex + 3) { hour += 10 * val; if (enteredZeros != null && val == 0) { enteredZeros[0] = true; } } } return new int[] { hour, minute, amOrPm }; } /** * Get the keycode value for AM and PM in the current language. */ private int getAmOrPmKeyCode(int amOrPm) { // Cache the codes. if (mAmKeyCode == -1 || mPmKeyCode == -1) { // Find the first character in the AM/PM text that is unique. KeyCharacterMap kcm = KeyCharacterMap.load(KeyCharacterMap.VIRTUAL_KEYBOARD); char amChar; char pmChar; for (int i = 0; i < Math.max(mAmText.length(), mPmText.length()); i++) { amChar = mAmText.toLowerCase(Locale.getDefault()).charAt(i); pmChar = mPmText.toLowerCase(Locale.getDefault()).charAt(i); if (amChar != pmChar) { KeyEvent[] events = kcm.getEvents(new char[] { amChar, pmChar }); // There should be 4 events: a down and up for both AM and PM. if (events != null && events.length == 4) { mAmKeyCode = events[0].getKeyCode(); mPmKeyCode = events[2].getKeyCode(); } else { Log.e(TAG, "Unable to find keycodes for AM and PM."); } break; } } } if (amOrPm == AM) { return mAmKeyCode; } else if (amOrPm == PM) { return mPmKeyCode; } return -1; } /** * Create a tree for deciding what keys can legally be typed. */ private void generateLegalTimesTree() { // Create a quick cache of numbers to their keycodes. int k0 = KeyEvent.KEYCODE_0; int k1 = KeyEvent.KEYCODE_1; int k2 = KeyEvent.KEYCODE_2; int k3 = KeyEvent.KEYCODE_3; int k4 = KeyEvent.KEYCODE_4; int k5 = KeyEvent.KEYCODE_5; int k6 = KeyEvent.KEYCODE_6; int k7 = KeyEvent.KEYCODE_7; int k8 = KeyEvent.KEYCODE_8; int k9 = KeyEvent.KEYCODE_9; // The root of the tree doesn't contain any numbers. mLegalTimesTree = new Node(); if (mIs24HourMode) { // We'll be re-using these nodes, so we'll save them. Node minuteFirstDigit = new Node(k0, k1, k2, k3, k4, k5); Node minuteSecondDigit = new Node(k0, k1, k2, k3, k4, k5, k6, k7, k8, k9); // The first digit must be followed by the second digit. minuteFirstDigit.addChild(minuteSecondDigit); // The first digit may be 0-1. Node firstDigit = new Node(k0, k1); mLegalTimesTree.addChild(firstDigit); // When the first digit is 0-1, the second digit may be 0-5. Node secondDigit = new Node(k0, k1, k2, k3, k4, k5); firstDigit.addChild(secondDigit); // We may now be followed by the first minute digit. E.g. 00:09, 15:58. secondDigit.addChild(minuteFirstDigit); // When the first digit is 0-1, and the second digit is 0-5, the third digit may be 6-9. Node thirdDigit = new Node(k6, k7, k8, k9); // The time must now be finished. E.g. 0:55, 1:08. secondDigit.addChild(thirdDigit); // When the first digit is 0-1, the second digit may be 6-9. secondDigit = new Node(k6, k7, k8, k9); firstDigit.addChild(secondDigit); // We must now be followed by the first minute digit. E.g. 06:50, 18:20. secondDigit.addChild(minuteFirstDigit); // The first digit may be 2. firstDigit = new Node(k2); mLegalTimesTree.addChild(firstDigit); // When the first digit is 2, the second digit may be 0-3. secondDigit = new Node(k0, k1, k2, k3); firstDigit.addChild(secondDigit); // We must now be followed by the first minute digit. E.g. 20:50, 23:09. secondDigit.addChild(minuteFirstDigit); // When the first digit is 2, the second digit may be 4-5. secondDigit = new Node(k4, k5); firstDigit.addChild(secondDigit); // We must now be followd by the last minute digit. E.g. 2:40, 2:53. secondDigit.addChild(minuteSecondDigit); // The first digit may be 3-9. firstDigit = new Node(k3, k4, k5, k6, k7, k8, k9); mLegalTimesTree.addChild(firstDigit); // We must now be followed by the first minute digit. E.g. 3:57, 8:12. firstDigit.addChild(minuteFirstDigit); } else { // We'll need to use the AM/PM node a lot. // Set up AM and PM to respond to "a" and "p". Node ampm = new Node(getAmOrPmKeyCode(AM), getAmOrPmKeyCode(PM)); // The first hour digit may be 1. Node firstDigit = new Node(k1); mLegalTimesTree.addChild(firstDigit); // We'll allow quick input of on-the-hour times. E.g. 1pm. firstDigit.addChild(ampm); // When the first digit is 1, the second digit may be 0-2. Node secondDigit = new Node(k0, k1, k2); firstDigit.addChild(secondDigit); // Also for quick input of on-the-hour times. E.g. 10pm, 12am. secondDigit.addChild(ampm); // When the first digit is 1, and the second digit is 0-2, the third digit may be 0-5. Node thirdDigit = new Node(k0, k1, k2, k3, k4, k5); secondDigit.addChild(thirdDigit); // The time may be finished now. E.g. 1:02pm, 1:25am. thirdDigit.addChild(ampm); // When the first digit is 1, the second digit is 0-2, and the third digit is 0-5, // the fourth digit may be 0-9. Node fourthDigit = new Node(k0, k1, k2, k3, k4, k5, k6, k7, k8, k9); thirdDigit.addChild(fourthDigit); // The time must be finished now. E.g. 10:49am, 12:40pm. fourthDigit.addChild(ampm); // When the first digit is 1, and the second digit is 0-2, the third digit may be 6-9. thirdDigit = new Node(k6, k7, k8, k9); secondDigit.addChild(thirdDigit); // The time must be finished now. E.g. 1:08am, 1:26pm. thirdDigit.addChild(ampm); // When the first digit is 1, the second digit may be 3-5. secondDigit = new Node(k3, k4, k5); firstDigit.addChild(secondDigit); // When the first digit is 1, and the second digit is 3-5, the third digit may be 0-9. thirdDigit = new Node(k0, k1, k2, k3, k4, k5, k6, k7, k8, k9); secondDigit.addChild(thirdDigit); // The time must be finished now. E.g. 1:39am, 1:50pm. thirdDigit.addChild(ampm); // The hour digit may be 2-9. firstDigit = new Node(k2, k3, k4, k5, k6, k7, k8, k9); mLegalTimesTree.addChild(firstDigit); // We'll allow quick input of on-the-hour-times. E.g. 2am, 5pm. firstDigit.addChild(ampm); // When the first digit is 2-9, the second digit may be 0-5. secondDigit = new Node(k0, k1, k2, k3, k4, k5); firstDigit.addChild(secondDigit); // When the first digit is 2-9, and the second digit is 0-5, the third digit may be 0-9. thirdDigit = new Node(k0, k1, k2, k3, k4, k5, k6, k7, k8, k9); secondDigit.addChild(thirdDigit); // The time must be finished now. E.g. 2:57am, 9:30pm. thirdDigit.addChild(ampm); } } /** * Simple node class to be used for traversal to check for legal times. mLegalKeys represents the keys that can be * typed to get to the node. mChildren are the children that can be reached from this node. */ private class Node { private int[] mLegalKeys; private ArrayList<Node> mChildren; public Node(int... legalKeys) { mLegalKeys = legalKeys; mChildren = new ArrayList<Node>(); } public void addChild(Node child) { mChildren.add(child); } public boolean containsKey(int key) { for (int i = 0; i < mLegalKeys.length; i++) { if (mLegalKeys[i] == key) { return true; } } return false; } public Node canReach(int key) { if (mChildren == null) { return null; } for (Node child : mChildren) { if (child.containsKey(key)) { return child; } } return null; } } private class KeyboardListener implements OnKeyListener { @Override public boolean onKey(View v, int keyCode, KeyEvent event) { return event.getAction() == KeyEvent.ACTION_UP && processKeyUp(keyCode); } } }