public abstract class PreferenceGroup
extends Preference
java.lang.Object | ||
↳ | android.support.v7.preference.Preference | |
↳ | android.support.v7.preference.PreferenceGroup |
Known Direct Subclasses |
一个容器,用于多个Preference
对象。 它是父类的首选项对象的基类,如PreferenceCategory
和PreferenceScreen
。
有关使用首选项构建设置UI的信息,请阅读 Settings指南。
Nested classes |
|
---|---|
interface |
PreferenceGroup.PreferencePositionCallback PreferenceGroup适配器的接口实现,以便 |
Inherited constants |
---|
From class android.support.v7.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 |
onAttached() 当首选项层次已被附加到首选项列表时调用。 |
void |
onDetached() 当首选项层次已从首选项列表中分离时调用。 |
void |
removeAll() 从该组中删除所有 |
boolean |
removePreference(Preference preference) 从该组中删除 |
void |
setOrderingAsAdded(boolean orderingAsAdded) 是否订购添加该组的 |
Protected methods |
|
---|---|
void |
dispatchRestoreInstanceState(Bundle container) 由 |
void |
dispatchSaveInstanceState(Bundle container) 由 |
boolean |
isOnSameScreenAsChildren() 此偏好组是否应该与其包含的偏好一起显示在同一屏幕上。 |
boolean |
onPrepareAddPreference(Preference preference) 准备将 |
Inherited methods |
|
---|---|
From class android.support.v7.preference.Preference
|
|
From class java.lang.Object
|
|
From interface java.lang.Comparable
|
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. |
void onAttached ()
当首选项层次已被附加到首选项列表时调用。 当此首选项已附加到已连接到首选项列表的组时,也可以调用此选项。
void onDetached ()
当首选项层次已从首选项列表中分离时调用。 当此首选项已从附加到首选项列表的组中移除时,也可以调用此选项。
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. |
boolean onPrepareAddPreference (Preference preference)
准备将 Preference
添加到组中。
Parameters | |
---|---|
preference |
Preference : The preference to add. |
Returns | |
---|---|
boolean |
Whether to allow adding the preference (true), or not (false). |