public class RestrictionEntry
extends Object
implements Parcelable
java.lang.Object | |
↳ | android.content.RestrictionEntry |
应用程序可以为多用户设备上的受限用户公开限制。 管理员可以配置这些限制,然后将其应用于受限用户。 每个限制条目都是一个可配置的限制条件。
Any application that chooses to expose such restrictions does so by implementing a receiver that handles theACTION_GET_RESTRICTION_ENTRIES
action. The receiver then returns a result bundle that contains an entry called "restrictions", whose value is an ArrayList
Constants |
|
---|---|
int |
TYPE_BOOLEAN 类型“布尔”的限制。 |
int |
TYPE_BUNDLE “捆绑”类型的限制。 |
int |
TYPE_BUNDLE_ARRAY “bundle_array”类型的限制。 |
int |
TYPE_CHOICE “选择”类型的限制。 |
int |
TYPE_INTEGER “整数”类型的限制。 |
int |
TYPE_MULTI_SELECT “多重选择”类型的限制。 |
int |
TYPE_NULL 隐藏的限制类型。 |
int |
TYPE_STRING “字符串”类型的限制。 |
Inherited constants |
---|
From interface android.os.Parcelable
|
Fields |
|
---|---|
public static final Creator<RestrictionEntry> |
CREATOR |
Public constructors |
|
---|---|
RestrictionEntry(int type, String key) 用于指定类型和键的构造函数,没有初始值; |
|
RestrictionEntry(String key, String selectedString) 构造函数为 |
|
RestrictionEntry(String key, boolean selectedState) 构造函数为 |
|
RestrictionEntry(String key, String[] selectedStrings) 构造函数为 |
|
RestrictionEntry(String key, int selectedInt) 构造函数为 |
|
RestrictionEntry(Parcel in) |
Public methods |
|
---|---|
static RestrictionEntry |
createBundleArrayEntry(String key, RestrictionEntry[] restrictionEntries) 创建一个类型为 |
static RestrictionEntry |
createBundleEntry(String key, RestrictionEntry[] restrictionEntries) 创建一个类型为 |
int |
describeContents() 描述此Parcelable实例的封送表示中包含的特殊对象的种类。 |
boolean |
equals(Object o) 指示其他某个对象是否“等于”这一个。 |
String[] |
getAllSelectedStrings() 返回当前选定值的列表。 |
String[] |
getChoiceEntries() 返回之前设置的字符串列表,这些字符串将作为选项呈现给用户。 |
String[] |
getChoiceValues() 返回先前设置的可能字符串值列表。 |
String |
getDescription() 返回条目提供的用户可见描述(如果有的话)。 |
int |
getIntValue() 当类型为 |
String |
getKey() 这是限制条目的唯一键。 |
RestrictionEntry[] |
getRestrictions() 返回此条目可能包含的可能限制条目的数组。 |
boolean |
getSelectedState() 返回类型为 |
String |
getSelectedString() 返回当前选择的字符串值。 |
String |
getTitle() 返回条目的用户可见标题(如果有)。 |
int |
getType() 返回此限制的类型。 |
int |
hashCode() 返回对象的哈希码值。 |
void |
setAllSelectedStrings(String[] allSelectedStrings) 为类型 |
void |
setChoiceEntries(Context context, int stringArrayResId) 设置将作为选项呈现给用户的字符串列表。 |
void |
setChoiceEntries(String[] choiceEntries) 设置将作为选项呈现给用户的字符串列表。 |
void |
setChoiceValues(String[] choiceValues) 设置用户可以选择的字符串值列表。 |
void |
setChoiceValues(Context context, int stringArrayResId) 设置用户可以选择的字符串值列表,类似于 |
void |
setDescription(String description) 将条目的用户可见描述设置为标题的可能子文本。 |
void |
setIntValue(int value) 当类型为 |
void |
setRestrictions(RestrictionEntry[] restrictions) 设置可能的限制条目数组,该条目可能包含。 |
void |
setSelectedState(boolean state) 为类型 |
void |
setSelectedString(String selectedString) 将字符串值设置为用作此限制的选定值。 |
void |
setTitle(String title) 设置条目的用户可见标题。 |
void |
setType(int type) 设置此限制的类型。 |
String |
toString() 返回对象的字符串表示形式。 |
void |
writeToParcel(Parcel dest, int flags) 将此对象平铺到一个包裹中。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
|
From interface android.os.Parcelable
|
int TYPE_BOOLEAN
类型“布尔”的限制。 使用它来存储布尔值,通常在UI中显示为复选框。
常数值:1(0x00000001)
int TYPE_BUNDLE_ARRAY
“bundle_array”类型的限制。 用它来存储bundles
限制的数组
常量值:8(0x00000008)
int TYPE_CHOICE
“选择”类型的限制。 用它来存储一个字符串值,通常以单选列表的形式呈现。 呼叫setChoiceEntries(String[])
和setChoiceValues(String[])
分别设置要呈现给用户的本地化列表条目和相应的值。
常量值:2(0x00000002)
int TYPE_INTEGER
“整数”类型的限制。 用它来存储一个整数值。 值的范围从MIN_VALUE
到MAX_VALUE
。
常量值:5(0x00000005)
int TYPE_MULTI_SELECT
“多重选择”类型的限制。 使用它可以显示多选列表,其中可以选择多个条目,例如用于选择特定标题至白名单。 调用setChoiceEntries(String[])
和setChoiceValues(String[])
以分别设置要呈现给用户的本地化列表条目和相应的值。 使用getAllSelectedStrings()
和setAllSelectedStrings(String[])
来操纵选择。
常量值:4(0x00000004)
int TYPE_NULL
隐藏的限制类型。 使用此类型的信息需要传输,但不应在用户界面中呈现给用户。 存储单个字符串值。
常量值:0(0x00000000)
RestrictionEntry (int type, String key)
用于指定类型和键的构造函数,没有初始值;
Parameters | |
---|---|
type |
int : the restriction type. |
key |
String : the unique key for this restriction |
RestrictionEntry (String key, String selectedString)
构造函数为 TYPE_CHOICE
类型。
Parameters | |
---|---|
key |
String : the unique key for this restriction |
selectedString |
String : the current value |
RestrictionEntry (String key, boolean selectedState)
构造函数为 TYPE_BOOLEAN
类型。
Parameters | |
---|---|
key |
String : the unique key for this restriction |
selectedState |
boolean : whether this restriction is selected or not |
RestrictionEntry (String key, String[] selectedStrings)
构造函数为 TYPE_MULTI_SELECT
类型。
Parameters | |
---|---|
key |
String : the unique key for this restriction |
selectedStrings |
String : the list of values that are currently selected |
RestrictionEntry (String key, int selectedInt)
构造函数为 TYPE_INTEGER
类型。
Parameters | |
---|---|
key |
String : the unique key for this restriction |
selectedInt |
int : the integer value of the restriction |
RestrictionEntry createBundleArrayEntry (String key, RestrictionEntry[] restrictionEntries)
创建一个类型为 TYPE_BUNDLE_ARRAY
的条目。
Parameters | |
---|---|
key |
String : the unique key for this restriction |
restrictionEntries |
RestrictionEntry : array of nested restriction entries. The array may only contain elements of type bundle . |
Returns | |
---|---|
RestrictionEntry |
the newly created restriction |
RestrictionEntry createBundleEntry (String key, RestrictionEntry[] restrictionEntries)
创建一个类型为 TYPE_BUNDLE
的条目。
Parameters | |
---|---|
key |
String : the unique key for this restriction |
restrictionEntries |
RestrictionEntry : array of nested restriction entries. |
Returns | |
---|---|
RestrictionEntry |
the newly created restriction |
int describeContents ()
描述此Parcelable实例的封送表示中包含的特殊对象的种类。 例如,如果对象将在writeToParcel(Parcel, int)
的输出中包含writeToParcel(Parcel, int)
,则此方法的返回值必须包含CONTENTS_FILE_DESCRIPTOR
位。
Returns | |
---|---|
int |
a bitmask indicating the set of special object types marshaled by this Parcelable object instance. |
boolean equals (Object o)
指示其他某个对象是否“等于”这一个。
equals
方法在非空对象引用上实现等价关系:
x
, x.equals(x)
should return true
. x
and y
, x.equals(y)
should return true
if and only if y.equals(x)
returns true
. x
, y
, and z
, if x.equals(y)
returns true
and y.equals(z)
returns true
, then x.equals(z)
should return true
. x
and y
, multiple invocations of x.equals(y)
consistently return true
or consistently return false
, provided no information used in equals
comparisons on the objects is modified. x
, x.equals(null)
should return false
. 类Object
的equals
方法实现了对象上最可能的等价关系; 也就是说,对于任何非空参考值x
和y
,当且仅当x
和y
引用同一对象( x == y
的值为true
)时,此方法返回true
。
请注意,无论何时覆盖此方法,通常都需要覆盖 hashCode
方法,以便维护 hashCode
方法的一般合同,该方法声明相等对象必须具有相同的散列代码。
Parameters | |
---|---|
o |
Object : the reference object with which to compare. |
Returns | |
---|---|
boolean |
true if this object is the same as the obj argument; false otherwise. |
String[] getAllSelectedStrings ()
返回当前选定值的列表。
Returns | |
---|---|
String[] |
the list of current selections, if type is TYPE_MULTI_SELECT , null otherwise. |
String[] getChoiceEntries ()
返回之前设置的字符串列表,这些字符串将作为选项呈现给用户。
Returns | |
---|---|
String[] |
the list of choices presented to the user. |
String[] getChoiceValues ()
返回先前设置的可能字符串值列表。
Returns | |
---|---|
String[] |
the list of possible values. |
String getDescription ()
返回条目提供的用户可见描述(如果有的话)。
Returns | |
---|---|
String |
the user-visible description, null if none was set earlier. |
int getIntValue ()
当类型为 TYPE_INTEGER
时,以整数形式返回条目的值。
Returns | |
---|---|
int |
the integer value of the entry. |
String getKey ()
这是限制条目的唯一键。
Returns | |
---|---|
String |
the key for the restriction. |
RestrictionEntry[] getRestrictions ()
返回此条目可能包含的可能限制条目的数组。
Returns | |
---|---|
RestrictionEntry[] |
boolean getSelectedState ()
返回类型为 TYPE_BOOLEAN
的条目的当前选定状态。
Returns | |
---|---|
boolean |
the current selected state of the entry. |
String getSelectedString ()
返回当前选择的字符串值。
Returns | |
---|---|
String |
the currently selected value, which can be null for types that aren't for holding single string values. |
String getTitle ()
返回条目的用户可见标题(如果有)。
Returns | |
---|---|
String |
the user-visible title for the entry, null if none was set earlier. |
int hashCode ()
返回对象的哈希码值。 该方法支持哈希表的好处,例如由HashMap
提供的哈希表。
hashCode
的总合同是:
hashCode
method must consistently return the same integer, provided no information used in equals
comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application. equals(Object)
method, then calling the hashCode
method on each of the two objects must produce the same integer result. equals(java.lang.Object)
method, then calling the hashCode
method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables. 尽可能合理实用,由类Object
定义的hashCode方法确实为不同的对象返回不同的整数。 (这通常通过将对象的内部地址转换为整数来实现,但Java TM编程语言不需要此实现技术。)
Returns | |
---|---|
int |
a hash code value for this object. |
void setAllSelectedStrings (String[] allSelectedStrings)
为类型TYPE_MULTI_SELECT
的条目设置选定值的当前列表。 这些值将被系统持久保存以供应用程序稍后使用。
Parameters | |
---|---|
allSelectedStrings |
String : the current list of selected values. |
void setChoiceEntries (Context context, int stringArrayResId)
设置将作为选项呈现给用户的字符串列表。 这与setChoiceEntries(String[])
类似。
Parameters | |
---|---|
context |
Context : the application context, used for retrieving the resources. |
stringArrayResId |
int : the resource id of a string array containing the possible entries. |
void setChoiceEntries (String[] choiceEntries)
设置将作为选项呈现给用户的字符串列表。 当用户选择一个或多个这些选项时,可能值中的对应值将作为选定的字符串存储。 此数组的大小必须与setChoiceValues(String[])
设置的数组的大小相匹配。 此方法与TYPE_CHOICE
和TYPE_MULTI_SELECT
以外的类型TYPE_MULTI_SELECT
。
Parameters | |
---|---|
choiceEntries |
String : the list of user-visible choices. |
也可以看看:
void setChoiceValues (String[] choiceValues)
设置用户可以选择的字符串值列表。 如果通过调用setChoiceEntries(String[])
未设置用户可见条目,则这些值将显示给用户。 将根据用户的选择从该列表中选择值,并且可以通过调用getAllSelectedStrings()
或getSelectedString()
来检索所选值,具体取决于它是多选类型还是选择类型。 此方法与TYPE_CHOICE
和TYPE_MULTI_SELECT
以外的类型TYPE_MULTI_SELECT
。
Parameters | |
---|---|
choiceValues |
String : an array of Strings which will be the selected values for the user's selections. |
void setChoiceValues (Context context, int stringArrayResId)
设置用户可以选择的字符串值列表,类似于 setChoiceValues(String[])
。
Parameters | |
---|---|
context |
Context : the application context for retrieving the resources. |
stringArrayResId |
int : the resource id for a string array containing the possible values. |
也可以看看:
void setDescription (String description)
将条目的用户可见描述设置为标题的可能子文本。 您可以使用它来更详细地描述条目或显示限制的当前状态。
Parameters | |
---|---|
description |
String : the user-visible description string. |
void setIntValue (int value)
当类型为 TYPE_INTEGER
时,设置条目的整数值。
Parameters | |
---|---|
value |
int : the integer value to set. |
void setRestrictions (RestrictionEntry[] restrictions)
设置可能的限制条目数组,该条目可能包含。
此方法仅适用于类型 TYPE_BUNDLE
和 TYPE_BUNDLE_ARRAY
Parameters | |
---|---|
restrictions |
RestrictionEntry
|
void setSelectedState (boolean state)
为类型TYPE_BOOLEAN
的条目设置当前所选状态。 该值将被系统持久保存以供应用程序稍后使用。
Parameters | |
---|---|
state |
boolean : the current selected state |
void setSelectedString (String selectedString)
将字符串值设置为用作此限制的选定值。 该值将被系统持久保存以供应用程序稍后使用。
Parameters | |
---|---|
selectedString |
String : the string value to select. |
void setTitle (String title)
设置条目的用户可见标题。
Parameters | |
---|---|
title |
String : the user-visible title for the entry. |
void setType (int type)
设置此限制的类型。
Parameters | |
---|---|
type |
int : the type for this restriction. |
String toString ()
返回对象的字符串表示形式。 通常, toString
方法返回一个“文本表示”该对象的字符串。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。
类Object
的toString
方法返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @
”和对象的哈希代码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:
getClass().getName() + '@' + Integer.toHexString(hashCode())
Returns | |
---|---|
String |
a string representation of the object. |
void writeToParcel (Parcel dest, int flags)
将此对象平铺到一个包裹中。
Parameters | |
---|---|
dest |
Parcel : The Parcel in which the object should be written. |
flags |
int : Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE . |