Most visited

Recently visited

PreferenceGroup

public abstract class PreferenceGroup
extends Preference

java.lang.Object
   ↳ android.support.v7.preference.Preference
     ↳ android.support.v7.preference.PreferenceGroup
Known Direct Subclasses


一个容器,用于多个Preference对象。 它是父类的首选项对象的基类,如PreferenceCategoryPreferenceScreen

Developer Guides

有关使用首选项构建设置UI的信息,请阅读 Settings指南。

Summary

Nested classes

interface PreferenceGroup.PreferencePositionCallback

PreferenceGroup适配器的接口实现,以便scrollToPreference(String)scrollToPreference(Preference)scrollToPreference(String)scrollToPreference(Preference)可以确定要请求的正确滚动位置。

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

Preference findPreference(CharSequence key)

根据其密钥查找 Preference

Preference getPreference(int index)

返回特定索引处的 Preference

int getPreferenceCount()

返回儿童 Preference s。

boolean isOrderingAsAdded()

该组是否按照它们添加的顺序排序偏好。

void notifyDependencyChange(boolean disableDependents)

通知任何监听依赖者影响依赖性的更改。

void onAttached()

当首选项层次已被附加到首选项列表时调用。

void onDetached()

当首选项层次已从首选项列表中分离时调用。

void removeAll()

从该组中删除所有 Preferences

boolean removePreference(Preference preference)

从该组中删除 Preference

void setOrderingAsAdded(boolean orderingAsAdded)

是否订购添加该组的 Preference儿童。

Protected methods

void dispatchRestoreInstanceState(Bundle container)

restoreHierarchyState(Bundle)调用以检索此首选项及其子项的保存状态。

void dispatchSaveInstanceState(Bundle container)

saveHierarchyState(Bundle)调用以存储此首选项及其子项的实例。

boolean isOnSameScreenAsChildren()

此偏好组是否应该与其包含的偏好一起显示在同一屏幕上。

boolean onPrepareAddPreference(Preference preference)

准备将 Preference添加到组中。

Inherited methods

From class android.support.v7.preference.Preference
From class java.lang.Object
From interface java.lang.Comparable

Public constructors

PreferenceGroup

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

Parameters
context Context
attrs AttributeSet
defStyleAttr int
defStyleRes int

PreferenceGroup

PreferenceGroup (Context context, 
                AttributeSet attrs, 
                int defStyleAttr)

Parameters
context Context
attrs AttributeSet
defStyleAttr int

PreferenceGroup

PreferenceGroup (Context context, 
                AttributeSet attrs)

Parameters
context Context
attrs AttributeSet

Public methods

addItemFromInflater

void addItemFromInflater (Preference preference)

由充气器调用以将项目添加到该组。

Parameters
preference Preference

addPreference

boolean addPreference (Preference preference)

根据偏好的顺序在正确的位置添加 Preference

Parameters
preference Preference: The preference to add.
Returns
boolean Whether the preference is now in this group.

findPreference

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.

getPreference

Preference getPreference (int index)

在特定索引处返回 Preference

Parameters
index int: The index of the Preference to retrieve.
Returns
Preference The Preference.

getPreferenceCount

int getPreferenceCount ()

返回儿童 Preference s。

Returns
int The number of preference children in this group.

isOrderingAsAdded

boolean isOrderingAsAdded ()

该组是否按照它们添加的顺序排序偏好。

Returns
boolean Whether this group orders based on the order the children are added.

也可以看看:

notifyDependencyChange

void notifyDependencyChange (boolean disableDependents)

通知任何监听依赖者影响依赖性的更改。

Parameters
disableDependents boolean: Whether this Preference should disable its dependents.

onAttached

void onAttached ()

当首选项层次已被附加到首选项列表时调用。 当此首选项已附加到已连接到首选项列表的组时,也可以调用此选项。

onDetached

void onDetached ()

当首选项层次已从首选项列表中分离时调用。 当此首选项已从附加到首选项列表的组中移除时,也可以调用此选项。

removeAll

void removeAll ()

删除此组中的所有 Preferences

removePreference

boolean removePreference (Preference preference)

从该组中删除 Preference

Parameters
preference Preference: The preference to remove.
Returns
boolean Whether the preference was found and removed.

setOrderingAsAdded

void setOrderingAsAdded (boolean orderingAsAdded)

是否订购添加该组的Preference儿童。 如果这是错误的,那么顺序将遵循每个偏好顺序,并且对于没有顺序的顺序,默认顺序为字母顺序。

如果在添加偏好设置后调用它,那么它们将不会按照它们添加的顺序重新排序,因此请尽早调用此方法。

Parameters
orderingAsAdded boolean: Whether to order according to the order added.

也可以看看:

Protected methods

dispatchRestoreInstanceState

void dispatchRestoreInstanceState (Bundle container)

restoreHierarchyState(Bundle)调用以检索此首选项及其子项的已保存状态。 可能会被覆盖以修改首选项的子项的恢复方式。 例如,某些首选项对象可能不想为其子项保存状态。

Parameters
container Bundle: The Bundle that holds the previously saved state.

dispatchSaveInstanceState

void dispatchSaveInstanceState (Bundle container)

saveHierarchyState(Bundle)调用以存储此首选项及其子项的实例。 可能会被覆盖以修改如何为孩子保存。 例如,某些首选项对象可能不想为其子项存储实例。

Parameters
container Bundle: The Bundle in which to save the instance of this Preference.

isOnSameScreenAsChildren

boolean isOnSameScreenAsChildren ()

此偏好组是否应该与其包含的偏好一起显示在同一屏幕上。

Returns
boolean True if the contained preferences should be shown on the same screen as this preference.

onPrepareAddPreference

boolean onPrepareAddPreference (Preference preference)

准备将 Preference添加到组中。

Parameters
preference Preference: The preference to add.
Returns
boolean Whether to allow adding the preference (true), or not (false).

Hooray!