public abstract class PreferenceGroup
extends Preference
java.lang.Object | ||
↳ | android.preference.Preference | |
↳ | android.preference.PreferenceGroup |
Known Direct Subclasses |
一个容器,用于多个Preference
对象。 它是父类的首选项对象的基类,例如PreferenceCategory
和PreferenceScreen
。
有关使用首选项构建设置UI的信息,请阅读 Settings指南。
XML attributes |
|
---|---|
android:orderingFromXml |
Whether to order the Preference under this group as they appear in the XML file. |
Inherited XML attributes |
|
---|---|
From class android.preference.Preference
|
Inherited constants |
---|
From class android.preference.Preference
|
Public constructors |
|
---|---|
PreferenceGroup(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) |
|
PreferenceGroup(Context context, AttributeSet attrs, int defStyleAttr) |
|
PreferenceGroup(Context context, AttributeSet attrs) |
Public methods |
|
---|---|
void |
addItemFromInflater(Preference preference) 由充气器调用以将项目添加到该组。 |
boolean |
addPreference(Preference preference) 根据偏好的顺序在正确的位置添加 |
Preference |
findPreference(CharSequence key) 根据其密钥找到 |
Preference |
getPreference(int index) 返回特定索引处的 |
int |
getPreferenceCount() 返回儿童 |
boolean |
isOrderingAsAdded() 该组是否按照它们添加的顺序排序偏好。 |
void |
notifyDependencyChange(boolean disableDependents) 通知任何监听依赖者影响依赖性的更改。 |
void |
removeAll() 删除此组中的所有 |
boolean |
removePreference(Preference preference) 从此组中删除 |
void |
setOrderingAsAdded(boolean orderingAsAdded) 是否订购添加该组的 |
Protected methods |
|
---|---|
void |
dispatchRestoreInstanceState(Bundle container) 由 |
void |
dispatchSaveInstanceState(Bundle container) 由 |
boolean |
isOnSameScreenAsChildren() 此偏好组是否应该与其包含的偏好一起显示在同一屏幕上。 |
void |
onAttachedToActivity() 当偏好层次结构已附加到 |
boolean |
onPrepareAddPreference(Preference preference) 准备将 |
void |
onPrepareForRemoval() 当此首选项从层次结构中删除时调用。 |
Inherited methods |
|
---|---|
From class android.preference.Preference
|
|
From class java.lang.Object
|
|
From interface java.lang.Comparable
|
是否按照在XML文件中出现的顺序排列此组中的首选项。 如果这是错误的,则顺序将遵循偏好顺序属性,并且对于没有顺序属性的顺序,默认为字母顺序。
必须是布尔值,可以是“ true
”或“ false
”。
这也可能是对包含此类型值的资源(形式为“ @[package:]type:name
”)或主题属性(形式为“ ?[package:][type:]name
”)的 ?[package:][type:]name
。
这对应于全局属性资源符号 orderingFromXml
。
PreferenceGroup (Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes)
Parameters | |
---|---|
context |
Context
|
attrs |
AttributeSet
|
defStyleAttr |
int
|
defStyleRes |
int
|
PreferenceGroup (Context context, AttributeSet attrs, int defStyleAttr)
Parameters | |
---|---|
context |
Context
|
attrs |
AttributeSet
|
defStyleAttr |
int
|
PreferenceGroup (Context context, AttributeSet attrs)
Parameters | |
---|---|
context |
Context
|
attrs |
AttributeSet
|
void addItemFromInflater (Preference preference)
由充气器调用以将项目添加到该组。
Parameters | |
---|---|
preference |
Preference
|
boolean addPreference (Preference preference)
根据偏好的顺序在正确的位置添加 Preference
。
Parameters | |
---|---|
preference |
Preference : The preference to add. |
Returns | |
---|---|
boolean |
Whether the preference is now in this group. |
Preference findPreference (CharSequence key)
根据其密钥找到Preference
。 如果两个Preference
共享相同的密钥(不推荐),则将返回第一个出现(以检索具有相同密钥的其他首选项,在第一首选项上调用此方法)。 如果此首选项有密钥,则不会返回。
这将递归搜索也是 PreferenceGroups
儿童的偏好。
Parameters | |
---|---|
key |
CharSequence : The key of the preference to retrieve. |
Returns | |
---|---|
Preference |
The Preference with the key, or null. |
Preference getPreference (int index)
返回特定索引处的 Preference
。
Parameters | |
---|---|
index |
int : The index of the Preference to retrieve. |
Returns | |
---|---|
Preference |
The Preference . |
int getPreferenceCount ()
返回儿童 Preference
s。
Returns | |
---|---|
int |
The number of preference children in this group. |
boolean isOrderingAsAdded ()
该组是否按照它们添加的顺序排序偏好。
Returns | |
---|---|
boolean |
Whether this group orders based on the order the children are added. |
也可以看看:
void notifyDependencyChange (boolean disableDependents)
通知任何监听依赖者影响依赖性的更改。
Parameters | |
---|---|
disableDependents |
boolean : Whether this Preference should disable its dependents. |
boolean removePreference (Preference preference)
从该组中删除 Preference
。
Parameters | |
---|---|
preference |
Preference : The preference to remove. |
Returns | |
---|---|
boolean |
Whether the preference was found and removed. |
void setOrderingAsAdded (boolean orderingAsAdded)
是否订购添加该组的Preference
儿童。 如果这是错误的,那么顺序将遵循每个偏好顺序,并且对于没有顺序的顺序,默认顺序为字母顺序。
如果在添加偏好设置后调用它,那么它们将不会按照它们添加的顺序重新排序,因此请尽早调用此方法。
Parameters | |
---|---|
orderingAsAdded |
boolean : Whether to order according to the order added. |
也可以看看:
void dispatchRestoreInstanceState (Bundle container)
由restoreHierarchyState(Bundle)
调用以检索此首选项及其子项的已保存状态。 可能会被覆盖以修改首选项的子项的恢复方式。 例如,某些首选项对象可能不想为其子项保存状态。
Parameters | |
---|---|
container |
Bundle : The Bundle that holds the previously saved state. |
void dispatchSaveInstanceState (Bundle container)
由saveHierarchyState(Bundle)
调用以存储此首选项及其子项的实例。 可能会被覆盖以修改如何为孩子保存。 例如,某些首选项对象可能不想为其子项存储实例。
Parameters | |
---|---|
container |
Bundle : The Bundle in which to save the instance of this Preference. |
boolean isOnSameScreenAsChildren ()
此偏好组是否应该与其包含的偏好一起显示在同一屏幕上。
Returns | |
---|---|
boolean |
True if the contained preferences should be shown on the same screen as this preference. |
void onAttachedToActivity ()
当偏好层次结构已附加到PreferenceActivity
。 当此首选项已附加到已连接到PreferenceActivity
的组时,也可以调用此选项。
boolean onPrepareAddPreference (Preference preference)
准备将 Preference
添加到组中。
Parameters | |
---|---|
preference |
Preference : The preference to add. |
Returns | |
---|---|
boolean |
Whether to allow adding the preference (true), or not (false). |
void onPrepareForRemoval ()
当此首选项从层次结构中删除时调用。 您应该删除对此知识的任何引用。 确保通过超类实现进行调用。