|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object javax.imageio.metadata.IIOMetadataFormatImpl
public abstract class IIOMetadataFormatImpl
提供 IIOMetadataFormat
接口的可重用实现的具体类。此外,通过 getStandardFormatInstance
方法提供一个表示标准的、插件无关的 javax_imageio_1.0
格式的静态实例。
为了提供元素和属性的本地化的描述,应该通过 ResourceBundle.getBundle
使用的常规机制来提供基本名称为 this.getClass().getName() + "Resources"
的 ResourceBundle
。简单地说,子类根据命名约定(默认情况下为扩展 IIMetadataFormatImpl
的子类的完全限定名,加上字符串 "Resources",加上国家/地区、语言和由下划线分隔的变体代码)提供一个或多个其他类。在运行期间,调用 getElementDescription
或 getAttributeDescription
将尝试根据提供的语言环境动态加载这些类,并将使用元素名称或者后跟 '/' 字符再后跟作为键的属性名的元素名称。此键将提供给 ResourceBundle
的 getString
方法,并返回所得到的节点或属性的本地化描述。
子类可以使用 setResourceBaseName
方法为资源包提供另外的基本名称。
在需要时,子类可以通过重写提供的 getElementDescription
和 getAttributeDescription
实现来选择它自己的本地化机制。
ResourceBundle.getBundle(String,Locale)
字段摘要 | |
---|---|
static String |
standardMetadataFormatName 包含标准格式名称 "javax_imageio_1.0" 的 String 常量。 |
构造方法摘要 | |
---|---|
IIOMetadataFormatImpl(String rootName, int childPolicy) 构造一个空的 IIOMetadataFormatImpl 实例,使其具有给定根元素名称和子策略(CHILD_POLICY_REPEAT 除外)。 |
|
IIOMetadataFormatImpl(String rootName, int minChildren, int maxChildren) 构造一个空的 IIOMetadataFormatImpl 实例,使其具有给定根元素名称和子策略 CHILD_POLICY_REPEAT 。 |
方法摘要 | ||
---|---|---|
protected void |
addAttribute(String elementName, String attrName, int dataType, boolean required, int listMinLength, int listMaxLength) 将新属性添加到以前定义的元素中,该元素将由值的列表定义。 |
|
protected void |
addAttribute(String elementName, String attrName, int dataType, boolean required, String defaultValue) 将新属性添加到以前定义的可以被设置为任意值的元素中。 |
|
protected void |
addAttribute(String elementName, String attrName, int dataType, boolean required, String defaultValue, List<String> enumeratedValues) 将新属性添加到以前定义的元素中,该元素将由一组枚举值定义。 |
|
protected void |
addAttribute(String elementName, String attrName, int dataType, boolean required, String defaultValue, String minValue, String maxValue, boolean minInclusive, boolean maxInclusive) 将新属性添加到以前定义的元素中,该元素将由一系列值定义。 |
|
protected void |
addBooleanAttribute(String elementName, String attrName, boolean hasDefaultValue, boolean defaultValue) 将新属性添加到以前定义的元素中,该元素将由枚举值 TRUE 和 FALSE 定义,数据类型为 DATATYPE_BOOLEAN 。 |
|
protected void |
addChildElement(String elementName, String parentName) 将现有元素添加到给定父节点类型的合法子节点的列表中。 |
|
protected void |
addElement(String elementName, String parentName, int childPolicy) 使用某个子策略( CHILD_POLICY_REPEAT 除外)将新元素类型添加到此元数据文档格式中。 |
|
protected void |
addElement(String elementName, String parentName, int minChildren, int maxChildren) 使用子策略 CHILD_POLICY_REPEAT 将新元素类型添加到此元数据文档格式中。 |
|
protected void |
addObjectValue(String elementName, Class<?> classType, int arrayMinLength, int arrayMaxLength) 允许将给定类类型的 Object 引用存储在实现指定元素的节点中。 |
|
protected
|
addObjectValue(String elementName, Class<T> classType, boolean required, T defaultValue) 允许将给定类类型的 Object 引用存储在实现指定元素的节点中。 |
|
protected
|
addObjectValue(String elementName, Class<T> classType, boolean required, T defaultValue, List<? extends T> enumeratedValues) 允许将给定类类型的 Object 引用存储在实现指定元素的节点中。 |
|
protected
|
addObjectValue(String elementName, Class<T> classType, T defaultValue, Comparable<? super T> minValue, Comparable<? super T> maxValue, boolean minInclusive, boolean maxInclusive) 允许将给定类类型的 Object 引用存储在实现指定元素的节点中。 |
|
abstract boolean |
canNodeAppear(String elementName, ImageTypeSpecifier imageType) 如果允许元素(和它下面的子树)在给定类型(由 ImageTypeSpecifier 定义)的图像的元数据文档中出现,则返回 true 。 |
|
int |
getAttributeDataType(String elementName, String attrName) 返回以 DATATYPE_ 开头的常量之一,指示指定元素中给定属性的值的格式和解释。 |
|
String |
getAttributeDefaultValue(String elementName, String attrName) 如果指定属性不显式存在于指定元素中,则以 String 的形式返回其默认值;如果不存在可用的默认值,则返回 null 。 |
|
String |
getAttributeDescription(String elementName, String attrName, Locale locale) 返回包含指定属性的描述的 String ,或者 null 。 |
|
String[] |
getAttributeEnumerations(String elementName, String attrName) 返回一个 String 数组,其包含指定元素中给定属性的合法枚举值。 |
|
int |
getAttributeListMaxLength(String elementName, String attrName) 返回可用于定义此属性的最大列表项数。 |
|
int |
getAttributeListMinLength(String elementName, String attrName) 返回可用于定义此属性的最小列表项数。 |
|
String |
getAttributeMaxValue(String elementName, String attrName) 返回属性的最大合法值。 |
|
String |
getAttributeMinValue(String elementName, String attrName) 返回属性的最小合法值。 |
|
String[] |
getAttributeNames(String elementName) 返回一个 String 数组,该数组列出了与指定元素关联的属性的名称。 |
|
int |
getAttributeValueType(String elementName, String attrName) 返回以 VALUE_ 开头的常量之一,指示指定元素中给定属性的值是任意值、被限制在指定范围中的值、被限制为一组枚举值之一,还是一个任意值的以空白分隔的列表。 |
|
String[] |
getChildNames(String elementName) 返回一个按出现顺序排列的 String 数组,指示允许作为指定元素子元素的元素的名称。 |
|
int |
getChildPolicy(String elementName) 返回以 CHILD_POLICY_ 开头的常量之一,指示指定元素子元素的合法模式。 |
|
String |
getElementDescription(String elementName, Locale locale) 返回包含指定元素的描述的 String ,或者 null 。 |
|
int |
getElementMaxChildren(String elementName) 返回使用子策略 CHILD_POLICY_REPEAT 的指定元素的最大子元素数。 |
|
int |
getElementMinChildren(String elementName) 返回使用子策略 CHILD_POLICY_REPEAT 的指定元素的最小子元素数。 |
|
int |
getObjectArrayMaxLength(String elementName) 返回指定元素中可用于定义 Object 引用的最大数组元素数。 |
|
int |
getObjectArrayMinLength(String elementName) 返回指定元素中可用于定义 Object 引用的最小数组元素数。 |
|
Class<?> |
getObjectClass(String elementName) 返回存储在元素中的 Class 类型的 Object 引用。 |
|
Object |
getObjectDefaultValue(String elementName) 返回包含指定元素中 Object 引用的默认值的 Object 。 |
|
Object[] |
getObjectEnumerations(String elementName) 返回一个 Object 数组,该数组包含指定元素中 Object 引用的合法枚举值。 |
|
Comparable<?> |
getObjectMaxValue(String elementName) 返回指定元素中 Object 引用的最大合法值。 |
|
Comparable<?> |
getObjectMinValue(String elementName) 返回指定元素中 Object 引用的最小合法值。 |
|
int |
getObjectValueType(String elementName) 返回以 VALUE_ 开头的枚举值之一,指示允许用于 Object 引用的值(枚举、范围或数组)的类型。 |
|
protected String |
getResourceBaseName() 返回当前设置的用于查找 ResourceBundle 的基本名称。 |
|
String |
getRootName() 返回格式的根元素的名称。 |
|
static IIOMetadataFormat |
getStandardFormatInstance() 返回描述标准、插件无关的 javax.imageio_1.0 元数据文档格式的 IIOMetadataFormat 对象,该文档格式在 javax.imageio.metadata 包的注释中描述。 |
|
boolean |
isAttributeRequired(String elementName, String attrName) 如果指定属性必须在指定元素中存在,则返回 true 。 |
|
protected void |
removeAttribute(String elementName, String attrName) 从以前定义的元素中移除属性。 |
|
protected void |
removeElement(String elementName) 从格式中移除元素。 |
|
protected void |
removeObjectValue(String elementName) 禁止将 Object 引用存储在实现指定元素的节点中。 |
|
protected void |
setResourceBaseName(String resourceBaseName) 设置用于查找包含此格式的元素和属性描述的 ResourceBundle 新基本名称。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
字段详细信息 |
---|
public static final String standardMetadataFormatName
"javax_imageio_1.0"
的
String
常量。
构造方法详细信息 |
---|
public IIOMetadataFormatImpl(String rootName, int childPolicy)
IIOMetadataFormatImpl
实例,使其具有给定根元素名称和子策略(
CHILD_POLICY_REPEAT
除外)。其他元素及其属性以及
Object
引用信息可以使用各种
add
方法添加。
rootName
- 根元素的名称。
childPolicy
-
CHILD_POLICY_REPEAT
之外的
CHILD_POLICY_*
常量之一。
IllegalArgumentException
- 如果
rootName
为
null
。
IllegalArgumentException
- 如果
childPolicy
不是预定义的常量之一。
public IIOMetadataFormatImpl(String rootName, int minChildren, int maxChildren)
IIOMetadataFormatImpl
实例,使其具有给定根元素名称和子策略
CHILD_POLICY_REPEAT
。其他元素及其属性以及
Object
引用信息可以使用各种
add
方法添加。
rootName
- 根元素的名称。
minChildren
- 节点的最小子节点数。
maxChildren
- 节点的最大子节点数。
IllegalArgumentException
- 如果
rootName
为
null
。
IllegalArgumentException
- 如果
minChildren
为负或大于
maxChildren
。
方法详细信息 |
---|
protected void setResourceBaseName(String resourceBaseName)
ResourceBundle
新基本名称。
在首次调用此方法之前,基本名称将等于 this.getClass().getName() + "Resources"
。
resourceBaseName
- 包含新基本名称的
String
。
IllegalArgumentException
- 如果
resourceBaseName
为
null
。
getResourceBaseName()
protected String getResourceBaseName()
ResourceBundle
的基本名称。
String
。
setResourceBaseName(java.lang.String)
protected void addElement(String elementName, String parentName, int childPolicy)
CHILD_POLICY_REPEAT
除外)将新元素类型添加到此元数据文档格式中。
elementName
- 新元素的名称。
parentName
- 将作为新元素的父元素的元素的名称。
childPolicy
-
CHILD_POLICY_REPEAT
之外的
CHILD_POLICY_*
常量之一,指示新元素的子策略。
IllegalArgumentException
- 如果
parentName
为
null
或者不是此格式的合法元素名称。
IllegalArgumentException
- 如果
childPolicy
不是预定义的常量之一。
protected void addElement(String elementName, String parentName, int minChildren, int maxChildren)
CHILD_POLICY_REPEAT
将新元素类型添加到此元数据文档格式中。
elementName
- 新元素的名称。
parentName
- 将作为新元素的父元素的元素的名称。
minChildren
- 节点的最小子节点数。
maxChildren
- 节点的最大子节点数。
IllegalArgumentException
- 如果
parentName
为
null
或者不是此格式的合法元素名称。
IllegalArgumentException
- 如果
minChildren
为负或大于
maxChildren
。
protected void addChildElement(String elementName, String parentName)
parentName
- 将作为元素的新父元素的元素的名称。
elementName
- 要作为子元素添加的元素的名称。
IllegalArgumentException
- 如果
elementName
为
null
或者不是此格式的合法元素名称。
IllegalArgumentException
- 如果
parentName
为
null
或者不是此格式的合法元素名称。
protected void removeElement(String elementName)
elementName
- 要移除的元素的名称。
protected void addAttribute(String elementName, String attrName, int dataType, boolean required, String defaultValue)
elementName
- 元素的名称。
attrName
- 要添加的属性的名称。
dataType
- 属性的数据类型(字符串格式),
DATATYPE_*
常量之一。
required
- 如果属性必须存在,则为
true
。
defaultValue
- 属性的默认值,或者为
null
。
IllegalArgumentException
- 如果
elementName
为
null
或者不是此格式的合法元素名称。
IllegalArgumentException
- 如果
attrName
为
null
。
IllegalArgumentException
- 如果
dataType
不是预定义的常量之一。
protected void addAttribute(String elementName, String attrName, int dataType, boolean required, String defaultValue, List<String> enumeratedValues)
elementName
- 元素的名称。
attrName
- 要添加的属性的名称。
dataType
- 属性的数据类型(字符串格式),
DATATYPE_*
常量之一。
required
- 如果属性必须存在,则为
true
。
defaultValue
- 属性的默认值,或者为
null
。
enumeratedValues
- 包含属性合法值的
String
组成的
List
。
IllegalArgumentException
- 如果
elementName
为
null
或者不是此格式的合法元素名称。
IllegalArgumentException
- 如果
attrName
为
null
。
IllegalArgumentException
- 如果
dataType
不是预定义的常量之一。
IllegalArgumentException
- 如果
enumeratedValues
为
null
。
IllegalArgumentException
- 如果
enumeratedValues
不包含至少一项。
IllegalArgumentException
- 如果
enumeratedValues
包含不为
String
的元素或者为
null
。
protected void addAttribute(String elementName, String attrName, int dataType, boolean required, String defaultValue, String minValue, String maxValue, boolean minInclusive, boolean maxInclusive)
elementName
- 元素的名称。
attrName
- 要添加的属性的名称。
dataType
- 属性的数据类型(字符串格式),
DATATYPE_*
常量之一。
required
- 如果属性必须存在,则为
true
。
defaultValue
- 属性的默认值,或者为
null
。
minValue
- 属性的最小(是否包括两端的值取决于
minInclusive
的值)合法值(
String
形式)。
maxValue
- 属性的最大(是否包括两端的值取决于
minInclusive
的值)合法值(
String
形式)。
minInclusive
- 如果包括
minValue
,则为
true
。
maxInclusive
- 如果包括
maxValue
,则为
true
。
IllegalArgumentException
- 如果
elementName
为
null
或者不是此格式的合法元素名称。
IllegalArgumentException
- 如果
attrName
为
null
。
IllegalArgumentException
- 如果
dataType
不是预定义的常量之一。
protected void addAttribute(String elementName, String attrName, int dataType, boolean required, int listMinLength, int listMaxLength)
elementName
- 元素的名称。
attrName
- 要添加的属性的名称。
dataType
- 属性的数据类型(字符串格式),
DATATYPE_*
常量之一。
required
- 如果属性必须存在,则为
true
。
listMinLength
- 列表项的最小合法数。
listMaxLength
- 列表项的最大合法数。
IllegalArgumentException
- 如果
elementName
为
null
或者不是此格式的合法元素名称。
IllegalArgumentException
- 如果
attrName
为
null
。
IllegalArgumentException
- 如果
dataType
不是预定义的常量之一。
IllegalArgumentException
- 如果
listMinLength
为负或大于
listMaxLength
。
protected void addBooleanAttribute(String elementName, String attrName, boolean hasDefaultValue, boolean defaultValue)
TRUE
和
FALSE
定义,数据类型为
DATATYPE_BOOLEAN
。
elementName
- 元素的名称。
attrName
- 要添加的属性的名称。
hasDefaultValue
- 如果默认值应该存在,则为
true
。
defaultValue
-
boolean
值形式的属性默认值;如果
hasDefaultValue
为
false
,则忽略该参数。
IllegalArgumentException
- 如果
elementName
为
null
或者不是此格式的合法元素名称。
IllegalArgumentException
- 如果
attrName
为
null
。
protected void removeAttribute(String elementName, String attrName)
elementName
- 元素的名称。
attrName
- 要移除的属性的名称。
IllegalArgumentException
- 如果
elementName
为
null
或者不是此格式的合法元素名称。
protected <T> void addObjectValue(String elementName, Class<T> classType, boolean required, T defaultValue)
Object
引用存储在实现指定元素的节点中。
Object
的值是不受约束的(其类类型除外)。
如果以前允许 Object
引用,则重写以前的设置值。
elementName
- 元素的名称。
classType
- 指示对象值的合法类类型的
Class
变量。
required
- 如果对象值必须存在,则为
true
。
defaultValue
-
Object
引用的默认值,或者为
null
。
IllegalArgumentException
- 如果
elementName
为
null
或者不是此格式的合法元素名称。
protected <T> void addObjectValue(String elementName, Class<T> classType, boolean required, T defaultValue, List<? extends T> enumeratedValues)
Object
引用存储在实现指定元素的节点中。
Object
的值必须为
enumeratedValues
给出的值之一。
如果以前允许 Object
引用,则重写以前的设置值。
elementName
- 元素的名称。
classType
- 指示对象值的合法类类型的
Class
变量。
required
- 如果对象值必须存在,则为
true
。
defaultValue
-
Object
引用的默认值,或者为
null
。
enumeratedValues
- 包含对象引用的合法值的
Object
组成的
List
。
IllegalArgumentException
- 如果
elementName
为
null
或者不是此格式的合法元素名称。
IllegalArgumentException
- 如果
enumeratedValues
为
null
。
IllegalArgumentException
- 如果
enumeratedValues
不包含至少一项。
IllegalArgumentException
- 如果
enumeratedValues
包含不为
classType
指定的类类型的实例或者为
null
。
protected <T extends Object & Comparable<? super T>> void addObjectValue(String elementName, Class<T> classType, T defaultValue, Comparable<? super T> minValue, Comparable<? super T> maxValue, boolean minInclusive, boolean maxInclusive)
Object
引用存储在实现指定元素的节点中。
Object
的值必须在
minValue
和
maxValue
给出的范围中。此外,类类型必须实现
Comparable
接口。
如果以前允许 Object
引用,则重写以前的设置值。
elementName
- 元素的名称。
classType
- 指示对象值的合法类类型的
Class
变量。
defaultValue
- 默认值
minValue
- 对象值的最小(是否包括两端的值取决于
minInclusive
的值)合法值(
String
形式)。
maxValue
- 对象值的最大(是否包括两端的值取决于
minInclusive
的值)合法值(
String
形式)。
minInclusive
- 如果包括
minValue
,则为
true
。
maxInclusive
- 如果包括
maxValue
,则为
true
。
IllegalArgumentException
- 如果
elementName
为
null
或者不是此格式的合法元素名称。
protected void addObjectValue(String elementName, Class<?> classType, int arrayMinLength, int arrayMaxLength)
Object
引用存储在实现指定元素的节点中。
Object
的值必须为
classType
给出的类类型的对象数组,该数组的元素至少为
arrayMinLength
至多为
arrayMaxLength
。
如果以前允许 Object
引用,则重写以前的设置值。
elementName
- 元素的名称。
classType
- 指示对象值的合法类类型的
Class
变量。
arrayMinLength
- 数组的最小合法长度。
arrayMaxLength
- 数组的最大合法长度。
IllegalArgumentException
- 如果
elementName
不是此格式的合法元素名称。
protected void removeObjectValue(String elementName)
Object
引用存储在实现指定元素的节点中。
elementName
- 元素的名称。
IllegalArgumentException
- 如果
elementName
不是此格式的合法元素名称。
public String getRootName()
IIOMetadataFormat
复制的描述
IIOMetadataFormat
中的
getRootName
String
。
public abstract boolean canNodeAppear(String elementName, ImageTypeSpecifier imageType)
IIOMetadataFormat
复制的描述
ImageTypeSpecifier
定义)的图像的元数据文档中出现,则返回
true
。例如,元数据文档格式可能包含描述图像原色的元素,该元素在写入灰度级图像时是不允许出现的。
IIOMetadataFormat
中的
canNodeAppear
elementName
- 要查询的元素的名称。
imageType
- 指示将与元数据关联的图像类型的
ImageTypeSpecifier
。
true
。
public int getElementMinChildren(String elementName)
IIOMetadataFormat
复制的描述
CHILD_POLICY_REPEAT
的指定元素的最小子元素数。例如,表示原色信息的元素可能需要具有至少 3 个子元素,每种原色一个子元素。
IIOMetadataFormat
中的
getElementMinChildren
elementName
- 要查询的元素的名称。
int
。
public int getElementMaxChildren(String elementName)
IIOMetadataFormat
复制的描述
CHILD_POLICY_REPEAT
的指定元素的最大子元素数。例如,表示 8 位调色板条目的元素可能允许重复多达 256 次。
Integer.MAX_VALUE
的值可用于指定不存在上限。
IIOMetadataFormat
中的
getElementMaxChildren
elementName
- 要查询的元素的名称。
int
。
public String getElementDescription(String elementName, Locale locale)
String
,或者
null
。如果可能,应将描述本地化为提供的
Locale
。
默认实现利用在 ResourceBundle.getBundle
的注释中描述的应变机制 (fallback mechanism),首先使用由 setResourceBaseName
设置的当前资源基本名称以及所提供的 Locale
查找 ResourceBundle
。如果找到 ResourceBundle
,则将元素名称用作其 getString
方法的键并返回结果。如果未找到 ResourceBundle
或者不存在这样的键,则返回 null
。
如果 locale
为 null
,则使用 Locale.getLocale
返回的当前默认 Locale
。
IIOMetadataFormat
中的
getElementDescription
elementName
- 元素的名称。
locale
- 尝试进行本地化的
Locale
。
IllegalArgumentException
- 如果
elementName
为
null
或者不是此格式的合法元素名称。
setResourceBaseName(java.lang.String)
public int getChildPolicy(String elementName)
IIOMetadataFormat
复制的描述
CHILD_POLICY_
开头的常量之一,指示指定元素子元素的合法模式。
IIOMetadataFormat
中的
getChildPolicy
elementName
- 要查询的元素的名称。
CHILD_POLICY_*
常量之一。
public String[] getChildNames(String elementName)
IIOMetadataFormat
复制的描述
String
数组,指示允许作为指定元素子元素的元素的名称。如果元素不能有子元素,则返回
null
。
IIOMetadataFormat
中的
getChildNames
elementName
- 要查询的元素的名称。
String
数组,或 null。
public String[] getAttributeNames(String elementName)
IIOMetadataFormat
复制的描述
String
数组,该数组列出了与指定元素关联的属性的名称。
IIOMetadataFormat
中的
getAttributeNames
elementName
- 要查询的元素的名称。
String
数组。
public int getAttributeValueType(String elementName, String attrName)
IIOMetadataFormat
复制的描述
VALUE_
开头的常量之一,指示指定元素中给定属性的值是任意值、被限制在指定范围中的值、被限制为一组枚举值之一,还是一个任意值的以空白分隔的列表。
IIOMetadataFormat
中的
getAttributeValueType
elementName
- 要查询的元素的名称。
attrName
- 要查询的属性的名称。
VALUE_*
常量之一。
public int getAttributeDataType(String elementName, String attrName)
IIOMetadataFormat
复制的描述
DATATYPE_
开头的常量之一,指示指定元素中给定属性的值的格式和解释。如果
getAttributeValueType
返回
VALUE_LIST
,则合法值为返回数据类型的值的以空白分隔的列表。
IIOMetadataFormat
中的
getAttributeDataType
elementName
- 要查询的元素的名称。
attrName
- 要查询的属性的名称。
DATATYPE_*
常量之一。
public boolean isAttributeRequired(String elementName, String attrName)
IIOMetadataFormat
复制的描述
true
。
IIOMetadataFormat
中的
isAttributeRequired
elementName
- 要查询的元素的名称。
attrName
- 要查询的属性的名称。
true
。
public String getAttributeDefaultValue(String elementName, String attrName)
IIOMetadataFormat
复制的描述
String
的形式返回其默认值;如果不存在可用的默认值,则返回
null
。
IIOMetadataFormat
中的
getAttributeDefaultValue
elementName
- 要查询的元素的名称。
attrName
- 要查询的属性的名称。
String
,或者
null
。
public String[] getAttributeEnumerations(String elementName, String attrName)
IIOMetadataFormat
复制的描述
String
数组,其包含指定元素中给定属性的合法枚举值。只应在
getAttributeValueType
返回
VALUE_ENUMERATION
的情况下调用此方法。
IIOMetadataFormat
中的
getAttributeEnumerations
elementName
- 要查询的元素的名称。
attrName
- 要查询的属性的名称。
String
数组。
public String getAttributeMinValue(String elementName, String attrName)
IIOMetadataFormat
复制的描述
getAttributeValueType
的值确定。该值以
String
的形式返回;其解释依赖于
getAttributeDataType
的值。只应在
getAttributeValueType
返回
VALUE_RANGE_*
的情况下调用此方法。
IIOMetadataFormat
中的
getAttributeMinValue
elementName
- 要查询的元素的名称。
attrName
- 要查询的属性的名称。
String
。
public String getAttributeMaxValue(String elementName, String attrName)
IIOMetadataFormat
复制的描述
getAttributeValueType
的值确定。该值以
String
的形式返回;其解释依赖于
getAttributeDataType
的值。只应在
getAttributeValueType
返回
VALUE_RANGE_*
的情况下调用此方法。
IIOMetadataFormat
中的
getAttributeMaxValue
elementName
- 要查询的
String
形式的元素名称。
attrName
- 要查询的属性的名称。
String
。
public int getAttributeListMinLength(String elementName, String attrName)
IIOMetadataFormat
复制的描述
String
。只应在
getAttributeValueType
返回
VALUE_LIST
的情况下调用此方法。
IIOMetadataFormat
中的
getAttributeListMinLength
elementName
- 要查询的元素的名称。
attrName
- 要查询的属性的名称。
public int getAttributeListMaxLength(String elementName, String attrName)
IIOMetadataFormat
复制的描述
Integer.MAX_VALUE
的值可用于指定不存在上限。属性本身被定义为一个包含多个由空白分隔的项的
String
。只应在
getAttributeValueType
返回
VALUE_LIST
的情况下调用此方法。
IIOMetadataFormat
中的
getAttributeListMaxLength
elementName
- 要查询的元素的名称。
attrName
- 要查询的属性的名称。
public String getAttributeDescription(String elementName, String attrName, Locale locale)
String
,或者
null
。如果可能,应将描述本地化为提供的
Locale
。
默认实现利用在 ResourceBundle.getBundle
的注释中描述的应变机制,首先使用由 setResourceBaseName
设置的当前资源基本名称以及所提供的 Locale
查找 ResourceBundle
。如果找到 ResourceBundle
,则将后跟 "/" 字符再后跟属性名 (elementName + "/" + attrName
) 的元素名称用作其 getString
方法的键,并返回结果。如果未找到 ResourceBundle
或者不存在这样的键,则返回 null
。
如果 locale
为 null
,则使用 Locale.getLocale
返回的当前默认 Locale
。
IIOMetadataFormat
中的
getAttributeDescription
elementName
- 元素的名称。
attrName
- 属性的名称。
locale
- 尝试进行本地化的
Locale
,或者为
null
。
IllegalArgumentException
- 如果
elementName
为
null
或者不是此格式的合法元素名称。
IllegalArgumentException
- 如果
attrName
为
null
或者不是此元素的合法属性名称。
setResourceBaseName(java.lang.String)
public int getObjectValueType(String elementName)
IIOMetadataFormat
复制的描述
VALUE_
开头的枚举值之一,指示允许用于
Object
引用的值(枚举、范围或数组)的类型。如果在给定元素中无法存储任何对象值,则此方法的结果将为
VALUE_NONE
。
合法值被定义为范围的 Object
引用必须实现 Comparable
接口。
IIOMetadataFormat
中的
getObjectValueType
elementName
- 要查询的元素的名称。
VALUE_*
常量之一。
Comparable
public Class<?> getObjectClass(String elementName)
IIOMetadataFormat
复制的描述
Class
类型的
Object
引用。如果此元素不能包含
Object
引用,则抛出
IllegalArgumentException
。如果类类型为数组,则此字段指示底层类类型(
例如,对于
int
的数组,此方法将返回
int.class
)。
合法值被定义为范围的 Object
引用必须实现 Comparable
接口。
IIOMetadataFormat
中的
getObjectClass
elementName
- 要查询的元素的名称。
Class
对象。
public Object getObjectDefaultValue(String elementName)
IIOMetadataFormat
复制的描述
Object
引用的默认值的
Object
。
IIOMetadataFormat
中的
getObjectDefaultValue
elementName
- 要查询的元素的名称。
Object
对象。
public Object[] getObjectEnumerations(String elementName)
IIOMetadataFormat
复制的描述
Object
数组,该数组包含指定元素中
Object
引用的合法枚举值。只应在
getObjectValueType
返回
VALUE_ENUMERATION
的情况下调用此方法。
与接受枚举值的节点关联的 Object
必须等于此方法返回的值之一,这里的等于是由 ==
运算符(而不是 Object.equals
方法)定义的。
IIOMetadataFormat
中的
getObjectEnumerations
elementName
- 要查询的元素的名称。
Object
数组。
public Comparable<?> getObjectMinValue(String elementName)
IIOMetadataFormat
复制的描述
Object
引用的最小合法值。是否包括此值可由
getObjectValueType
的值确定。只应在
getObjectValueType
返回以
VALUE_RANGE
开头的常量之一的情况下调用此方法。
IIOMetadataFormat
中的
getObjectMinValue
elementName
- 要查询的元素的名称。
public Comparable<?> getObjectMaxValue(String elementName)
IIOMetadataFormat
复制的描述
Object
引用的最大合法值。是否包括此值可由
getObjectValueType
的值确定。只应在
getObjectValueType
返回以
VALUE_RANGE
开头的常量之一的情况下调用此方法。
IIOMetadataFormat
中的
getObjectMaxValue
elementName
- 要查询的元素的名称。
public int getObjectArrayMinLength(String elementName)
IIOMetadataFormat
复制的描述
Object
引用的最小数组元素数。只应在
getObjectValueType
返回
VALUE_LIST
的情况下调用此方法。
IIOMetadataFormat
中的
getObjectArrayMinLength
elementName
- 要查询的元素的名称。
Object
引用的最小有效数组长度。
public int getObjectArrayMaxLength(String elementName)
IIOMetadataFormat
复制的描述
Object
引用的最大数组元素数。
Integer.MAX_VALUE
的值可用于指定不存在上限。只应在
getObjectValueType
返回
VALUE_LIST
的情况下调用此方法。
IIOMetadataFormat
中的
getObjectArrayMaxLength
elementName
- 要查询的元素的名称。
Object
引用的最大有效数组长度。
public static IIOMetadataFormat getStandardFormatInstance()
javax.imageio_1.0
元数据文档格式的
IIOMetadataFormat
对象,该文档格式在
javax.imageio.metadata
包的注释中描述。
IIOMetadataFormat
实例。
|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。