de.mrapp.android.preference

Class ListPreference

java.lang.Object

android.preference.Preference

de.mrapp.android.preference.AbstractDialogPreference

de.mrapp.android.preference.AbstractListPreference

de.mrapp.android.preference.ListPreference

All Implemented Interfaces:

android.content.DialogInterface.OnClickListener, android.content.DialogInterface.OnDismissListener, java.lang.Comparable<android.preference.Preference>

public class ListPreference
extends AbstractListPreference

A preference, which allows to select a value from a list. The selected value will immediately persisted and the preference's dialog will become closed.

Since:

1.0.0

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ListPreference.SavedState A data structure, which allows to save the internal state of a ListPreference.

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

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

Field Summary

Fields inherited from class android.preference.Preference

DEFAULT_ORDER

Constructor Summary

Constructors

Constructor and Description
ListPreference(android.content.Context context) Creates a new preference, which allows to select a value from a list.
ListPreference(android.content.Context context, android.util.AttributeSet attributeSet) Creates a new preference, which allows to select a value from a list.
ListPreference(android.content.Context context, android.util.AttributeSet attributeSet, int defaultStyle) Creates a new preference, which allows to select a value from a list.
ListPreference(android.content.Context context, android.util.AttributeSet attributeSet, int defaultStyle, int defaultStyleResource) Creates a new preference, which allows to select a value from a list.

Method Summary

Modifier and Type	Method and Description
java.lang.CharSequence	getEntry() Returns the entry, the currently persisted value of the preference belongs to.
java.lang.CharSequence	getSummary()
java.lang.String	getValue() Returns the currently persisted value of the preference.
protected void	onDialogClosed(boolean positiveResult) The method, which is invoked on subclasses when the preference's dialog has been closed.
protected java.lang.Object	onGetDefaultValue(android.content.res.TypedArray typedArray, int index)
protected void	onPrepareDialog(MaterialDialog.Builder dialogBuilder) The method, which is invoked on subclasses when the preference's dialog is about to be created.
protected void	onRestoreInstanceState(android.os.Parcelable state)
protected android.os.Parcelable	onSaveInstanceState()
protected void	onSetInitialValue(boolean restoreValue, java.lang.Object defaultValue)
void	setValue(java.lang.String value) Sets the current value of the preference.
void	setValueIndex(int index) Sets the current value of the preference.

Methods inherited from class de.mrapp.android.preference.AbstractListPreference

getDialogItemColor, getEntries, getEntryValues, indexOf, needInputMethod, setDialogItemColor, setEntries, setEntries, setEntryValues, setEntryValues

Methods inherited from class de.mrapp.android.preference.AbstractDialogPreference

getDialog, getDialogBackground, getDialogButtonBarDividerColor, getDialogButtonTextColor, getDialogContentDividerColor, getDialogHeaderBackground, getDialogHeaderIcon, getDialogIcon, getDialogMessage, getDialogMessageColor, getDialogTitle, getDialogTitleColor, getNegativeButtonText, getPositiveButtonText, isDialogButtonBarDividerShown, isDialogContentDividerShown, isDialogHeaderShown, isDialogShown, isValueShownAsSummary, onClick, onClick, onDismiss, setDialogBackground, setDialogBackground, setDialogBackgroundColor, setDialogButtonBarDividerColor, setDialogButtonTextColor, setDialogContentDividerColor, setDialogHeaderBackground, setDialogHeaderBackground, setDialogHeaderBackgroundColor, setDialogHeaderIcon, setDialogHeaderIcon, setDialogIcon, setDialogIcon, setDialogMessage, setDialogMessage, setDialogMessageColor, setDialogTitle, setDialogTitle, setDialogTitleColor, setNegativeButtonText, setNegativeButtonText, setPositiveButtonText, setPositiveButtonText, showDialogButtonBarDivider, showDialogContentDivider, showDialogHeader, showValueAsSummary

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, getPreferenceManager, getSharedPreferences, getShouldDisableView, getTitle, getTitleRes, getView, getWidgetLayoutResource, hasKey, isEnabled, isPersistent, isSelectable, notifyChanged, notifyDependencyChange, notifyHierarchyChanged, onAttachedToActivity, onAttachedToHierarchy, onBindView, onCreateView, onDependencyChanged, onParentChanged, onPrepareForRemoval, peekExtras, persistBoolean, persistFloat, persistInt, persistLong, persistString, restoreHierarchyState, saveHierarchyState, setDefaultValue, setDependency, setEnabled, setFragment, setIcon, setIcon, setIntent, setKey, 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

