universum.studios.android.setting

Class SettingDateTimeDialogPreference<O extends DialogOptions<O>>

java.lang.Object

androidx.preference.Preference

universum.studios.android.setting.SettingPreference

universum.studios.android.setting.SettingDialogPreference<O>

universum.studios.android.setting.SettingDateTimeDialogPreference<O>

All Implemented Interfaces:

Comparable<androidx.preference.Preference>

Direct Known Subclasses:

SettingDateDialogPreference, SettingTimeDialogPreference

public abstract class SettingDateTimeDialogPreference<O extends DialogOptions<O>>
extends SettingDialogPreference<O>

A SettingDialogPreference implementation that is used as base for dialog preferences through which a user can pick its preferred date or time for a specific setting preference.

This preference implementation by default displays the preferred date/time value formatted by format specified via setFormat(SimpleDateFormat) as summary text. The subclasses of this preference may specify theirs specific format which will be then used to format the summary text whenever the picked date/time value changes. If no value is persisted the standard summary text is displayed.

Since:

1.0

Author:

Martin Albedinsky

Nested Class Summary

Nested classes/interfaces inherited from class universum.studios.android.setting.SettingDialogPreference

SettingDialogPreference.OnClickListener

Nested classes/interfaces inherited from class androidx.preference.Preference

androidx.preference.Preference.BaseSavedState, androidx.preference.Preference.OnPreferenceChangeListener, androidx.preference.Preference.OnPreferenceClickListener, androidx.preference.Preference.SummaryProvider<T extends androidx.preference.Preference>

Field Summary

Fields inherited from class universum.studios.android.setting.SettingDialogPreference

NO_DIALOG_ID

Fields inherited from class androidx.preference.Preference

DEFAULT_ORDER

Method Summary

Modifier and Type	Method and Description
void	onBindViewHolder(androidx.preference.PreferenceViewHolder holder)
protected Object	onGetDefaultValue(android.content.res.TypedArray attributes, int index)
protected CharSequence	onGetSummaryText() This implementation formats the current date/time value, if it is set, by format specified via setFormat(SimpleDateFormat), if any.
protected void	onSetInitialValue(Object defaultValue)
void	setFormat(SimpleDateFormat format) Sets a format that should be used to format the preferred date/time value of this preference as summary text.

Methods inherited from class universum.studios.android.setting.SettingDialogPreference

getDialogId, getDialogOptions, handleDialogButtonClick, onConfigureDialogOptions, onCreateDialogOptions, onHandleDialogButtonClick, setDialogId, setOnClickListener, synchronizeSummaryView

Methods inherited from class universum.studios.android.setting.SettingPreference

setKey

Methods inherited from class androidx.preference.Preference

callChangeListener, compareTo, findPreferenceInHierarchy, getContext, getDependency, getExtras, getFragment, getIcon, getIntent, getKey, getLayoutResource, getOnPreferenceChangeListener, getOnPreferenceClickListener, getOrder, getParent, getPersistedBoolean, getPersistedFloat, getPersistedInt, getPersistedLong, getPersistedString, getPersistedStringSet, getPreferenceDataStore, getPreferenceManager, getSharedPreferences, getShouldDisableView, getSummary, getSummaryProvider, getTitle, getWidgetLayoutResource, hasKey, isCopyingEnabled, isEnabled, isIconSpaceReserved, isPersistent, isSelectable, isShown, isSingleLineTitle, isVisible, notifyChanged, notifyDependencyChange, notifyHierarchyChanged, onAttached, onAttachedToHierarchy, onAttachedToHierarchy, onClick, onDependencyChanged, onDetached, onInitializeAccessibilityNodeInfo, onParentChanged, onPrepareForRemoval, onRestoreInstanceState, onSaveInstanceState, onSetInitialValue, peekExtras, performClick, performClick, persistBoolean, persistFloat, persistInt, persistLong, persistString, persistStringSet, restoreHierarchyState, saveHierarchyState, setCopyingEnabled, setDefaultValue, setDependency, setEnabled, setFragment, setIcon, setIcon, setIconSpaceReserved, setIntent, setLayoutResource, setOnPreferenceChangeListener, setOnPreferenceClickListener, setOrder, setPersistent, setPreferenceDataStore, setSelectable, setShouldDisableView, setSingleLineTitle, setSummary, setSummary, setSummaryProvider, setTitle, setTitle, setViewId, setVisible, setWidgetLayoutResource, shouldDisableDependents, shouldPersist, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

onGetDefaultValue

protected Object onGetDefaultValue(@NonNull
                                   android.content.res.TypedArray attributes,
                                   int index)

Overrides:

onGetDefaultValue in class androidx.preference.Preference

onSetInitialValue

protected void onSetInitialValue(@Nullable
                                 Object defaultValue)

Overrides:

onSetInitialValue in class androidx.preference.Preference

setFormat

public void setFormat(@NonNull
                      SimpleDateFormat format)

Sets a format that should be used to format the preferred date/time value of this preference as summary text.

Parameters:

format - The desired format.

See Also:

SimpleDateFormat

onBindViewHolder

public void onBindViewHolder(@NonNull
                             androidx.preference.PreferenceViewHolder holder)

Overrides:

onBindViewHolder in class SettingPreference

onGetSummaryText

@Nullable
protected CharSequence onGetSummaryText()

This implementation formats the current date/time value, if it is set, by format specified via setFormat(SimpleDateFormat), if any. If there is no date/time value and format set the standard summary text that may be obtained via Preference.getSummary() is returned.

Overrides:

onGetSummaryText in class SettingDialogPreference<O extends DialogOptions<O>>

Returns:

The actual summary text that should be presented in the summary view of this preference.