universum.studios.android.setting

Class SettingDialogPreference<O extends <any>>

java.lang.Object

android.preference.Preference

universum.studios.android.setting.SettingPreference

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

Type Parameters:

O - Type of the dialog options specific for type of the dialog associated with this preference.

All Implemented Interfaces:

Comparable<android.preference.Preference>

Direct Known Subclasses:

SettingColorDialogPreference, SettingDateTimeDialogPreference, SettingEditDialogPreference, SettingSelectionDialogPreference

public class SettingDialogPreference<O extends <any>>
extends SettingPreference

A SettingPreference implementation that may be used to show a preference dialog. Each dialog preference has specified id of the associated dialog, via dialog:dialogId attribute, that may be obtained via getDialogId(). Dialog preference also provides an options for its associated dialog that may be obtained via getDialogOptions(). Default values for the dialog options are parsed from the Xml for the attributes specified in the section below.

Subclasses should override onCreateDialogOptions(Resources) to create type of options that are specific for theirs associated type of dialog along with #onConfigureDialogOptions(DialogOptions, Context, AttributeSet, int, int) where these options should be configured from the provided AttributeSet. Also onHandleDialogButtonClick(Dialog, int) should be override to provide default handling of dialog button click event.

Default value

This preference implementation does not parse any default value. However parsing of default value may be performed by the subclasses of this preference.

Dialog Xml attributes

See SettingPreference, SettingDialogPreference Attributes

Default style attribute

android:dialogPreferenceStyle

Author:

Martin Albedinsky

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	SettingDialogPreference.OnClickListener Listener that may be used to receive a callback that a specific dialog preference has been clicked.

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

android.preference.Preference.BaseSavedState, android.preference.Preference.OnPreferenceChangeListener, android.preference.Preference.OnPreferenceClickListener

Field Summary

Fields

Modifier and Type	Field and Description
static int	NO_DIALOG_ID Constant identifying no dialog id.

Fields inherited from class android.preference.Preference

DEFAULT_ORDER

Constructor Summary

Constructors

Constructor and Description
SettingDialogPreference(android.content.Context context) Same as SettingDialogPreference(Context, AttributeSet) without attributes.
SettingDialogPreference(android.content.Context context, android.util.AttributeSet attrs) Same as SettingDialogPreference(Context, AttributeSet, int) with R.attr.dialogPreferenceStyle as attribute for default style.
SettingDialogPreference(android.content.Context context, android.util.AttributeSet attrs, int defStyleAttr) Same as SettingDialogPreference(Context, AttributeSet, int, int) with 0 as default style.
SettingDialogPreference(android.content.Context context, android.util.AttributeSet attrs, int defStyleAttr, int defStyleRes) Creates a new instance of SettingDialogPreference for the given context.

Method Summary

Modifier and Type	Method and Description
int	getDialogId() Returns id of the dialog associated with this dialog preference.
O	getDialogOptions() Returns the dialog options specific for the dialog associated with this dialog preference.
boolean	handleOnDialogButtonClick(Dialog dialog, int button) Handles click event for the specified button occurred in the given dialog.
protected void	onConfigureDialogOptions(O options, android.content.Context context, android.util.AttributeSet attrs, int defStyleAttr, int defStyleRes) Called from one of constructors to configure dialog options specific for this dialog preference.
protected O	onCreateDialogOptions(android.content.res.Resources resources) Called to create instance of dialog options specific for this dialog preference.
protected CharSequence	onGetSummaryText() Called from synchronizeSummaryView(View) to retrieve the current summary text for this dialog preference.
protected boolean	onHandleDialogButtonClick(Dialog dialog, int button) Called from handleOnDialogButtonClick(Dialog, int) if the given dialog has id associated with this dialog preference.
void	setOnClickListener(SettingDialogPreference.OnClickListener listener) Registers a callback to be invoked whenever this dialog preference is clicked.
protected void	synchronizeSummaryView(android.view.View view) Performs synchronization of the summary view of this dialog preference.

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

onBindView, setKey

Methods inherited from class android.preference.Preference

callChangeListener, compareTo, findPreferenceInHierarchy, getContext, getDependency, getEditor, getExtras, getFragment, getIcon, getIntent, getKey, getLayoutResource, getOnPreferenceChangeListener, getOnPreferenceClickListener, getOrder, getPersistedBoolean, getPersistedFloat, getPersistedInt, getPersistedLong, getPersistedString, getPersistedStringSet, getPreferenceManager, getSharedPreferences, getShouldDisableView, getSummary, getTitle, getTitleRes, getView, getWidgetLayoutResource, hasKey, isEnabled, isPersistent, isSelectable, notifyChanged, notifyDependencyChange, notifyHierarchyChanged, onAttachedToActivity, onAttachedToHierarchy, onClick, onCreateView, onDependencyChanged, onGetDefaultValue, onParentChanged, onPrepareForRemoval, onRestoreInstanceState, onSaveInstanceState, onSetInitialValue, peekExtras, persistBoolean, persistFloat, persistInt, persistLong, persistString, persistStringSet, restoreHierarchyState, saveHierarchyState, setDefaultValue, setDependency, setEnabled, setFragment, setIcon, setIcon, setIntent, setLayoutResource, setOnPreferenceChangeListener, setOnPreferenceClickListener, setOrder, setPersistent, setSelectable, setShouldDisableView, setSummary, setSummary, setTitle, setTitle, setWidgetLayoutResource, shouldCommit, shouldDisableDependents, shouldPersist, toString

