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().