# PreferenceManager.OnDisplayPreferenceDialogListener

# PreferenceManager.OnDisplayPreferenceDialogListener

Artifact:[androidx.preference:preference](https://developer.android.com/jetpack/androidx/releases/preference)  
[View Source](https://cs.android.com/search?q=file:androidx/preference/PreferenceManager.java+class:androidx.preference.PreferenceManager.OnDisplayPreferenceDialogListener)  
Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/preference#1.0.0)

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/androidx/preference/PreferenceManager.OnDisplayPreferenceDialogListener "View this page in Java")

<br />

```
interface PreferenceManager.OnDisplayPreferenceDialogListener
```

<br />

Known direct subclasses  
[PreferenceFragmentCompat](https://developer.android.com/reference/kotlin/androidx/preference/PreferenceFragmentCompat),[PreferenceFragment](https://developer.android.com/reference/kotlin/androidx/preference/PreferenceFragment)  

|-------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [PreferenceFragmentCompat](https://developer.android.com/reference/kotlin/androidx/preference/PreferenceFragmentCompat) | A PreferenceFragmentCompat is the entry point to using the Preference library.                                                                                         |
| [PreferenceFragment](https://developer.android.com/reference/kotlin/androidx/preference/PreferenceFragment)             | **This class is deprecated.** Use[PreferenceFragmentCompat](https://developer.android.com/reference/kotlin/androidx/preference/PreferenceFragmentCompat)instead <br /> |

Known indirect subclasses  
[BaseLeanbackPreferenceFragmentCompat](https://developer.android.com/reference/kotlin/androidx/leanback/preference/BaseLeanbackPreferenceFragmentCompat),[BaseLeanbackPreferenceFragment](https://developer.android.com/reference/kotlin/androidx/leanback/preference/BaseLeanbackPreferenceFragment),[LeanbackPreferenceFragmentCompat](https://developer.android.com/reference/kotlin/androidx/leanback/preference/LeanbackPreferenceFragmentCompat),[LeanbackPreferenceFragment](https://developer.android.com/reference/kotlin/androidx/leanback/preference/LeanbackPreferenceFragment)  

|----------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [BaseLeanbackPreferenceFragmentCompat](https://developer.android.com/reference/kotlin/androidx/leanback/preference/BaseLeanbackPreferenceFragmentCompat) | This fragment provides a preference fragment with leanback-style behavior, suitable for embedding into broader UI elements.                                                                      |
| [BaseLeanbackPreferenceFragment](https://developer.android.com/reference/kotlin/androidx/leanback/preference/BaseLeanbackPreferenceFragment)             | **This class is deprecated.** Use[BaseLeanbackPreferenceFragmentCompat](https://developer.android.com/reference/kotlin/androidx/leanback/preference/BaseLeanbackPreferenceFragmentCompat) <br /> |
| [LeanbackPreferenceFragmentCompat](https://developer.android.com/reference/kotlin/androidx/leanback/preference/LeanbackPreferenceFragmentCompat)         | This fragment provides a fully decorated leanback-style preference fragment, including a list background and header.                                                                             |
| [LeanbackPreferenceFragment](https://developer.android.com/reference/kotlin/androidx/leanback/preference/LeanbackPreferenceFragment)                     | **This class is deprecated.** Use[LeanbackPreferenceFragmentCompat](https://developer.android.com/reference/kotlin/androidx/leanback/preference/LeanbackPreferenceFragmentCompat) <br />         |

*** ** * ** ***

Interface definition for a class that will be called when a[Preference](https://developer.android.com/reference/kotlin/androidx/preference/Preference)requests to display a dialog.

## Summary

|                             ### Public functions                              |
|-------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onDisplayPreferenceDialog](https://developer.android.com/reference/kotlin/androidx/preference/PreferenceManager.OnDisplayPreferenceDialogListener#onDisplayPreferenceDialog(androidx.preference.Preference))`(preference: `[Preference](https://developer.android.com/reference/kotlin/androidx/preference/Preference)`)` Called when a preference in the tree requests to display a dialog. |

## Public functions

### onDisplayPreferenceDialog

Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/preference#1.0.0)  

```
fun onDisplayPreferenceDialog(preference: Preference): Unit
```

Called when a preference in the tree requests to display a dialog.  

|                                                Parameters                                                 |
|-----------------------------------------------------------------------------------------------------------|---------------------------------------------|
| `preference: `[Preference](https://developer.android.com/reference/kotlin/androidx/preference/Preference) | The Preference object requesting the dialog |