PreferenceDialogFragment

Kotlin |Java

abstract class PreferenceDialogFragment : DialogFragment, OnClickListener

kotlin.Any
↳	android.app.Fragment
	↳	android.app.DialogFragment
		↳	androidx.preference.PreferenceDialogFragment

Known Direct Subclasses EditTextPreferenceDialogFragment, ListPreferenceDialogFragment, MultiSelectListPreferenceDialogFragment EditTextPreferenceDialogFragment ListPreferenceDialogFragment MultiSelectListPreferenceDialogFragment

Abstract base class which presents a dialog associated with a DialogPreference. Since the preference object may not be available during fragment re-creation, the necessary information for displaying the dialog is read once during the initial call to #onCreate(Bundle) and saved/restored in the saved instance state. Custom subclasses should also follow this pattern.

Summary

Constants
static String	ARG_KEY

Public constructors
<init>()

Public methods
open DialogPreference!	getPreference() Get the preference that requested this dialog.
open Unit	onClick(dialog: DialogInterface!, which: Int)
open Unit	onCreate(savedInstanceState: Bundle?)
open Dialog	onCreateDialog(savedInstanceState: Bundle!)
abstract Unit	onDialogClosed(positiveResult: Boolean)
open Unit	onDismiss(dialog: DialogInterface!)
open Unit	onSaveInstanceState(@NonNull outState: Bundle)

Protected methods
open Unit	onBindDialogView(view: View!) Binds views in the content view of the dialog to data.
open View!	onCreateDialogView(context: Context!) Creates the content view for the dialog (if a custom content view is required).
open Unit	onPrepareDialogBuilder(builder: Builder!) Prepares the dialog builder to be shown when the preference is clicked.

Constants

ARG_KEY

protected static val ARG_KEY: String

Deprecated: Use PreferenceDialogFragmentCompat instead

Value: "key"

Public constructors

<init>

PreferenceDialogFragment()

Deprecated: Use PreferenceDialogFragmentCompat instead

Public methods

getPreference

open fun getPreference(): DialogPreference!

Deprecated: Use PreferenceDialogFragmentCompat instead

Get the preference that requested this dialog. Available after #onCreate(Bundle) has been called on the PreferenceFragment which launched this dialog.

Return
DialogPreference!	The DialogPreference associated with this dialog

onClick

open fun onClick(
    dialog: DialogInterface!, 
    which: Int
): Unit

Deprecated: Use PreferenceDialogFragmentCompat instead

onCreate

open fun onCreate(savedInstanceState: Bundle?): Unit

onCreateDialog

@NonNull open fun onCreateDialog(savedInstanceState: Bundle!): Dialog

onDialogClosed

abstract fun onDialogClosed(positiveResult: Boolean): Unit

Deprecated: Use PreferenceDialogFragmentCompat instead

onDismiss

open fun onDismiss(dialog: DialogInterface!): Unit

onSaveInstanceState

open fun onSaveInstanceState(@NonNull outState: Bundle): Unit

Protected methods

onBindDialogView

protected open fun onBindDialogView(view: View!): Unit

Deprecated: Use PreferenceDialogFragmentCompat instead

Binds views in the content view of the dialog to data.

Make sure to call through to the superclass implementation.

Parameters
view	View!: The content view of the dialog, if it is custom

onCreateDialogView

protected open fun onCreateDialogView(context: Context!): View!

Deprecated: Use PreferenceDialogFragmentCompat instead

Creates the content view for the dialog (if a custom content view is required). By default, it inflates the dialog layout resource if it is set.

Return
View!	The content view for the dialog

See Also

• DialogPreference#setLayoutResource(int)

onPrepareDialogBuilder

protected open fun onPrepareDialogBuilder(builder: Builder!): Unit

Deprecated: Use PreferenceDialogFragmentCompat instead

Prepares the dialog builder to be shown when the preference is clicked. Use this to set custom properties on the dialog.

Do not AlertDialog.Builder#create() or AlertDialog.Builder#show().