Most visited

Recently visited

Added in API level 1

EditTextPreference

public class EditTextPreference
extends DialogPreference

java.lang.Object
   ↳ android.preference.Preference
     ↳ android.preference.DialogPreference
       ↳ android.preference.EditTextPreference


一个允许输入字符串的 Preference

它是DialogPreference一个子类,并在对话框中显示EditText 可以通过编程方式通过getEditText()修改此EditText也可以通过在EditTextPreference上设置任何EditText属性来通过XML修改此EditText

这个首选项会将一个字符串存储到SharedPreferences中。

EditText Attributes

Summary

Inherited XML attributes

From class android.preference.DialogPreference
From class android.preference.Preference

Inherited constants

From class android.preference.Preference

Public constructors

EditTextPreference(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes)
EditTextPreference(Context context, AttributeSet attrs, int defStyleAttr)
EditTextPreference(Context context, AttributeSet attrs)
EditTextPreference(Context context)

Public methods

EditText getEditText()

返回将在对话框中显示的 EditText小部件。

String getText()

SharedPreferences获取文本。

void setText(String text)

将文本保存到 SharedPreferences

boolean shouldDisableDependents()

检查当前是否应该禁用此首选项的依赖项。

Protected methods

void onAddEditTextToDialogView(View dialogView, EditText editText)

将此首选项的EditText小部件添加到对话框的视图。

void onBindDialogView(View view)

在数据对话框的内容视图中绑定视图。

void onDialogClosed(boolean positiveResult)

当对话框被解除并且应该用于将数据保存到 SharedPreferences

Object onGetDefaultValue(TypedArray a, int index)

当首选项被夸大并且需要读取默认值属性时调用。

void onRestoreInstanceState(Parcelable state)

挂钩允许偏好重新应用以前由 onSaveInstanceState()生成的其内部状态的表示。

Parcelable onSaveInstanceState()

钩子允许首选项生成其内部状态的表示,稍后可用于创建具有相同状态的新实例。

void onSetInitialValue(boolean restoreValue, Object defaultValue)

执行此操作来设置首选项的初始值。

Inherited methods

From class android.preference.DialogPreference
From class android.preference.Preference
From class java.lang.Object
From interface android.content.DialogInterface.OnClickListener
From interface android.content.DialogInterface.OnDismissListener
From interface android.preference.PreferenceManager.OnActivityDestroyListener
From interface java.lang.Comparable

Public constructors

EditTextPreference

Added in API level 21
EditTextPreference (Context context, 
                AttributeSet attrs, 
                int defStyleAttr, 
                int defStyleRes)

Parameters
context Context
attrs AttributeSet
defStyleAttr int
defStyleRes int

EditTextPreference

Added in API level 1
EditTextPreference (Context context, 
                AttributeSet attrs, 
                int defStyleAttr)

Parameters
context Context
attrs AttributeSet
defStyleAttr int

EditTextPreference

Added in API level 1
EditTextPreference (Context context, 
                AttributeSet attrs)

Parameters
context Context
attrs AttributeSet

EditTextPreference

Added in API level 1
EditTextPreference (Context context)

Parameters
context Context

Public methods

getEditText

Added in API level 1
EditText getEditText ()

返回将在对话框中显示的 EditText小部件。

Returns
EditText The EditText widget that will be shown in the dialog.

getText

Added in API level 1
String getText ()

SharedPreferences获取文本。

Returns
String The current preference value.

setText

Added in API level 1
void setText (String text)

将文本保存到 SharedPreferences

Parameters
text String: The text to save

shouldDisableDependents

Added in API level 1
boolean shouldDisableDependents ()

检查当前是否应该禁用此首选项的依赖项。

Returns
boolean True if the dependents should be disabled, otherwise false.

Protected methods

onAddEditTextToDialogView

Added in API level 1
void onAddEditTextToDialogView (View dialogView, 
                EditText editText)

将此首选项的EditText小部件添加到对话框的视图。

Parameters
dialogView View: The dialog view.
editText EditText

onBindDialogView

Added in API level 1
void onBindDialogView (View view)

在数据对话框的内容视图中绑定视图。

确保通过超类实现进行调用。

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

onDialogClosed

Added in API level 1
void onDialogClosed (boolean positiveResult)

当对话框被解除并且应该用于将数据保存到 SharedPreferences

Parameters
positiveResult boolean: Whether the positive button was clicked (true), or the negative button was clicked or the dialog was canceled (false).

onGetDefaultValue

Added in API level 1
Object onGetDefaultValue (TypedArray a, 
                int index)

当首选项被夸大并且需要读取默认值属性时调用。 由于不同的首选项类型具有不同的值类型,因此子类应获取并返回默认值,该默认值将是其值类型。

例如,如果值类型为String,则该方法的主体将代理为 getString(int)

Parameters
a TypedArray: The set of attributes.
index int: The index of the default value attribute.
Returns
Object The default value of this preference type.

onRestoreInstanceState

Added in API level 1
void onRestoreInstanceState (Parcelable state)

Hook允许偏好重新应用以前由onSaveInstanceState()生成的内部状态的表示。 这个函数永远不会被调用为null状态。

Parameters
state Parcelable: The saved state that had previously been returned by onSaveInstanceState().

onSaveInstanceState

Added in API level 1
Parcelable onSaveInstanceState ()

钩子允许首选项生成其内部状态的表示,稍后可用于创建具有相同状态的新实例。 这个状态应该只包含不持久的或者稍后可以重建的信息。

Returns
Parcelable A Parcelable object containing the current dynamic state of this Preference, or null if there is nothing interesting to save. The default implementation returns null.

onSetInitialValue

Added in API level 1
void onSetInitialValue (boolean restoreValue, 
                Object defaultValue)

执行此操作来设置首选项的初始值。

如果restorePersistedValue为true,则应从SharedPreferences恢复首选项值。 如果restorePersistedValue为false,则应将Preference值设置为给定的defaultValue(并且如果shouldPersist()为true,则可能存储到SharedPreferences)。

这可能并不总是被称为。 一个例子是,如果它不应该坚持,但没有给出默认值。

Parameters
restoreValue boolean: True to restore the persisted value; false to use the given defaultValue.
defaultValue Object: The default value for this Preference. Only use this if restorePersistedValue is false.

Hooray!