鸿蒙OS Element

Element

java.lang.Object

|---ohos.global.resource.Element

public abstract class Element
extends Object

提供根据资源 ID 获取元素的方法。

您可以调用该类的特定方法来获取与资源ID关联的指定类型的资源。

Since:

3

构造函数摘要

构造函数	描述
Element()

方法总结

修饰符和类型	方法	描述
abstract boolean	getBoolean()	获取基于此元素的布尔值。
abstract int	getColor()	根据此 Element 获取颜色值。
abstract String	getConfig()	根据资源 ID 获取配置。
abstract float	getFloat()	根据此 Element 获取浮点值。
abstract int[]	getIntArray()	获取基于此 Element 的整数数组。
abstract int	getInteger()	根据此 Element 获取整数值。
abstract Pattern	getPattern()	获取与此元素关联的 ohos.global.resource.solidxml.Pattern 实例。
abstract String	getPluralString(int quantity)	根据给定数量获取与此元素关联的多个规则的字符串表示形式。
abstract String	getPluralString(int quantity, Object... formatArgs)	根据给定的数量获取与此Element关联的多个规则的字符串表示形式，并根据指定的格式化对象对字符串进行格式化。
abstract String	getString()	根据此 Element 获取字符串值。
abstract String	getString(Object... formatArgs)	获取与此 Element 关联的字符串，并根据指定的格式化对象对字符串进行格式化。
abstract String	getString(Object[] object, Format[] format)	获取与此 Element 关联的字符串，并根据指定的格式数组和对象数组对字符串进行格式化。
abstract String	getString(Object object, Format format)	获取与此 Element 关联的字符串，并根据指定的格式和对象对字符串进行格式化。
abstract String[]	getStringArray()	获取基于此 Element 的字符串数组。
abstract Theme	getTheme()	获取与此 Element 关联的 Theme 实例。

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造函数详细信息

Element

public Element()

方法详情

getString

public abstract String getString() throws IOException, NotExistException, WrongTypeException

根据此 Element 获取字符串值。

返回:

返回字符串值。

Throws:

Throw名称	Throw描述
NotExistException	如果资源 ID 与任何资源都不匹配，则引发此异常。 资源ID必须由IDE或资源工具自动生成，或者由系统提供。
IOException	如果在资源读取期间发生 I/O 错误，则引发此异常。
WrongTypeException	如果资源不是字符串类型，则引发此异常。

Since:

3

getString

public abstract String getString(Object... formatArgs) throws IOException, NotExistException, WrongTypeException

获取与此 Element 关联的字符串，并根据指定的格式化对象对字符串进行格式化。

参数：

参数名称	参数描述
formatArgs	指示用于替换的格式化对象。

返回:

返回格式化的字符串。

Throws:

Throw名称	Throw描述
NotExistException	如果资源 ID 与任何资源都不匹配，则引发此异常。 资源ID必须由IDE或资源工具自动生成，或者由系统提供。
IOException	如果在资源读取期间发生 I/O 错误，则引发此异常。
WrongTypeException	如果资源不是字符串类型，则引发此异常。

Since:

3

getString

public abstract String getString(Object object, Format format) throws IOException, NotExistException, WrongTypeException

获取与此 Element 关联的字符串，并根据指定的格式和对象对字符串进行格式化。

参数：

参数名称	参数描述
object	表示用于替换的对象。
format	指示用于格式化对象的格式。

返回:

返回格式化的字符串。

Throws:

Throw名称	Throw描述
NotExistException	如果资源 ID 与任何资源都不匹配，则引发此异常。 资源ID必须由IDE或资源工具自动生成，或者由系统提供。
IOException	如果在资源读取期间发生 I/O 错误，则引发此异常。
WrongTypeException	如果资源不是字符串类型，则引发此异常。

Since:

3

getString

public abstract String getString(Object[] object, Format[] format) throws IOException, NotExistException, WrongTypeException

获取与此 Element 关联的字符串，并根据指定的格式数组和对象数组对字符串进行格式化。

参数：

参数名称	参数描述
object	指示用于替换的对象数组。
format	指示用于格式化对象数组的格式数组。 格式和对象是一对一的映射。

返回:

返回格式化的字符串。

Throws:

Throw名称	Throw描述
NotExistException	如果资源 ID 与任何资源都不匹配，则引发此异常。 资源ID必须由IDE或资源工具自动生成，或者由系统提供。
IOException	如果在资源读取期间发生 I/O 错误，则引发此异常。
WrongTypeException	如果资源不是字符串类型，则引发此异常。

Since:

3

getBoolean

public abstract boolean getBoolean() throws IOException, NotExistException, WrongTypeException

获取基于此元素的布尔值。

返回:

返回布尔值。

Throws:

Throw名称	Throw描述
NotExistException	如果资源 ID 与任何资源都不匹配，则引发此异常。 资源ID必须由IDE或资源工具自动生成，或者由系统提供。
IOException	如果在资源读取期间发生 I/O 错误，则引发此异常。
WrongTypeException	如果资源不是布尔类型，则引发此异常。

Since:

3

getColor

public abstract int getColor() throws IOException, NotExistException, WrongTypeException

根据此 Element 获取颜色值。

返回:

返回表示颜色数据的整数参考值。

Throws:

Throw名称	Throw描述
NotExistException	如果资源 ID 与任何资源都不匹配，则引发此异常。 资源ID必须由IDE或资源工具自动生成，或者由系统提供。
IOException	如果在资源读取期间发生 I/O 错误，则引发此异常。
WrongTypeException	如果资源不是颜色类型，则引发此异常。