Methods inherited from class java.lang.Object

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

Field Detail

NO_DIALOG_ID

public static final int NO_DIALOG_ID

Constant identifying no dialog id.

See Also:

getDialogId(), Constant Field Values

Constructor Detail

SettingDialogPreference

public SettingDialogPreference(android.content.Context context)

Same as SettingDialogPreference(Context, AttributeSet) without attributes.

SettingDialogPreference

public SettingDialogPreference(android.content.Context context,
                               android.util.AttributeSet attrs)

Same as SettingDialogPreference(Context, AttributeSet, int) with R.attr.dialogPreferenceStyle as attribute for default style.

SettingDialogPreference

public SettingDialogPreference(android.content.Context context,
                               android.util.AttributeSet attrs,
                               int defStyleAttr)

Same as SettingDialogPreference(Context, AttributeSet, int, int) with 0 as default style.

SettingDialogPreference

public SettingDialogPreference(android.content.Context context,
                               android.util.AttributeSet attrs,
                               int defStyleAttr,
                               int defStyleRes)

Creates a new instance of SettingDialogPreference for the given context.

Parameters:

context - Context in which will be the new setting preference presented.

attrs - Set of Xml attributes used to configure the new instance of this preference.

defStyleAttr - An attribute which contains a reference to a default style resource for this preference within a theme of the given context.

defStyleRes - Resource id of the default style for the new preference.

Method Detail

onConfigureDialogOptions

protected void onConfigureDialogOptions(O options,
                                        android.content.Context context,
                                        android.util.AttributeSet attrs,
                                        int defStyleAttr,
                                        int defStyleRes)

Called from one of constructors to configure dialog options specific for this dialog preference.

Parameters:

options - The options created via onCreateDialogOptions(Resources).

onCreateDialogOptions

protected O onCreateDialogOptions(android.content.res.Resources resources)

Called to create instance of dialog options specific for this dialog preference.

Default implementation creates instance of DialogOptions.

Parameters:

resources - Application resources that may be used supply default values from resources for the options.

Returns:

New instance of dialog options.

setOnClickListener

public void setOnClickListener(SettingDialogPreference.OnClickListener listener)

Registers a callback to be invoked whenever this dialog preference is clicked.

Note, that this method uses Preference.setOnPreferenceClickListener(OnPreferenceClickListener) to register the requested callback. Any previously registered OnPreferenceClickListener will be replaced.

Parameters:

listener - The desired callback. May be null to clear the current one.

getDialogId

public final int getDialogId()

Returns id of the dialog associated with this dialog preference.

Returns:

This preference's associated dialog id.

See Also:

dialog:dialogId

getDialogOptions

public O getDialogOptions()

Returns the dialog options specific for the dialog associated with this dialog preference.

Subclasses may override this method and provide the dialog options with the current preferred value so it may be properly displayed in the associated dialog.

Returns:

This preference's dialog options.

synchronizeSummaryView

protected void synchronizeSummaryView(android.view.View view)

Performs synchronization of the summary view of this dialog preference.

Default implementation takes the summary text provided by onGetSummaryText() method and sets is text for the summary view, changing its visibility so the summary view is visible if there is some summary text available or gone if there is no summary text available.

This method may be called from SettingPreference.onBindView(View).

Parameters:

view - The root view of this preference.

onGetSummaryText

protected CharSequence onGetSummaryText()

Called from synchronizeSummaryView(View) to retrieve the current summary text for this dialog preference.

Default implementation returns the text provided by Preference.getSummary() method.

Returns:

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

handleOnDialogButtonClick

public boolean handleOnDialogButtonClick(Dialog dialog,
                                         int button)

Handles click event for the specified button occurred in the given dialog.

Parameters:

dialog - The dialog where the button has been clicked.

button - The clicked dialog button.

Returns:

True if the dialog has id associated with this preference and the button click event has been successfully handled by this preference, false otherwise so it should be handled by the caller.

onHandleDialogButtonClick

protected boolean onHandleDialogButtonClick(Dialog dialog,
                                            int button)

Called from handleOnDialogButtonClick(Dialog, int) if the given dialog has id associated with this dialog preference.

Parameters:

dialog - The dialog where the button has been clicked.

button - The clicked dialog button.

Returns:

True if the button click event has been successfully handled, false otherwise.