The following sample code shows a simple leanback preference fragment that is
populated from a resource.
Interface that PreferenceFragment's containing activity should
implement to be able to process preference items that wish to
switch to a specified fragment.
Called when the user has clicked on a Preference that has
a fragment class name associated with it. The implementation
should instantiate and switch to an instance of the given
fragment.
Parameters
caller
PreferenceFragment: The fragment requesting navigation.
pref
Preference: The preference requesting the fragment.
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-02-10 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-02-10 UTC."],[],[],null,["# PreferenceFragment.OnPreferenceStartFragmentCallback\n\nadded in [version 24.1.0](/topic/libraries/support-library/revisions) \nbelongs to Maven artifact com.android.support:preference-v7:28.0.0-alpha1 \nSummary: [Methods](#pubmethods) \\| [\\[Expand All\\]](#) \n\nPreferenceFragment.OnPreferenceStartFragmentCallback\n====================================================\n\n| This package is part of the Android [support library](/topic/libraries/support-library) which is no longer maintained. The support library has been superseded by [AndroidX](/jetpack/androidx) which is part of [Jetpack](/jetpack). We recommend using the AndroidX libraries in all new projects. You should also consider [migrating](/jetpack/androidx/migrate) existing projects to AndroidX. To find the AndroidX class that maps to this deprecated class, see the AndroidX support library [class\n| mappings](/jetpack/androidx/migrate/class-mappings).\n\n\n`\npublic\nstatic\n\n\ninterface\nPreferenceFragment.OnPreferenceStartFragmentCallback\n`\n\n\n`\n\n\n`\n\n|-------------------------------------------------------------------------------------|\n| android.support.v14.preference.PreferenceFragment.OnPreferenceStartFragmentCallback |\n\n|---|---|\n| Known Indirect Subclasses [LeanbackSettingsFragment](/reference/android/support/v17/preference/LeanbackSettingsFragment) |------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [LeanbackSettingsFragment](/reference/android/support/v17/preference/LeanbackSettingsFragment) | This fragment provides a container for displaying a [LeanbackPreferenceFragment](/reference/android/support/v17/preference/LeanbackPreferenceFragment) The following sample code shows a simple leanback preference fragment that is populated from a resource. | ||\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\nInterface that PreferenceFragment's containing activity should\nimplement to be able to process preference items that wish to\nswitch to a specified fragment.\n\nSummary\n-------\n\n| ### Public methods ||\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` abstract boolean` | ` `[onPreferenceStartFragment](/reference/android/support/v14/preference/PreferenceFragment.OnPreferenceStartFragmentCallback#onPreferenceStartFragment(android.support.v14.preference.PreferenceFragment, android.support.v7.preference.Preference))`(`[PreferenceFragment](/reference/android/support/v14/preference/PreferenceFragment)` caller, `[Preference](/reference/android/support/v7/preference/Preference)` pref) ` Called when the user has clicked on a Preference that has a fragment class name associated with it. |\n\nPublic methods\n--------------\n\n### onPreferenceStartFragment\n\nadded in [version 24.1.0](/topic/libraries/support-library/revisions) \n\n```\nboolean onPreferenceStartFragment (PreferenceFragment caller, \n Preference pref)\n```\n\nCalled when the user has clicked on a Preference that has\na fragment class name associated with it. The implementation\nshould instantiate and switch to an instance of the given\nfragment.\n\n\u003cbr /\u003e\n\n| Parameters ||\n|----------|------------------------------------------------------------------|\n| `caller` | `PreferenceFragment`: The fragment requesting navigation. \u003cbr /\u003e |\n| `pref` | `Preference`: The preference requesting the fragment. \u003cbr /\u003e |\n\n| Returns ||\n|-----------|-------------------------------------------------------|\n| `boolean` | true if the fragment creation has been handled \u003cbr /\u003e |\n\n-\n\n Interfaces\n ----------\n\n - [PreferenceFragment.OnPreferenceDisplayDialogCallback](/reference/android/support/v14/preference/PreferenceFragment.OnPreferenceDisplayDialogCallback)\n - [PreferenceFragment.OnPreferenceStartFragmentCallback](/reference/android/support/v14/preference/PreferenceFragment.OnPreferenceStartFragmentCallback)\n - [PreferenceFragment.OnPreferenceStartScreenCallback](/reference/android/support/v14/preference/PreferenceFragment.OnPreferenceStartScreenCallback)\n-\n\n Classes\n -------\n\n - [EditTextPreferenceDialogFragment](/reference/android/support/v14/preference/EditTextPreferenceDialogFragment)\n - [ListPreferenceDialogFragment](/reference/android/support/v14/preference/ListPreferenceDialogFragment)\n - [MultiSelectListPreference](/reference/android/support/v14/preference/MultiSelectListPreference)\n - [MultiSelectListPreferenceDialogFragment](/reference/android/support/v14/preference/MultiSelectListPreferenceDialogFragment)\n - [PreferenceDialogFragment](/reference/android/support/v14/preference/PreferenceDialogFragment)\n - [PreferenceFragment](/reference/android/support/v14/preference/PreferenceFragment)\n - [R](/reference/android/support/v14/preference/R)\n - [R.anim](/reference/android/support/v14/preference/R.anim)\n - [R.attr](/reference/android/support/v14/preference/R.attr)\n - [R.bool](/reference/android/support/v14/preference/R.bool)\n - [R.color](/reference/android/support/v14/preference/R.color)\n - [R.dimen](/reference/android/support/v14/preference/R.dimen)\n - [R.drawable](/reference/android/support/v14/preference/R.drawable)\n - [R.id](/reference/android/support/v14/preference/R.id)\n - [R.integer](/reference/android/support/v14/preference/R.integer)\n - [R.layout](/reference/android/support/v14/preference/R.layout)\n - [R.string](/reference/android/support/v14/preference/R.string)\n - [R.style](/reference/android/support/v14/preference/R.style)\n - [R.styleable](/reference/android/support/v14/preference/R.styleable)\n - [SwitchPreference](/reference/android/support/v14/preference/SwitchPreference)"]]
Known Indirect Subclasses