public interface AttributeSet
android.util.AttributeSet |
Known Indirect Subclasses |
与XML文档中的标签相关联的属性集合。 通常你不会直接使用这个接口,而是将它传递给Resources.Theme.obtainStyledAttributes()
,这将负责为你解析属性。 特别是,资源API会将资源引用(原始XML中的“@ string / my_label”等属性值)转换为您需要的类型; 如果直接使用AttributeSet,则需要手动检查资源引用(使用getAttributeResourceValue(int, int)
),并根据需要getAttributeResourceValue(int, int)
执行资源查找。 直接使用AttributeSet还可以防止在检索属性值时应用主题和样式。
该接口提供了一种从编译的XML文件中检索数据的有效机制,可以通过Xml.asAttributeSet()
为特定的XmlPullParser检索数据。 通常情况下,这将返回一个在通用XmlPullParser上工作的接口的实现,但它与编译的XML资源结合使用会更有用:
XmlPullParser parser = resources.getXml(myResource); AttributeSet attributes = Xml.asAttributeSet(parser);
与使用通用XmlPullParser之上的实现不同,此处返回的实现通过检索编译资源时由aapt生成的预先计算的信息进行高度优化。 例如, getAttributeFloatValue(int, float)
方法返回先前存储在编译资源中的浮点数,而不是在运行时解析最初在XML文件中的字符串。
此接口还提供了在常规XML文件中不可用的已编译XML资源中包含的其他信息,例如 getAttributeNameResource(int)
,它返回与特定XML属性名称关联的资源标识符。
Public methods |
|
---|---|
abstract boolean |
getAttributeBooleanValue(String namespace, String attribute, boolean defaultValue) 返回'属性'的布尔值。 |
abstract boolean |
getAttributeBooleanValue(int index, boolean defaultValue) 在'index'处返回属性的布尔值。 |
abstract int |
getAttributeCount() 返回集合中可用的属性数量。 |
abstract float |
getAttributeFloatValue(int index, float defaultValue) 在'index'处返回属性的浮点值。 |
abstract float |
getAttributeFloatValue(String namespace, String attribute, float defaultValue) 返回'属性'的浮点值。 |
abstract int |
getAttributeIntValue(String namespace, String attribute, int defaultValue) 返回'属性'的整数值。 |
abstract int |
getAttributeIntValue(int index, int defaultValue) 在'index'处返回属性的整数值。 |
abstract int |
getAttributeListValue(int index, String[] options, int defaultValue) 在'选项'列表中的'index'处返回属性值的索引。 |
abstract int |
getAttributeListValue(String namespace, String attribute, String[] options, int defaultValue) 返回列表'选项'中'属性'的值的索引。 |
abstract String |
getAttributeName(int index) 返回指定属性的名称。 |
abstract int |
getAttributeNameResource(int index) 返回与给定属性名称关联的资源ID。 |
abstract int |
getAttributeResourceValue(String namespace, String attribute, int defaultValue) 返回'attribute'的值作为资源标识符。 |
abstract int |
getAttributeResourceValue(int index, int defaultValue) 将'index'处的属性值作为资源标识符返回。 |
abstract int |
getAttributeUnsignedIntValue(String namespace, String attribute, int defaultValue) 返回格式为无符号值的“属性”的布尔值。 |
abstract int |
getAttributeUnsignedIntValue(int index, int defaultValue) 返回格式为无符号值的'index'属性的整数值。 |
abstract String |
getAttributeValue(int index) 以字符串表示形式返回指定属性的值。 |
abstract String |
getAttributeValue(String namespace, String name) 以字符串表示形式返回指定属性的值。 |
abstract String |
getClassAttribute() 返回“class”属性的值,如果没有,则返回null。 |
abstract String |
getIdAttribute() 返回“id”属性的值,如果没有,则返回null。 |
abstract int |
getIdAttributeResourceValue(int defaultValue) 如果没有,则返回“id”属性或defaultValue的整数值。 |
abstract String |
getPositionDescription() 返回属性集的当前位置的描述。 |
abstract int |
getStyleAttribute() 返回“样式”属性的值或0,如果没有一个。 |
boolean getAttributeBooleanValue (String namespace, String attribute, boolean defaultValue)
返回'属性'的布尔值。
Parameters | |
---|---|
namespace |
String : Namespace of attribute to retrieve. |
attribute |
String : The attribute to retrieve. |
defaultValue |
boolean : What to return if the attribute isn't found. |
Returns | |
---|---|
boolean |
Resulting value. |
boolean getAttributeBooleanValue (int index, boolean defaultValue)
在'index'处返回属性的布尔值。
Parameters | |
---|---|
index |
int : Index of the desired attribute, 0...count-1. |
defaultValue |
boolean : What to return if the attribute isn't found. |
Returns | |
---|---|
boolean |
Resulting value. |
int getAttributeCount ()
返回集合中可用的属性数量。
Returns | |
---|---|
int |
A positive integer, or 0 if the set is empty. |
float getAttributeFloatValue (int index, float defaultValue)
在'index'处返回属性的浮点值。
Parameters | |
---|---|
index |
int : Index of the desired attribute, 0...count-1. |
defaultValue |
float : What to return if the attribute isn't found. |
Returns | |
---|---|
float |
Resulting value. |
float getAttributeFloatValue (String namespace, String attribute, float defaultValue)
返回'属性'的浮点值。
Parameters | |
---|---|
namespace |
String : Namespace of attribute to retrieve. |
attribute |
String : The attribute to retrieve. |
defaultValue |
float : What to return if the attribute isn't found. |
Returns | |
---|---|
float |
Resulting value. |
int getAttributeIntValue (String namespace, String attribute, int defaultValue)
返回'属性'的整数值。
Parameters | |
---|---|
namespace |
String : Namespace of attribute to retrieve. |
attribute |
String : The attribute to retrieve. |
defaultValue |
int : What to return if the attribute isn't found. |
Returns | |
---|---|
int |
Resulting value. |
int getAttributeIntValue (int index, int defaultValue)
在'index'处返回属性的整数值。
Parameters | |
---|---|
index |
int : Index of the desired attribute, 0...count-1. |
defaultValue |
int : What to return if the attribute isn't found. |
Returns | |
---|---|
int |
Resulting value. |
int getAttributeListValue (int index, String[] options, int defaultValue)
在'选项'列表中的'index'处返回属性值的索引。
Parameters | |
---|---|
index |
int : Index of the desired attribute, 0...count-1. |
options |
String : List of strings whose values we are checking against. |
defaultValue |
int : Value returned if attribute doesn't exist or no match is found. |
Returns | |
---|---|
int |
Index in to 'options' or defaultValue. |
int getAttributeListValue (String namespace, String attribute, String[] options, int defaultValue)
返回列表'选项'中'属性'的值的索引。
Parameters | |
---|---|
namespace |
String : Namespace of attribute to retrieve. |
attribute |
String : Name of attribute to retrieve. |
options |
String : List of strings whose values we are checking against. |
defaultValue |
int : Value returned if attribute doesn't exist or no match is found. |
Returns | |
---|---|
int |
Index in to 'options' or defaultValue. |
String getAttributeName (int index)
返回指定属性的名称。
Parameters | |
---|---|
index |
int : Index of the desired attribute, 0...count-1. |
Returns | |
---|---|
String |
A String containing the name of the attribute, or null if the attribute cannot be found. |
int getAttributeNameResource (int index)
返回与给定属性名称关联的资源ID。 这将是属性资源的标识符,可以由样式使用。 如果没有与此属性关联的资源,则返回0。
请注意,这与getAttributeResourceValue(int, int)
不同,因为它返回属性名称的资源标识符; 另一个方法返回该属性的值作为资源标识符。
Parameters | |
---|---|
index |
int : Index of the desired attribute, 0...count-1. |
Returns | |
---|---|
int |
The resource identifier, 0 if none. |
int getAttributeResourceValue (String namespace, String attribute, int defaultValue)
返回'attribute'的值作为资源标识符。
请注意,这与getAttributeNameResource(int)
不同之getAttributeNameResource(int)
在于,它返回此属性中包含的值作为资源标识符(即最初形式为“@package:type / resource”的值); 另一个方法返回一个标识属性名称的资源标识符。
Parameters | |
---|---|
namespace |
String : Namespace of attribute to retrieve. |
attribute |
String : The attribute to retrieve. |
defaultValue |
int : What to return if the attribute isn't found. |
Returns | |
---|---|
int |
Resulting value. |
int getAttributeResourceValue (int index, int defaultValue)
将'index'处的属性值作为资源标识符返回。
请注意,这与getAttributeNameResource(int)
不同之getAttributeNameResource(int)
在于,它返回此属性中包含的值作为资源标识符(即最初形式为“@package:type / resource”的值); 另一个方法返回一个标识属性名称的资源标识符。
Parameters | |
---|---|
index |
int : Index of the desired attribute, 0...count-1. |
defaultValue |
int : What to return if the attribute isn't found. |
Returns | |
---|---|
int |
Resulting value. |
int getAttributeUnsignedIntValue (String namespace, String attribute, int defaultValue)
返回格式为无符号值的“属性”的布尔值。 特别是,处理格式0xn ... n和#n ... n。
Parameters | |
---|---|
namespace |
String : Namespace of attribute to retrieve. |
attribute |
String : The attribute to retrieve. |
defaultValue |
int : What to return if the attribute isn't found. |
Returns | |
---|---|
int |
Resulting value. |
int getAttributeUnsignedIntValue (int index, int defaultValue)
返回格式为无符号值的'index'属性的整数值。 特别是,处理格式0xn ... n和#n ... n。
Parameters | |
---|---|
index |
int : Index of the desired attribute, 0...count-1. |
defaultValue |
int : What to return if the attribute isn't found. |
Returns | |
---|---|
int |
Resulting value. |
String getAttributeValue (int index)
以字符串表示形式返回指定属性的值。
Parameters | |
---|---|
index |
int : Index of the desired attribute, 0...count-1. |
Returns | |
---|---|
String |
A String containing the value of the attribute, or null if the attribute cannot be found. |
String getAttributeValue (String namespace, String name)
以字符串表示形式返回指定属性的值。 查找是使用属性名称执行的。
Parameters | |
---|---|
namespace |
String : The namespace of the attribute to get the value from. |
name |
String : The name of the attribute to get the value from. |
Returns | |
---|---|
String |
A String containing the value of the attribute, or null if the attribute cannot be found. |
String getClassAttribute ()
返回“class”属性的值,如果没有,则返回null。 相当于getAttributeValue(null,“class”)。
Returns | |
---|---|
String |
The class attribute's value or null. |
String getIdAttribute ()
返回“id”属性的值,如果没有,则返回null。 相当于getAttributeValue(null,“id”)。
Returns | |
---|---|
String |
The id attribute's value or null. |
int getIdAttributeResourceValue (int defaultValue)
如果没有,则返回“id”属性或defaultValue的整数值。 等同于getAttributeResourceValue(null,“id”,defaultValue);
Parameters | |
---|---|
defaultValue |
int : What to return if the "id" attribute isn't found. |
Returns | |
---|---|
int |
int Resulting value. |
String getPositionDescription ()
返回属性集的当前位置的描述。 例如,如果属性集是从XML文档加载的,则位置描述可以指示当前行号。
Returns | |
---|---|
String |
A string representation of the current position in the set, may be null. |
int getStyleAttribute ()
返回“样式”属性的值或0,如果没有一个。 等价于getAttributeResourceValue(null,“style”)。
Returns | |
---|---|
int |
The style attribute's resource identifier or 0. |