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中。
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() 返回将在对话框中显示的 |
String |
getText() 从 |
void |
setText(String text) 将文本保存到 |
boolean |
shouldDisableDependents() 检查当前是否应该禁用此首选项的依赖项。 |
Protected methods |
|
---|---|
void |
onAddEditTextToDialogView(View dialogView, EditText editText) 将此首选项的EditText小部件添加到对话框的视图。 |
void |
onBindDialogView(View view) 在数据对话框的内容视图中绑定视图。 |
void |
onDialogClosed(boolean positiveResult) 当对话框被解除并且应该用于将数据保存到 |
Object |
onGetDefaultValue(TypedArray a, int index) 当首选项被夸大并且需要读取默认值属性时调用。 |
void |
onRestoreInstanceState(Parcelable state) 挂钩允许偏好重新应用以前由 |
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
|
EditTextPreference (Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes)
Parameters | |
---|---|
context |
Context
|
attrs |
AttributeSet
|
defStyleAttr |
int
|
defStyleRes |
int
|
EditTextPreference (Context context, AttributeSet attrs, int defStyleAttr)
Parameters | |
---|---|
context |
Context
|
attrs |
AttributeSet
|
defStyleAttr |
int
|
EditTextPreference (Context context, AttributeSet attrs)
Parameters | |
---|---|
context |
Context
|
attrs |
AttributeSet
|
EditTextPreference (Context context)
Parameters | |
---|---|
context |
Context
|
EditText getEditText ()
返回将在对话框中显示的 EditText
小部件。
Returns | |
---|---|
EditText |
The EditText widget that will be shown in the dialog. |
String getText ()
从 SharedPreferences
获取文本。
Returns | |
---|---|
String |
The current preference value. |
void setText (String text)
将文本保存到 SharedPreferences
。
Parameters | |
---|---|
text |
String : The text to save |
boolean shouldDisableDependents ()
检查当前是否应该禁用此首选项的依赖项。
Returns | |
---|---|
boolean |
True if the dependents should be disabled, otherwise false. |
void onAddEditTextToDialogView (View dialogView, EditText editText)
将此首选项的EditText小部件添加到对话框的视图。
Parameters | |
---|---|
dialogView |
View : The dialog view. |
editText |
EditText
|
void onBindDialogView (View view)
在数据对话框的内容视图中绑定视图。
确保通过超类实现进行调用。
Parameters | |
---|---|
view |
View : The content View of the dialog, if it is custom. |
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). |
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. |
void onRestoreInstanceState (Parcelable state)
Hook允许偏好重新应用以前由onSaveInstanceState()
生成的内部状态的表示。 这个函数永远不会被调用为null状态。
Parameters | |
---|---|
state |
Parcelable : The saved state that had previously been returned by onSaveInstanceState() . |
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. |
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. |