Most visited

Recently visited

Added in API level 1

PreferenceGroup

public abstract class PreferenceGroup
extends Preference

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


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

Developer Guides

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

Summary

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

Preference findPreference(CharSequence key)

根据其密钥找到 Preference

Preference getPreference(int index)

返回特定索引处的 Preference

int getPreferenceCount()

返回儿童 Preference s。

boolean isOrderingAsAdded()

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

void notifyDependencyChange(boolean disableDependents)

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

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()

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

void onAttachedToActivity()

当偏好层次结构已附加到 PreferenceActivity

boolean onPrepareAddPreference(Preference preference)

准备将 Preference添加到组中。

void onPrepareForRemoval()

当此首选项从层次结构中删除时调用。

Inherited methods

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

XML attributes

android:orderingFromXml

是否按照在XML文件中出现的顺序排列此组中的首选项。 如果这是错误的,则顺序将遵循偏好顺序属性,并且对于没有顺序属性的顺序,默认为字母顺序。

必须是布尔值,可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 orderingFromXml

Public constructors

PreferenceGroup

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

Parameters
context Context
attrs AttributeSet
defStyleAttr int
defStyleRes int

PreferenceGroup

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

Parameters
context Context
attrs AttributeSet
defStyleAttr int

PreferenceGroup

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

Parameters
context Context
attrs AttributeSet

Public methods

addItemFromInflater

Added in API level 1
void addItemFromInflater (Preference preference)

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

Parameters
preference Preference

addPreference

Added in API level 1
boolean addPreference (Preference preference)

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

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

findPreference

Added in API level 1
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

Added in API level 1
Preference getPreference (int index)

返回特定索引处的 Preference

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

getPreferenceCount

Added in API level 1
int getPreferenceCount ()

返回儿童 Preference s。

Returns
int The number of preference children in this group.

isOrderingAsAdded

Added in API level 1
boolean isOrderingAsAdded ()

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

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

也可以看看:

notifyDependencyChange

Added in API level 1
void notifyDependencyChange (boolean disableDependents)

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

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

removeAll

Added in API level 1
void removeAll ()

从该组中删除所有 Preferences

removePreference

Added in API level 1
boolean removePreference (Preference preference)

从该组中删除 Preference

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

setOrderingAsAdded

Added in API level 1
void setOrderingAsAdded (boolean orderingAsAdded)

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

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

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

也可以看看:

Protected methods

dispatchRestoreInstanceState

Added in API level 1
void dispatchRestoreInstanceState (Bundle container)

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

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

dispatchSaveInstanceState

Added in API level 1
void dispatchSaveInstanceState (Bundle container)

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

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

isOnSameScreenAsChildren

Added in API level 1
boolean isOnSameScreenAsChildren ()

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

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

onAttachedToActivity

Added in API level 1
void onAttachedToActivity ()

当偏好层次结构已附加到PreferenceActivity 当此首选项已附加到已连接到PreferenceActivity的组时,也可以调用此选项。

onPrepareAddPreference

Added in API level 1
boolean onPrepareAddPreference (Preference preference)

准备将 Preference添加到组中。

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

onPrepareForRemoval

Added in API level 1
void onPrepareForRemoval ()

当此首选项从层次结构中删除时调用。 您应该删除对此知识的任何引用。 确保通过超类实现进行调用。

Hooray!