Since:

3

getFloat

public abstract float getFloat() throws IOException, NotExistException, WrongTypeException

根据此 Element 获取浮点值。

返回:

返回表示维度数据的浮点参考值。

Throws:

Throw名称	Throw描述
NotExistException	如果资源 ID 与任何资源都不匹配，则引发此异常。 资源ID必须由IDE或资源工具自动生成，或者由系统提供。
IOException	如果在资源读取期间发生 I/O 错误，则引发此异常。
WrongTypeException	如果资源不是浮点类型，则引发此异常。

Since:

3

getConfig

public abstract String getConfig() throws IOException, NotExistException, WrongTypeException

根据资源 ID 获取配置。

返回:

返回一个配置。

Throws:

Throw名称	Throw描述
NotExistException	如果资源 ID 与任何资源都不匹配，则引发此异常。 资源ID必须由IDE或资源工具自动生成，或者由系统提供。
IOException	如果在资源读取期间发生 I/O 错误，则引发此异常。
WrongTypeException	如果资源不是配置类型，则抛出此异常。

Since:

3

getInteger

public abstract int getInteger() throws IOException, NotExistException, WrongTypeException

根据此 Element 获取整数值。

返回:

返回整数值。

Throws:

Throw名称	Throw描述
NotExistException	如果资源 ID 与任何资源都不匹配，则引发此异常。 资源ID必须由IDE或资源工具自动生成，或者由系统提供。
IOException	如果在资源读取期间发生 I/O 错误，则引发此异常。
WrongTypeException	如果资源不是整数类型，则引发此异常。

Since:

3

getStringArray

public abstract String[] getStringArray() throws IOException, NotExistException, WrongTypeException

获取基于此 Element 的字符串数组。

返回:

返回字符串数组。

Throws:

Throw名称	Throw描述
NotExistException	如果资源 ID 与任何资源都不匹配，则引发此异常。 资源ID必须由IDE或资源工具自动生成，或者由系统提供。
IOException	如果在资源读取期间发生 I/O 错误，则引发此异常。
WrongTypeException	如果资源不是字符串数组类型，则引发此异常。

Since:

3

getIntArray

public abstract int[] getIntArray() throws IOException, NotExistException, WrongTypeException

获取基于此 Element 的整数数组。

返回:

返回整数数组。

Throws:

Throw名称	Throw描述
NotExistException	如果资源 ID 与任何资源都不匹配，则引发此异常。 资源ID必须由IDE或资源工具自动生成，或者由系统提供。
IOException	如果在资源读取期间发生 I/O 错误，则引发此异常。
WrongTypeException	如果资源不是整数数组类型，则引发此异常。

Since:

3

getPluralString

public abstract String getPluralString(int quantity) throws IOException, NotExistException, WrongTypeException

根据给定数量获取与此元素关联的多个规则的字符串表示形式。

参数：

参数名称	参数描述
quantity	表示用于获取当前语言复数规则的字符串表示的数字。

返回:

返回复数规则的无格式字符串表示。 该字符串与资源 ID 和数量相匹配。

Throws:

Throw名称	Throw描述
NotExistException	如果资源 ID 与任何资源都不匹配，则引发此异常。 资源ID必须由IDE或资源工具自动生成，或者由系统提供。
IOException	如果在资源读取期间发生 I/O 错误，则引发此异常。
WrongTypeException	如果资源不是字符串类型，则引发此异常。

Since:

3

getPluralString

public abstract String getPluralString(int quantity, Object... formatArgs) throws IOException, NotExistException, WrongTypeException

根据给定的数量获取与此Element关联的多个规则的字符串表示形式，并根据指定的格式化对象对字符串进行格式化。

参数：

参数名称	参数描述
quantity	表示用于获取当前语言复数规则的字符串表示的数字。
formatArgs	指示用于替换的格式化对象。

返回:

返回复数规则的格式化字符串表示。 该字符串与资源 ID 和数量相匹配。

Throws:

Throw名称	Throw描述
NotExistException	如果资源 ID 与任何资源都不匹配，则引发此异常。 资源ID必须由IDE或资源工具自动生成，或者由系统提供。
IOException	如果在资源读取期间发生 I/O 错误，则引发此异常。
WrongTypeException	如果资源不是字符串类型，则引发此异常。

Since:

3

getTheme

public abstract Theme getTheme() throws IOException, NotExistException, WrongTypeException

获取与此 Element 关联的 Theme 实例。

返回:

返回一个主题实例。

Throws:

Throw名称	Throw描述
NotExistException	如果资源 ID 与任何资源都不匹配，则引发此异常。 资源ID必须由IDE或资源工具自动生成，或者由系统提供。
IOException	如果在资源读取期间发生 I/O 错误，则引发此异常。
WrongTypeException	如果资源不是主题类型，则引发此异常。

Since:

3

getPattern

public abstract Pattern getPattern() throws IOException, NotExistException, WrongTypeException

获取与此元素关联的 ohos.global.resource.solidxml.Pattern 实例。

返回:

返回 ohos.global.resource.solidxml.Pattern 实例。

Throws:

Throw名称	Throw描述
NotExistException	如果资源 ID 与任何资源都不匹配，则引发此异常。 资源ID必须由IDE或资源工具自动生成，或者由系统提供。
IOException	如果在资源读取期间发生 I/O 错误，则引发此异常。
WrongTypeException	如果资源不是模式类型，则引发此异常。

Since:

3