# android.support.v7.preference

added in[version 24.1.0](https://developer.android.com/topic/libraries/support-library/revisions)  

# android.support.v7.preference

| This package is part of the Android[support library](https://developer.android.com/topic/libraries/support-library)which is no longer maintained. The support library has been superseded by[AndroidX](https://developer.android.com/jetpack/androidx)which is part of[Jetpack](https://developer.android.com/jetpack). We recommend using the AndroidX libraries in all new projects. You should also consider[migrating](https://developer.android.com/jetpack/androidx/migrate)existing projects to AndroidX. To find the AndroidX class that maps to this deprecated class, see the AndroidX support library[class mappings](https://developer.android.com/jetpack/androidx/migrate/class-mappings).

## Interfaces

|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [DialogPreference.TargetFragment](https://developer.android.com/reference/android/support/v7/preference/DialogPreference.TargetFragment)                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| [Preference.OnPreferenceChangeListener](https://developer.android.com/reference/android/support/v7/preference/Preference.OnPreferenceChangeListener)                                           | Interface definition for a callback to be invoked when the value of this[Preference](https://developer.android.com/reference/android/support/v7/preference/Preference)has been changed by the user and is about to be set and/or persisted.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| [Preference.OnPreferenceClickListener](https://developer.android.com/reference/android/support/v7/preference/Preference.OnPreferenceClickListener)                                             | Interface definition for a callback to be invoked when a[Preference](https://developer.android.com/reference/android/support/v7/preference/Preference)is clicked.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| [PreferenceFragmentCompat.OnPreferenceDisplayDialogCallback](https://developer.android.com/reference/android/support/v7/preference/PreferenceFragmentCompat.OnPreferenceDisplayDialogCallback) |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| [PreferenceFragmentCompat.OnPreferenceStartFragmentCallback](https://developer.android.com/reference/android/support/v7/preference/PreferenceFragmentCompat.OnPreferenceStartFragmentCallback) | Interface that PreferenceFragment's containing activity should implement to be able to process preference items that wish to switch to a specified fragment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| [PreferenceFragmentCompat.OnPreferenceStartScreenCallback](https://developer.android.com/reference/android/support/v7/preference/PreferenceFragmentCompat.OnPreferenceStartScreenCallback)     | Interface that PreferenceFragment's containing activity should implement to be able to process preference items that wish to switch to a new screen of preferences.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| [PreferenceGroup.PreferencePositionCallback](https://developer.android.com/reference/android/support/v7/preference/PreferenceGroup.PreferencePositionCallback)                                 | Interface for PreferenceGroup Adapters to implement so that[scrollToPreference(String)](https://developer.android.com/reference/android/support/v14/preference/PreferenceFragment#scrollToPreference(java.lang.String))and[scrollToPreference(Preference)](https://developer.android.com/reference/android/support/v14/preference/PreferenceFragment#scrollToPreference(android.support.v7.preference.Preference))or[scrollToPreference(String)](https://developer.android.com/reference/android/support/v7/preference/PreferenceFragmentCompat#scrollToPreference(java.lang.String))and[scrollToPreference(Preference)](https://developer.android.com/reference/android/support/v7/preference/PreferenceFragmentCompat#scrollToPreference(android.support.v7.preference.Preference))can determine the correct scroll position to request. |
| [PreferenceManager.OnDisplayPreferenceDialogListener](https://developer.android.com/reference/android/support/v7/preference/PreferenceManager.OnDisplayPreferenceDialogListener)               | Interface definition for a class that will be called when a[Preference](https://developer.android.com/reference/android/support/v7/preference/Preference)requests to display a dialog.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| [PreferenceManager.OnNavigateToScreenListener](https://developer.android.com/reference/android/support/v7/preference/PreferenceManager.OnNavigateToScreenListener)                             | Interface definition for a class that will be called when a[PreferenceScreen](https://developer.android.com/reference/android/support/v7/preference/PreferenceScreen)requests navigation.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| [PreferenceManager.OnPreferenceTreeClickListener](https://developer.android.com/reference/android/support/v7/preference/PreferenceManager.OnPreferenceTreeClickListener)                       | Interface definition for a callback to be invoked when a[Preference](https://developer.android.com/reference/android/support/v7/preference/Preference)in the hierarchy rooted at this[PreferenceScreen](https://developer.android.com/reference/android/support/v7/preference/PreferenceScreen)is clicked.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

## Classes

|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [CheckBoxPreference](https://developer.android.com/reference/android/support/v7/preference/CheckBoxPreference)                                                                     | A[Preference](https://developer.android.com/reference/android/support/v7/preference/Preference)that provides checkbox widget functionality.                                                                                                                                                                                                                                                                                                          |
| [DialogPreference](https://developer.android.com/reference/android/support/v7/preference/DialogPreference)                                                                         | A base class for[Preference](https://developer.android.com/reference/android/support/v7/preference/Preference)objects that are dialog-based.                                                                                                                                                                                                                                                                                                         |
| [DropDownPreference](https://developer.android.com/reference/android/support/v7/preference/DropDownPreference)                                                                     | A version of[ListPreference](https://developer.android.com/reference/android/support/v7/preference/ListPreference)that presents the options in a drop down menu rather than a dialog.                                                                                                                                                                                                                                                                |
| [EditTextPreference](https://developer.android.com/reference/android/support/v7/preference/EditTextPreference)                                                                     | A[Preference](https://developer.android.com/reference/android/support/v7/preference/Preference)that allows for string input.                                                                                                                                                                                                                                                                                                                         |
| [EditTextPreferenceDialogFragmentCompat](https://developer.android.com/reference/android/support/v7/preference/EditTextPreferenceDialogFragmentCompat)                             |                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| [ListPreference](https://developer.android.com/reference/android/support/v7/preference/ListPreference)                                                                             | A[Preference](https://developer.android.com/reference/android/support/v7/preference/Preference)that displays a list of entries as a dialog.                                                                                                                                                                                                                                                                                                          |
| [ListPreferenceDialogFragmentCompat](https://developer.android.com/reference/android/support/v7/preference/ListPreferenceDialogFragmentCompat)                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| [MultiSelectListPreferenceDialogFragmentCompat](https://developer.android.com/reference/android/support/v7/preference/MultiSelectListPreferenceDialogFragmentCompat)               |                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| [Preference](https://developer.android.com/reference/android/support/v7/preference/Preference)                                                                                     | Represents the basic Preference UI building block displayed by a[PreferenceFragmentCompat](https://developer.android.com/reference/android/support/v7/preference/PreferenceFragmentCompat)in the form of a[RecyclerView](https://developer.android.com/reference/android/support/v7/widget/RecyclerView).                                                                                                                                            |
| [Preference.BaseSavedState](https://developer.android.com/reference/android/support/v7/preference/Preference.BaseSavedState)                                                       | A base class for managing the instance state of a[Preference](https://developer.android.com/reference/android/support/v7/preference/Preference).                                                                                                                                                                                                                                                                                                     |
| [PreferenceCategory](https://developer.android.com/reference/android/support/v7/preference/PreferenceCategory)                                                                     | Used to group[Preference](https://developer.android.com/reference/android/support/v7/preference/Preference)objects and provide a disabled title above the group.                                                                                                                                                                                                                                                                                     |
| [PreferenceDataStore](https://developer.android.com/reference/android/support/v7/preference/PreferenceDataStore)                                                                   | A data store interface to be implemented and provided to the Preferences framework.                                                                                                                                                                                                                                                                                                                                                                  |
| [PreferenceDialogFragmentCompat](https://developer.android.com/reference/android/support/v7/preference/PreferenceDialogFragmentCompat)                                             | Abstract base class which presents a dialog associated with a[DialogPreference](https://developer.android.com/reference/android/support/v7/preference/DialogPreference).                                                                                                                                                                                                                                                                             |
| [PreferenceFragmentCompat](https://developer.android.com/reference/android/support/v7/preference/PreferenceFragmentCompat)                                                         | Shows a hierarchy of[Preference](https://developer.android.com/reference/android/support/v7/preference/Preference)objects as lists.                                                                                                                                                                                                                                                                                                                  |
| [PreferenceGroup](https://developer.android.com/reference/android/support/v7/preference/PreferenceGroup)                                                                           | A container for multiple[Preference](https://developer.android.com/reference/android/support/v7/preference/Preference)objects.                                                                                                                                                                                                                                                                                                                       |
| [PreferenceManager](https://developer.android.com/reference/android/support/v7/preference/PreferenceManager)                                                                       | Used to help create[Preference](https://developer.android.com/reference/android/support/v7/preference/Preference)hierarchies from activities or XML.                                                                                                                                                                                                                                                                                                 |
| [PreferenceManager.PreferenceComparisonCallback](https://developer.android.com/reference/android/support/v7/preference/PreferenceManager.PreferenceComparisonCallback)             | Callback class to be used by the[RecyclerView.Adapter](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.Adapter)associated with the[PreferenceScreen](https://developer.android.com/reference/android/support/v7/preference/PreferenceScreen), used to determine when two[Preference](https://developer.android.com/reference/android/support/v7/preference/Preference)objects are semantically and visually the same. |
| [PreferenceManager.SimplePreferenceComparisonCallback](https://developer.android.com/reference/android/support/v7/preference/PreferenceManager.SimplePreferenceComparisonCallback) | A basic implementation of[PreferenceManager.PreferenceComparisonCallback](https://developer.android.com/reference/android/support/v7/preference/PreferenceManager.PreferenceComparisonCallback)suitable for use with the default[Preference](https://developer.android.com/reference/android/support/v7/preference/Preference)classes.                                                                                                               |
| [PreferenceScreen](https://developer.android.com/reference/android/support/v7/preference/PreferenceScreen)                                                                         | Represents a top-level[Preference](https://developer.android.com/reference/android/support/v7/preference/Preference)that is the root of a Preference hierarchy.                                                                                                                                                                                                                                                                                      |
| [PreferenceViewHolder](https://developer.android.com/reference/android/support/v7/preference/PreferenceViewHolder)                                                                 | A[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)class which caches views associated with the default[Preference](https://developer.android.com/reference/android/support/v7/preference/Preference)layouts.                                                                                                                                                                      |
| [R](https://developer.android.com/reference/android/support/v7/preference/R)                                                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| [R.anim](https://developer.android.com/reference/android/support/v7/preference/R.anim)                                                                                             |                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| [R.attr](https://developer.android.com/reference/android/support/v7/preference/R.attr)                                                                                             |                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| [R.bool](https://developer.android.com/reference/android/support/v7/preference/R.bool)                                                                                             |                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| [R.color](https://developer.android.com/reference/android/support/v7/preference/R.color)                                                                                           |                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| [R.dimen](https://developer.android.com/reference/android/support/v7/preference/R.dimen)                                                                                           |                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| [R.drawable](https://developer.android.com/reference/android/support/v7/preference/R.drawable)                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| [R.id](https://developer.android.com/reference/android/support/v7/preference/R.id)                                                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| [R.integer](https://developer.android.com/reference/android/support/v7/preference/R.integer)                                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| [R.layout](https://developer.android.com/reference/android/support/v7/preference/R.layout)                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| [R.string](https://developer.android.com/reference/android/support/v7/preference/R.string)                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| [R.style](https://developer.android.com/reference/android/support/v7/preference/R.style)                                                                                           |                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| [R.styleable](https://developer.android.com/reference/android/support/v7/preference/R.styleable)                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| [SeekBarPreference](https://developer.android.com/reference/android/support/v7/preference/SeekBarPreference)                                                                       | Preference based on android.preference.SeekBarPreference but uses support v7 preference as base.                                                                                                                                                                                                                                                                                                                                                     |
| [SwitchPreferenceCompat](https://developer.android.com/reference/android/support/v7/preference/SwitchPreferenceCompat)                                                             | A[Preference](https://developer.android.com/reference/android/support/v7/preference/Preference)that provides a two-state toggleable option.                                                                                                                                                                                                                                                                                                          |
| [TwoStatePreference](https://developer.android.com/reference/android/support/v7/preference/TwoStatePreference)                                                                     | Common base class for preferences that have two selectable states, persist a boolean value in SharedPreferences, and may have dependent preferences that are enabled/disabled based on the current state.                                                                                                                                                                                                                                            |

-

  ## Interfaces

  - [DialogPreference.TargetFragment](https://developer.android.com/reference/android/support/v7/preference/DialogPreference.TargetFragment)
  - [Preference.OnPreferenceChangeListener](https://developer.android.com/reference/android/support/v7/preference/Preference.OnPreferenceChangeListener)
  - [Preference.OnPreferenceClickListener](https://developer.android.com/reference/android/support/v7/preference/Preference.OnPreferenceClickListener)
  - [PreferenceFragmentCompat.OnPreferenceDisplayDialogCallback](https://developer.android.com/reference/android/support/v7/preference/PreferenceFragmentCompat.OnPreferenceDisplayDialogCallback)
  - [PreferenceFragmentCompat.OnPreferenceStartFragmentCallback](https://developer.android.com/reference/android/support/v7/preference/PreferenceFragmentCompat.OnPreferenceStartFragmentCallback)
  - [PreferenceFragmentCompat.OnPreferenceStartScreenCallback](https://developer.android.com/reference/android/support/v7/preference/PreferenceFragmentCompat.OnPreferenceStartScreenCallback)
  - [PreferenceGroup.PreferencePositionCallback](https://developer.android.com/reference/android/support/v7/preference/PreferenceGroup.PreferencePositionCallback)
  - [PreferenceManager.OnDisplayPreferenceDialogListener](https://developer.android.com/reference/android/support/v7/preference/PreferenceManager.OnDisplayPreferenceDialogListener)
  - [PreferenceManager.OnNavigateToScreenListener](https://developer.android.com/reference/android/support/v7/preference/PreferenceManager.OnNavigateToScreenListener)
  - [PreferenceManager.OnPreferenceTreeClickListener](https://developer.android.com/reference/android/support/v7/preference/PreferenceManager.OnPreferenceTreeClickListener)
-

  ## Classes

  - [CheckBoxPreference](https://developer.android.com/reference/android/support/v7/preference/CheckBoxPreference)
  - [DialogPreference](https://developer.android.com/reference/android/support/v7/preference/DialogPreference)
  - [DropDownPreference](https://developer.android.com/reference/android/support/v7/preference/DropDownPreference)
  - [EditTextPreference](https://developer.android.com/reference/android/support/v7/preference/EditTextPreference)
  - [EditTextPreferenceDialogFragmentCompat](https://developer.android.com/reference/android/support/v7/preference/EditTextPreferenceDialogFragmentCompat)
  - [ListPreference](https://developer.android.com/reference/android/support/v7/preference/ListPreference)
  - [ListPreferenceDialogFragmentCompat](https://developer.android.com/reference/android/support/v7/preference/ListPreferenceDialogFragmentCompat)
  - [MultiSelectListPreferenceDialogFragmentCompat](https://developer.android.com/reference/android/support/v7/preference/MultiSelectListPreferenceDialogFragmentCompat)
  - [Preference](https://developer.android.com/reference/android/support/v7/preference/Preference)
  - [Preference.BaseSavedState](https://developer.android.com/reference/android/support/v7/preference/Preference.BaseSavedState)
  - [PreferenceCategory](https://developer.android.com/reference/android/support/v7/preference/PreferenceCategory)
  - [PreferenceDataStore](https://developer.android.com/reference/android/support/v7/preference/PreferenceDataStore)
  - [PreferenceDialogFragmentCompat](https://developer.android.com/reference/android/support/v7/preference/PreferenceDialogFragmentCompat)
  - [PreferenceFragmentCompat](https://developer.android.com/reference/android/support/v7/preference/PreferenceFragmentCompat)
  - [PreferenceGroup](https://developer.android.com/reference/android/support/v7/preference/PreferenceGroup)
  - [PreferenceManager](https://developer.android.com/reference/android/support/v7/preference/PreferenceManager)
  - [PreferenceManager.PreferenceComparisonCallback](https://developer.android.com/reference/android/support/v7/preference/PreferenceManager.PreferenceComparisonCallback)
  - [PreferenceManager.SimplePreferenceComparisonCallback](https://developer.android.com/reference/android/support/v7/preference/PreferenceManager.SimplePreferenceComparisonCallback)
  - [PreferenceScreen](https://developer.android.com/reference/android/support/v7/preference/PreferenceScreen)
  - [PreferenceViewHolder](https://developer.android.com/reference/android/support/v7/preference/PreferenceViewHolder)
  - [R](https://developer.android.com/reference/android/support/v7/preference/R)
  - [R.anim](https://developer.android.com/reference/android/support/v7/preference/R.anim)
  - [R.attr](https://developer.android.com/reference/android/support/v7/preference/R.attr)
  - [R.bool](https://developer.android.com/reference/android/support/v7/preference/R.bool)
  - [R.color](https://developer.android.com/reference/android/support/v7/preference/R.color)
  - [R.dimen](https://developer.android.com/reference/android/support/v7/preference/R.dimen)
  - [R.drawable](https://developer.android.com/reference/android/support/v7/preference/R.drawable)
  - [R.id](https://developer.android.com/reference/android/support/v7/preference/R.id)
  - [R.integer](https://developer.android.com/reference/android/support/v7/preference/R.integer)
  - [R.layout](https://developer.android.com/reference/android/support/v7/preference/R.layout)
  - [R.string](https://developer.android.com/reference/android/support/v7/preference/R.string)
  - [R.style](https://developer.android.com/reference/android/support/v7/preference/R.style)
  - [R.styleable](https://developer.android.com/reference/android/support/v7/preference/R.styleable)
  - [SeekBarPreference](https://developer.android.com/reference/android/support/v7/preference/SeekBarPreference)
  - [SwitchPreferenceCompat](https://developer.android.com/reference/android/support/v7/preference/SwitchPreferenceCompat)
  - [TwoStatePreference](https://developer.android.com/reference/android/support/v7/preference/TwoStatePreference)