de.mrapp.android.preference

Class AbstractTwoStatePreference

java.lang.Object

androidx.preference.Preference

de.mrapp.android.preference.Preference

de.mrapp.android.preference.AbstractTwoStatePreference

All Implemented Interfaces:

android.widget.Checkable

Direct Known Subclasses:

AbstractCompoundButtonPreference

public abstract class AbstractTwoStatePreference
extends Preference
implements android.widget.Checkable

An abstract base class for all preferences, which have two selectable states, persist a boolean value in SharedPreferences and may have dependent preferences, that are enabled/disabled based on the current state.

Since:

1.4.0

Nested Class Summary

Nested Classes

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

Constructor Summary

Constructors

Constructor and Description
AbstractTwoStatePreference(android.content.Context context) Creates a new preference, which has two selectable states.
AbstractTwoStatePreference(android.content.Context context, android.util.AttributeSet attributeSet) Creates a new preference, which has two selectable states.
AbstractTwoStatePreference(android.content.Context context, android.util.AttributeSet attributeSet, int defaultStyle) Creates a new preference, which has two selectable states.
AbstractTwoStatePreference(android.content.Context context, android.util.AttributeSet attributeSet, int defaultStyle, int defaultStyleResource) Creates a new preference, which has two selectable states.

Method Summary

Modifier and Type	Method and Description
boolean	getDisableDependentsState() Returns, whether dependent preferences are disabled when this preference is checked, or when this preference is not checked.
java.lang.CharSequence	getSummary()
java.lang.CharSequence	getSummaryOff() Returns the summary, which is shown when the preference is not checked.
java.lang.CharSequence	getSummaryOn() Returns the summary, which is shown when the preference is checked.
boolean	isChecked()
void	onBindViewHolder(PreferenceViewHolder holder)
protected void	onCheckedChanged(boolean checked) The method, which is invoked, when the preference has been checked or unchecked.
protected void	onClick()
protected java.lang.Object	onGetDefaultValue(android.content.res.TypedArray typedArray, int index)
protected void	onRestoreInstanceState(android.os.Parcelable state)
protected android.os.Parcelable	onSaveInstanceState()
protected void	onSetInitialValue(java.lang.Object defaultValue)
void	performClick() Performs a click on the preference.
void	setChecked(boolean checked)
void	setDisableDependentsState(boolean disableDependentsState) Sets, whether dependent preferences should be disabled when this preference is checked, or when this preference is not checked.
void	setSummaryOff(java.lang.CharSequence summaryOff) Sets the summary, which should be shown when the preference is not checked.
void	setSummaryOff(int resourceId) Sets the summary, which should be shown when the preference is not checked.
void	setSummaryOn(java.lang.CharSequence summaryOn) Sets the summary, which should be shown when the preference is checked.
void	setSummaryOn(int resourceId) Sets the summary, which should be shown when the preference is checked.
boolean	shouldDisableDependents()
void	toggle()

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

getIconTintList, getIconTintMode, setIcon, setIconTint, setIconTintList, setIconTintMode

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractTwoStatePreference

public AbstractTwoStatePreference(android.content.Context context)

Creates a new preference, which has two selectable states.

Parameters:

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

AbstractTwoStatePreference

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

Creates a new preference, which has two selectable states.

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

AbstractTwoStatePreference

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

Creates a new preference, which has two selectable states.

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

AbstractTwoStatePreference

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

Creates a new preference, which has two selectable states.

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

onCheckedChanged

protected void onCheckedChanged(boolean checked)

The method, which is invoked, when the preference has been checked or unchecked.

Parameters:

checked - True, if the preference has been checked, false otherwise

getSummaryOn

public final java.lang.CharSequence getSummaryOn()

Returns the summary, which is shown when the preference is checked.

Returns:

The summary, which is shown when the preference is checked, as an instance of the type CharSequence or null, if no dedicated summary is shown when the preference is checked

setSummaryOn

public final void setSummaryOn(java.lang.CharSequence summaryOn)

Sets the summary, which should be shown when the preference is checked.

Parameters:

summaryOn - The summary, which should be set, as an instance of the type CharSequence or null, if no dedicated summary should be shown when the preference is checked

setSummaryOn

public final void setSummaryOn(int resourceId)

Sets the summary, which should be shown when the preference is checked.

Parameters:

resourceId - The resource id of the summary, which should be set, as an Integer value. The resource id must correspond to a valid string resource

getSummaryOff

public final java.lang.CharSequence getSummaryOff()

Returns the summary, which is shown when the preference is not checked.

Returns:

The summary, which is shown when the preference is not checked, as an instance of the type CharSequence or null, if no dedicated summary is shown when the preference is not checked

setSummaryOff

public final void setSummaryOff(int resourceId)

Sets the summary, which should be shown when the preference is not checked.

Parameters:

resourceId - The resource id of the summary, which should be set, as an Integer value. The resource id must correspond to a valid string resource

setSummaryOff

public final void setSummaryOff(java.lang.CharSequence summaryOff)

Sets the summary, which should be shown when the preference is not checked.

Parameters:

summaryOff - The summary, which should be set, as an instance of the type CharSequence or null, if no dedicated summary should be shown when the preference is not checked

getDisableDependentsState

public final boolean getDisableDependentsState()

Returns, whether dependent preferences are disabled when this preference is checked, or when this preference is not checked.

Returns:

True, if dependent preferences are disabled when this preference checked, false, if they are disabled when this preference is not checked

setDisableDependentsState

public final void setDisableDependentsState(boolean disableDependentsState)

Sets, whether dependent preferences should be disabled when this preference is checked, or when this preference is not checked.

Parameters:

disableDependentsState - True, if dependent preferences should be disabled when this preference is checked, false, if they should be disabled when this preference is not checked

isChecked

public final boolean isChecked()

Specified by:

isChecked in interface android.widget.Checkable

setChecked

public final void setChecked(boolean checked)

Specified by:

setChecked in interface android.widget.Checkable

toggle

public final void toggle()

Specified by:

toggle in interface android.widget.Checkable

performClick

public final void performClick()

Description copied from class: Preference

Performs a click on the preference.

Overrides:

performClick in class Preference

shouldDisableDependents

public final boolean shouldDisableDependents()

getSummary

public final java.lang.CharSequence getSummary()

onGetDefaultValue

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

onSetInitialValue

protected final void onSetInitialValue(java.lang.Object defaultValue)

onClick

protected void onClick()

onBindViewHolder

public void onBindViewHolder(PreferenceViewHolder holder)

onSaveInstanceState

protected android.os.Parcelable onSaveInstanceState()

onRestoreInstanceState

protected void onRestoreInstanceState(android.os.Parcelable state)