Constructor Detail

ListPreference

public ListPreference(android.content.Context context)

Creates a new preference, which allows to select a value from a list.

Parameters:

context - The context, which should be used by the preference, as an instance of the class Context. The context may not be null

ListPreference

public ListPreference(android.content.Context context,
                      android.util.AttributeSet attributeSet)

Creates a new preference, which allows to select a value from a list.

Parameters:

context - The context, which should be used by the preference, as an instance of the class Context. The context may not be null

attributeSet - The attributes of the XML tag that is inflating the preference, as an instance of the type AttributeSet or null, if no attributes are available

ListPreference

public ListPreference(android.content.Context context,
                      android.util.AttributeSet attributeSet,
                      int defaultStyle)

Creates a new preference, which allows to select a value from a list.

Parameters:

context - The context, which should be used by the preference, as an instance of the class Context. The context may not be null

attributeSet - The attributes of the XML tag that is inflating the preference, as an instance of the type AttributeSet or null, if no attributes are available

defaultStyle - The default style to apply to this preference. If 0, no style will be applied (beyond what is included in the theme). This may either be an attribute resource, whose value will be retrieved from the current theme, or an explicit style resource

ListPreference

public ListPreference(android.content.Context context,
                      android.util.AttributeSet attributeSet,
                      int defaultStyle,
                      int defaultStyleResource)

Creates a new preference, which allows to select a value from a list.

Parameters:

context - The context, which should be used by the preference, as an instance of the class Context. The context may not be null

attributeSet - The attributes of the XML tag that is inflating the preference, as an instance of the type AttributeSet or null, if no attributes are available

defaultStyle - The default style to apply to this preference. If 0, no style will be applied (beyond what is included in the theme). This may either be an attribute resource, whose value will be retrieved from the current theme, or an explicit style resource

defaultStyleResource - A resource identifier of a style resource that supplies default values for the preference, used only if the default style is 0 or can not be found in the theme. Can be 0 to not look for defaults

Method Detail

getValue

public final java.lang.String getValue()

Returns the currently persisted value of the preference.

Returns:

The currently persisted value of the preference as a String

setValue

public final void setValue(java.lang.String value)

Sets the current value of the preference. By setting a value, it will be persisted.

Parameters:

value - The value, which should be set, as a String

setValueIndex

public final void setValueIndex(int index)

Sets the current value of the preference. By setting a value, it will be persisted.

Parameters:

index - The index of the value, which should be set, as an Integer value

getEntry

public final java.lang.CharSequence getEntry()

Returns the entry, the currently persisted value of the preference belongs to.

Returns:

The entry, the currently persisted value of the preference belongs to, as an instance of the type CharSequence

getSummary

public final java.lang.CharSequence getSummary()

Overrides:

getSummary in class android.preference.Preference

onGetDefaultValue

protected final java.lang.Object onGetDefaultValue(android.content.res.TypedArray typedArray,
                                                   int index)

Overrides:

onGetDefaultValue in class android.preference.Preference

onSetInitialValue

protected final void onSetInitialValue(boolean restoreValue,
                                       java.lang.Object defaultValue)

Overrides:

onSetInitialValue in class android.preference.Preference

onPrepareDialog

protected final void onPrepareDialog(MaterialDialog.Builder dialogBuilder)

Description copied from class: AbstractDialogPreference

The method, which is invoked on subclasses when the preference's dialog is about to be created. The builder, which is passed as a method parameter may be manipulated by subclasses in order to change the appearance of the dialog. When views are inflated inside this method, the context of the builder should be used in order to ensure that the dialog's theme is used.

Specified by:

onPrepareDialog in class AbstractDialogPreference

Parameters:

dialogBuilder - The builder, which is used to create the preference's dialog, as an instance of the class MaterialDialog.Builder

onDialogClosed

protected final void onDialogClosed(boolean positiveResult)

Description copied from class: AbstractDialogPreference

The method, which is invoked on subclasses when the preference's dialog has been closed. This method may be used within subclasses to evaluate the changes, which have been made while the dialog was shown.

Specified by:

onDialogClosed in class AbstractDialogPreference

Parameters:

positiveResult - True, if the dialog has been close affirmatively, false otherwise

onSaveInstanceState

protected final android.os.Parcelable onSaveInstanceState()

Overrides:

onSaveInstanceState in class AbstractDialogPreference

onRestoreInstanceState

protected final void onRestoreInstanceState(android.os.Parcelable state)

Overrides:

onRestoreInstanceState in class AbstractDialogPreference