IIOMetadataFormatImpl (Java Platform SE 8 )

java.lang.Object
- javax.imageio.metadata.IIOMetadataFormatImpl

All Implemented Interfaces:

IIOMetadataFormat
```
public abstract class IIOMetadataFormatImpl
extends Object
implements IIOMetadataFormat
```
一个具体的类提供了可重用的IIOMetadataFormat IIOMetadataFormat实现。另外，表示标准的静态实例，插件中性javax_imageio_1.0格式由getStandardFormatInstance方法提供。
为了提供元素和属性的局部描述中， ResourceBundle用的基本名称this.getClass().getName() + "Resources"应通过所使用的通常的机构供给ResourceBundle.getBundle 。简单地说，根据命名约定subclasser供应一个或多个其他类（默认情况下，子类扩展的完全限定名称IIMetadataFormatImpl ，加上字符串“资源”，加上国家，语言和变型码用下划线分隔）。在运行时，调用getElementDescription或getAttributeDescription将尝试根据提供的语言环境动态加载这些类，并将使用元素名称或元素名称后跟一个'/'字符，后跟属性名称作为键。该密钥将提供给ResourceBundle的getString方法，并返回对结果或属性的本地化描述。

子类可以使用setResourceBaseName方法为资源束提供不同的基本名称。

如果需要，一个子类可以选择自己的本地化机制，覆盖所提供的getElementDescription和getAttributeDescription 。

另请参见：

ResourceBundle.getBundle(String,Locale)

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`standardMetadataFormatName` 一个 `String`常数包含标准格式名称， `"javax_imageio_1.0"` 。

构造方法摘要

构造方法
Constructor and Description
`IIOMetadataFormatImpl(String rootName, int childPolicy)` 构造一个空白的 `IIOMetadataFormatImpl`实例，具有给定的根元素名称和子策略（ `CHILD_POLICY_REPEAT` ）。
`IIOMetadataFormatImpl(String rootName, int minChildren, int maxChildren)` 构造一个空白的 `IIOMetadataFormatImpl`实例，具有给定的根元素名称和 `CHILD_POLICY_REPEAT`的子策略。

方法摘要

所有方法静态方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`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, 类<?> classType, int arrayMinLength, int arrayMaxLength)` 允许给定类类型的 `Object`引用存储在实现命名元素的节点中。
`protected <T> void`	`addObjectValue(String elementName, 类<T> classType, boolean required, T defaultValue)` 允许给定类类型的 `Object`引用存储在实现命名元素的节点中。
`protected <T> void`	`addObjectValue(String elementName, 类<T> classType, boolean required, T defaultValue, List<? extends T> enumeratedValues)` 允许给定类类型的 `Object`引用存储在实现命名元素的节点中。
`protected <T extends Object & Comparable<? super T>> void`	`addObjectValue(String elementName, 类<T> classType, T defaultValue, Comparable<? super T> minValue, Comparable<? super T> maxValue, boolean minInclusive, boolean maxInclusive)` 允许给定类类型的 `Object`引用存储在实现命名元素的节点中。
`abstract boolean`	`canNodeAppear(String elementName, ImageTypeSpecifier imageType)` 返回 `true`如果元素（及其下面的子树）被允许出现在由 `ImageTypeSpecifier`定义的给定类型的图像的元数据文档中。
`int`	`getAttributeDataType(String elementName, String attrName)` 返回以DATATYPE_开头的 `DATATYPE_` ，表示指定元素中给定属性的值的格式和解释。
`String`	`getAttributeDefaultValue(String elementName, String attrName)` 返回指定属性的默认值，如果没有明确指定元素中存在，为 `String` ，或 `null`如果没有默认值是可用的。
`String`	`getAttributeDescription(String elementName, String attrName, Locale locale)` 返回一个 `String`该命名属性的描述的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_开头的 `VALUE_` ，指示指定元素中给定属性的值是否是任意的，被限制在指定范围内，被限制为一组枚举值中的一个，或者是空格分隔的列表的任意值。
`String[]`	`getChildNames(String elementName)` 返回一个 `String` s的数组， `String`允许作为命名元素的子元素的元素的名称，按照它们应该出现的顺序。
`int`	`getChildPolicy(String elementName)` 返回以CHILD_POLICY_开始的 `CHILD_POLICY_` ，指示命名元素的子代码的合法模式。
`String`	`getElementDescription(String elementName, Locale locale)` 返回一个 `String`含有指定元素，或的描述 `null` 。
`int`	`getElementMaxChildren(String elementName)` 返回具有子策略 `CHILD_POLICY_REPEAT`的命名元素的最大子 `CHILD_POLICY_REPEAT` 。
`int`	`getElementMinChildren(String elementName)` 返回具有子策略 `CHILD_POLICY_REPEAT`的命名元素的最 `CHILD_POLICY_REPEAT` 。
`int`	`getObjectArrayMaxLength(String elementName)` 返回可用于定义指定元素中 `Object`引用的最大数组元素数。
`int`	`getObjectArrayMinLength(String elementName)` 返回可用于定义指定元素中 `Object`引用的最小数组元素数。
`类<?>`	`getObjectClass(String elementName)` 返回存储在元素中的 `Object`参考的 `类`类型。
`Object`	`getObjectDefaultValue(String elementName)` 返回一个 `Object`命名元素中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` s。
`String`	`getRootName()` 返回格式的根元素的名称。
`static IIOMetadataFormat`	`getStandardFormatInstance()` 返回 `IIOMetadataFormat` `javax.imageio.metadata`包的注释中描述的标准，插件中性 `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` s，其中包含此格式的元素和属性说明。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细信息
  - standardMetadataFormatName
```
public static final String standardMetadataFormatName
```
    一个 String常数包含标准格式名称， "javax_imageio_1.0" 。
    
    另请参见：
    
    Constant Field Values
- 构造方法详细信息
  - IIOMetadataFormatImpl
```
public IIOMetadataFormatImpl(String rootName,
                             int childPolicy)
```
    构造一个空白的IIOMetadataFormatImpl实例，具有给定的根元素名称和子策略（ CHILD_POLICY_REPEAT ）。附加元素及其属性和Object参考信息可以使用各种add方法添加。
    
    参数
    
    rootName - 根元素的名称。
    
    childPolicy - CHILD_POLICY_*常数之一，不 CHILD_POLICY_REPEAT 。
    
    异常
    
    IllegalArgumentException - 如果 rootName是 null 。
    
    IllegalArgumentException - 如果 childPolicy不是预定义的常量之一。
  - IIOMetadataFormatImpl
```
public IIOMetadataFormatImpl(String rootName,
                             int minChildren,
                             int maxChildren)
```
    构造一个空白的IIOMetadataFormatImpl实例，具有给定的根元素名称和子策略CHILD_POLICY_REPEAT 。附加元素及其属性和Object参考信息可以使用各种add方法添加。
    
    参数
    
    rootName - 根元素的名称。
    
    minChildren - 节点的最 minChildren数。
    
    maxChildren - 节点的最大子节点数。
    
    异常
    
    IllegalArgumentException - 如果 rootName是 null 。
    
    IllegalArgumentException - 如果 minChildren为负数或大于 maxChildren 。
- 方法详细信息
  - setResourceBaseName
```
protected void setResourceBaseName(String resourceBaseName)
```
    设置一个新的基本名称，用于定位ResourceBundle此格式的元素和属性说明的ResourceBundle。
    在第一次调用此方法之前，基本名称将等于this.getClass().getName() + "Resources" 。
    
    参数
    
    resourceBaseName - 一个 String新的基本名称的String。
    
    异常
    
    IllegalArgumentException - 如果 resourceBaseName是 null 。
    
    另请参见：
    
    getResourceBaseName()
  - getResourceBaseName
```
protected String getResourceBaseName()
```
    返回当前设置的基本名称，以定位 ResourceBundle s。
    
    结果
    
    一个 String基本名称的 String 。
    
    另请参见：
    
    setResourceBaseName(java.lang.String)
  - addElement
```
protected void addElement(String elementName,
                          String parentName,
                          int childPolicy)
```
    使用 CHILD_POLICY_REPEAT以外的子策略向元数据文档格式添加新的元素类型。
    
    参数
    
    elementName - 新元素的名称。
    
    parentName - 将作为新元素的父元素的元素的名称。
    
    childPolicy -一个的 CHILD_POLICY_*常数，除了 CHILD_POLICY_REPEAT ，指示新元素的子策略。
    
    异常
    
    IllegalArgumentException - 如果 parentName是 null ，或者不是此格式的合法元素名称。
    
    IllegalArgumentException - 如果 childPolicy不是预定义的常量之一。
  - addElement
```
protected void addElement(String elementName,
                          String parentName,
                          int minChildren,
                          int maxChildren)
```
    将新的元素类型添加到此元数据文档格式，子策略为 CHILD_POLICY_REPEAT 。
    
    参数
    
    elementName - 新元素的名称。
    
    parentName - 将作为新元素的父元素的元素的名称。
    
    minChildren - 节点的最 minChildren数。
    
    maxChildren - 节点的最大子节点数。
    
    异常
    
    IllegalArgumentException - 如果 parentName是 null ，或者不是此格式的合法元素名称。
    
    IllegalArgumentException - 如果 minChildren为负数或大于 maxChildren 。
  - addChildElement
```
protected void addChildElement(String elementName,
                               String parentName)
```
    将一个现有元素添加到给定父节点类型的合法子节点列表中。
    
    参数
    
    parentName - 将作为元素的新父元素的元素的名称。
    
    elementName - 要作为子级添加的元素的名称。
    
    异常
    
    IllegalArgumentException - 如果 elementName是 null ，或者不是此格式的合法元素名称。
    
    IllegalArgumentException - 如果 parentName是 null ，或者不是此格式的合法元素名称。
  - removeElement
```
protected void removeElement(String elementName)
```
    从格式中移除元素。如果没有给定名称的元素存在，则不会发生任何事情，也不会抛出异常。
    
    参数
    
    elementName - 要删除的元素的名称。
  - addAttribute
```
protected void addAttribute(String elementName,
                            String attrName,
                            int dataType,
                            boolean required,
                            String defaultValue)
```
    将新属性添加到可以设置为任意值的先前定义的元素。
    
    参数
    
    elementName - 元素的名称。
    
    attrName - 要添加的属性的名称。
    
    dataType -数据类型的属性（字符串格式），之一 DATATYPE_*常数。
    
    required - true如果属性必须存在。
    
    defaultValue - defaultValue的默认值，或 null 。
    
    异常
    
    IllegalArgumentException - 如果 elementName是 null ，或者不是此格式的法定元素名称。
    
    IllegalArgumentException - 如果 attrName是 null 。
    
    IllegalArgumentException - 如果 dataType不是预定义的常量之一。
  - addAttribute
```
protected void addAttribute(String elementName,
                            String attrName,
                            int dataType,
                            boolean required,
                            String defaultValue,
                            List<String> enumeratedValues)
```
    向先前定义的元素添加一个新属性，该元素将由一组枚举值定义。
    
    参数
    
    elementName - 元素的名称。
    
    attrName - 要添加的属性的名称。
    
    dataType -数据类型的属性（字符串格式），之一 DATATYPE_*常数。
    
    required - true如果属性必须存在。
    
    defaultValue - defaultValue的默认值，或 null 。
    
    enumeratedValues - a List的 String s包含属性的合法值。
    
    异常
    
    IllegalArgumentException - 如果 elementName是 null ，或者不是此格式的法定元素名称。
    
    IllegalArgumentException - 如果 attrName是 null 。
    
    IllegalArgumentException - 如果 dataType不是预定义的常量之一。
    
    IllegalArgumentException - 如果 enumeratedValues是 null 。
    
    IllegalArgumentException - 如果 enumeratedValues不包含至少一个条目。
    
    IllegalArgumentException - 如果 enumeratedValues包含不是 String或 null 。
  - addAttribute
```
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 - defaultValue的默认值，或 null 。
    
    minValue -最小（包括或不依赖于价值 minInclusive该属性）的法律价值，为 String 。
    
    maxValue - 最大（包括或排除取决于minInclusive的价值） minInclusive合法值，作为 String 。
    
    minInclusive - true如果 minValue是包含的。
    
    maxInclusive - true如果 maxValue是包含性的。
    
    异常
    
    IllegalArgumentException - 如果 elementName是 null ，或者不是此格式的合法元素名称。
    
    IllegalArgumentException - 如果 attrName是 null 。
    
    IllegalArgumentException - 如果 dataType不是预定义的常量之一。
  - addAttribute
```
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 。
  - addBooleanAttribute
```
protected void addBooleanAttribute(String elementName,
                                   String attrName,
                                   boolean hasDefaultValue,
                                   boolean defaultValue)
```
    向先前定义的元素添加一个新属性，该元素将由枚举值 TRUE和 FALSE ，数据类型为 DATATYPE_BOOLEAN 。
    
    参数
    
    elementName - 元素的名称。
    
    attrName - 要添加的属性的名称。
    
    hasDefaultValue - true如果应该存在默认值。
    
    defaultValue - defaultValue的默认值为 boolean ，如果 hasDefaultValue为 false忽略。
    
    异常
    
    IllegalArgumentException - 如果 elementName是 null ，或者不是此格式的合法元素名称。
    
    IllegalArgumentException - 如果 attrName是 null 。
  - removeAttribute
```
protected void removeAttribute(String elementName,
                               String attrName)
```
    从先前定义的元素中删除一个属性。如果给定元素中没有给定名称的属性，则不会发生任何事情，也不会抛出任何异常。
    
    参数
    
    elementName - 元素的名称。
    
    attrName - 要删除的属性的名称。
    
    异常
    
    IllegalArgumentException - 如果 elementName是 null ，或不是此格式的法定元素名称。
  - addObjectValue
```
protected <T> void addObjectValue(String elementName,
                                  类<T> classType,
                                  boolean required,
                                  T defaultValue)
```
    允许给定类类型的Object引用存储在实现命名元素的节点中。 Object的值不受其类型的约束。
    如果以前允许使用Object引用，则会覆盖以前的设置。
    
    参数类型
    
    T - 对象的类型。
    
    参数
    
    elementName - 元素的名称。
    
    classType - 一个 类变量，指示对象值的合法类类型。
    
    required - true如果一个对象值必须存在。
    
    defaultValue - 默认值为 Object引用，或 null 。
    
    异常
    
    IllegalArgumentException - 如果 elementName是 null ，或者不是此格式的合法元素名称。
  - addObjectValue
```
protected <T> void addObjectValue(String elementName,
                                  类<T> classType,
                                  boolean required,
                                  T defaultValue,
                                  List<? extends T> enumeratedValues)
```
    允许给定类类型的Object引用存储在实现命名元素的节点中。 Object的值必须是enumeratedValues给出的值enumeratedValues 。
    如果以前允许使用Object引用，则会覆盖以前的设置。
    
    参数类型
    
    T - 对象的类型。
    
    参数
    
    elementName - 元素的名称。
    
    classType - 一个 类变量，指示对象值的法定类类型。
    
    required - true如果一个对象值必须存在。
    
    defaultValue -为对默认值 Object参考，或 null 。
    
    enumeratedValues - 一个 List的 Object s包含对象引用的合法值。
    
    异常
    
    IllegalArgumentException - 如果 elementName是 null ，或者不是此格式的合法元素名称。
    
    IllegalArgumentException - 如果 enumeratedValues是 null 。
    
    IllegalArgumentException - 如果 enumeratedValues不包含至少一个条目。
    
    IllegalArgumentException - 如果 enumeratedValues包含不是由 classType表示的类类型的实例或 null 。
  - addObjectValue
```
protected <T extends Object & Comparable<? super T>> void addObjectValue(String elementName,
                                                                         类<T> classType,
                                                                         T defaultValue,
                                                                         Comparable<? super T> minValue,
                                                                         Comparable<? super T> maxValue,
                                                                         boolean minInclusive,
                                                                         boolean maxInclusive)
```
    允许给定类类型的Object引用存储在实现命名元素的节点中。 Object的值必须在minValue和maxValue给定的范围内。此外，类类型必须实现Comparable接口。
    如果以前允许使用Object引用，则覆盖以前的设置。
    
    参数类型
    
    T - 对象的类型。
    
    参数
    
    elementName - 元素的名称。
    
    classType - 一个 类变量，指示对象值的合法类类型。
    
    defaultValue - 的默认值
    
    minValue -最小（包括或不包括取决于的值 minInclusive为对象值）合法值，作为 String 。
    
    maxValue -最大的（包括或不依赖于价值 minInclusive ）法律为对象的值值，为 String 。
    
    minInclusive - true如果 minValue是包含的。
    
    maxInclusive - true如果 maxValue是包容。
    
    异常
    
    IllegalArgumentException - 如果 elementName是 null ，或者不是此格式的合法元素名称。
  - addObjectValue
```
protected void addObjectValue(String elementName,
                              类<?> classType,
                              int arrayMinLength,
                              int arrayMaxLength)
```
    允许给定类类型的Object引用存储在实现命名元素的节点中。 Object的值必须由classType给出的类数组，至少有arrayMinLength和最多arrayMaxLength元素。
    如果以前允许使用Object引用，则会覆盖以前的设置。
    
    参数
    
    elementName - 元素的名称。
    
    classType - 一个 类变量，指示对象值的合法类类型。
    
    arrayMinLength - 数组的最小合法长度。
    
    arrayMaxLength - 阵列最大合法长度。
    
    异常
    
    IllegalArgumentException - 如果 elementName不是此格式的合法元素名称。
  - removeObjectValue
```
protected void removeObjectValue(String elementName)
```
    禁止将 Object引用存储在实现命名元素的节点中。
    
    参数
    
    elementName - 元素的名称。
    
    异常
    
    IllegalArgumentException - 如果 elementName不是此格式的合法元素名称。
  - getRootName
```
public String getRootName()
```
    说明从界面： IIOMetadataFormat复制
    
    返回格式的根元素的名称。
    
    Specified by:
    
    getRootName在接口 IIOMetadataFormat
    
    结果
    
    一个 String 。
  - canNodeAppear
```
public abstract boolean canNodeAppear(String elementName,
                                      ImageTypeSpecifier imageType)
```
    说明从界面： IIOMetadataFormat复制
    
    返回true如果元素（及其下面的子树）被允许出现在由ImageTypeSpecifier定义的给定类型的图像的元数据文档中。例如，元数据文档格式可能包含描述图像基本颜色的元素，这在编写灰度图像时不允许。
    
    Specified by:
    
    canNodeAppear中的 IIOMetadataFormat
    
    参数
    
    elementName - 要查询的元素的名称。
    
    imageType - ImageTypeSpecifier将与元数据相关联的图像类型的ImageTypeSpecifier。
    
    结果
    
    true如果节点对于给定类型的图像是有意义的。
  - getElementMinChildren
```
public int getElementMinChildren(String elementName)
```
    描述从接口： IIOMetadataFormat复制
    
    返回具有子策略CHILD_POLICY_REPEAT的命名元素的最CHILD_POLICY_REPEAT 。例如，表示颜色主要信息的元素可能需要至少有3个孩子，每个小孩一个。
    
    Specified by:
    
    getElementMinChildren在界面 IIOMetadataFormat
    
    参数
    
    elementName - 要查询的元素的名称。
    
    结果
    
    一个 int 。
  - getElementMaxChildren
```
public int getElementMaxChildren(String elementName)
```
    说明从界面： IIOMetadataFormat复制
    
    返回具有子策略CHILD_POLICY_REPEAT的命名元素的最大子CHILD_POLICY_REPEAT 。例如，可以允许在8位调色板中表示条目的元素重复多达256次。可以使用值Integer.MAX_VALUE来指定没有上限。
    
    Specified by:
    
    getElementMaxChildren在接口 IIOMetadataFormat
    
    参数
    
    elementName - 要查询的元素的名称。
    
    结果
    
    一个 int 。
  - getElementDescription
```
public String getElementDescription(String elementName,
                                    Locale locale)
```
    返回一个String命名元素的描述的String，或null 。如果可能，说明将被本地化为提供的Locale 。
    默认的实现会首先找到一个ResourceBundle利用当前资源基本名称由设置setResourceBaseName和供应Locale ，使用中的注释中描述的应变机制ResourceBundle.getBundle 。如果找到一个ResourceBundle ，元素名称将被用作其getString方法的键，并返回结果。如果没有找到ResourceBundle ，或者没有这样的钥匙， null将被退回。
    
    如果locale是null ，则将使用由Locale.getLocale返回的当前默认值Locale 。
    
    Specified by:
    
    getElementDescription在接口 IIOMetadataFormat
    
    参数
    
    elementName - 元素的名称。
    
    locale - 将 Locale的Locale。
    
    结果
    
    元素描述。
    
    异常
    
    IllegalArgumentException - 如果 elementName是 null ，或者不是此格式的合法元素名称。
    
    另请参见：
    
    setResourceBaseName(java.lang.String)
  - getChildPolicy
```
public int getChildPolicy(String elementName)
```
    说明从界面： IIOMetadataFormat复制
    
    返回以CHILD_POLICY_开头的 CHILD_POLICY_ ，表示指定元素的子代码的合法模式。
    
    Specified by:
    
    getChildPolicy在界面 IIOMetadataFormat
    
    参数
    
    elementName - 要查询的元素的名称。
    
    结果
    
    其中一个 CHILD_POLICY_*常量。
  - getChildNames
```
public String[] getChildNames(String elementName)
```
    从接口复制： IIOMetadataFormat
    
    返回一个String s的数组，它们表示允许作为命名元素的子元素的元素的名称，按照它们应该出现的顺序。如果元素不能有子，则返回null 。
    
    Specified by:
    
    getChildNames在接口 IIOMetadataFormat
    
    参数
    
    elementName - 要查询的元素的名称。
    
    结果
    
    一个数组为 String s，或null。
  - getAttributeNames
```
public String[] getAttributeNames(String elementName)
```
    说明从界面复制： IIOMetadataFormat
    
    返回一个 String的数组，列出可能与命名元素相关联的属性的名称。
    
    Specified by:
    
    getAttributeNames在界面 IIOMetadataFormat
    
    参数
    
    elementName - 要查询的元素的名称。
    
    结果
    
    一个 String的阵列。
  - getAttributeValueType
```
public int getAttributeValueType(String elementName,
                                 String attrName)
```
    说明从界面复制： IIOMetadataFormat
    
    返回以VALUE_开头的 VALUE_ ，指示指定元素中给定属性的值是否是任意的，被限制在一个指定范围内，被限制为一组枚举值之一，或者是一个空格分隔的列表的任意值。
    
    Specified by:
    
    getAttributeValueType在接口 IIOMetadataFormat
    
    参数
    
    elementName - 要查询的元素的名称。
    
    attrName - 要查询的属性的名称。
    
    结果
    
    其中一个 VALUE_*常数。
  - getAttributeDataType
```
public int getAttributeDataType(String elementName,
                                String attrName)
```
    描述从接口： IIOMetadataFormat复制
    
    返回以DATATYPE_开头的DATATYPE_ ，表示指定元素中给定属性的值的格式和解释。如果getAttributeValueType返回VALUE_LIST ，则合法值是返回数据类型的值的空白列表。
    
    Specified by:
    
    getAttributeDataType在界面 IIOMetadataFormat
    
    参数
    
    elementName - 要查询的元素的名称。
    
    attrName - 要查询的属性的名称。
    
    结果
    
    其中一个 DATATYPE_*常量。
  - isAttributeRequired
```
public boolean isAttributeRequired(String elementName,
                                   String attrName)
```
    说明从界面： IIOMetadataFormat复制
    
    如果命名的属性必须在命名的元素中，则返回 true 。
    
    Specified by:
    
    isAttributeRequired在界面 IIOMetadataFormat
    
    参数
    
    elementName - 要查询的元素的名称。
    
    attrName - 要查询的属性的名称。
    
    结果
    
    true如果属性必须存在。
  - getAttributeDefaultValue
```
public String getAttributeDefaultValue(String elementName,
                                       String attrName)
```
    说明从界面复制： IIOMetadataFormat
    
    返回指定属性的默认值，如果没有明确指定元素中存在，为 String ，或 null如果没有默认值是可用的。
    
    Specified by:
    
    getAttributeDefaultValue在界面 IIOMetadataFormat
    
    参数
    
    elementName - 要查询的元素的名称。
    
    attrName - 要查询的属性的名称。
    
    结果
    
    一个 String包含默认值，或 null 。
  - getAttributeEnumerations
```
public String[] getAttributeEnumerations(String elementName,
                                         String attrName)
```
    说明从界面复制： IIOMetadataFormat
    
    返回一个包含指定元素中给定属性的合法枚举值的数组String 。只有当getAttributeValueType返回VALUE_ENUMERATION时，才应该调用此方法。
    
    Specified by:
    
    getAttributeEnumerations在界面 IIOMetadataFormat
    
    参数
    
    elementName - 要查询的元素的名称。
    
    attrName - 要查询的属性的名称。
    
    结果
    
    一组 String s。
  - getAttributeMinValue
```
public String getAttributeMinValue(String elementName,
                                   String attrName)
```
    说明从界面： IIOMetadataFormat复制
    
    返回属性的最小合法值。该值是否包含或排除可以由getAttributeValueType的值getAttributeValueType 。该值返回为String ; 其解释是依赖于价值getAttributeDataType 。只有当getAttributeValueType返回VALUE_RANGE_*时，才应该调用此方法。
    
    Specified by:
    
    getAttributeMinValue在界面 IIOMetadataFormat
    
    参数
    
    elementName - 要查询的元素的名称。
    
    attrName - 要查询的属性的名称。
    
    结果
    
    一个 String包含该属性的最小合法值。
  - getAttributeMaxValue
```
public String getAttributeMaxValue(String elementName,
                                   String attrName)
```
    从接口复制： IIOMetadataFormat
    
    返回属性的最大合法值。该值是否包含或排除可以由getAttributeValueType的值getAttributeValueType 。该值返回为String ; 其解释是依赖于价值getAttributeDataType 。只有当getAttributeValueType返回VALUE_RANGE_*时，才应该调用此方法。
    
    Specified by:
    
    getAttributeMaxValue在接口 IIOMetadataFormat
    
    参数
    
    elementName - 要查询的元素的名称，作为 String 。
    
    attrName - 要查询的属性的名称。
    
    结果
    
    一个 String包含该属性的最大合法值。
  - getAttributeListMinLength
```
public int getAttributeListMinLength(String elementName,
                                     String attrName)
```
    说明从界面复制： IIOMetadataFormat
    
    返回可用于定义此属性的列表项的最小数量。该属性本身被定义为String包含多个空格分开的项目。如果getAttributeValueType返回VALUE_LIST则该方法应该被调用。
    
    Specified by:
    
    getAttributeListMinLength在界面 IIOMetadataFormat
    
    参数
    
    elementName - 要查询的元素的名称。
    
    attrName - 要查询的属性的名称。
    
    结果
    
    属性的列表项的最小合法数量。
  - getAttributeListMaxLength
```
public int getAttributeListMaxLength(String elementName,
                                     String attrName)
```
    从接口复制： IIOMetadataFormat
    
    返回可用于定义此属性的列表项的最大数量。可以使用值Integer.MAX_VALUE来指定没有上限。该属性本身被定义为String包含多个空格分开的项目。只有当getAttributeValueType返回VALUE_LIST时，才应该调用此方法。
    
    Specified by:
    
    getAttributeListMaxLength在界面 IIOMetadataFormat
    
    参数
    
    elementName - 被查询的元素的名称。
    
    attrName - 要查询的属性的名称。
    
    结果
    
    属性的列表项的最大合法数量。
  - getAttributeDescription
```
public String getAttributeDescription(String elementName,
                                      String attrName,
                                      Locale locale)
```
    返回一个String命名属性描述的String，或null 。如果可能，说明将被本地化为提供的Locale 。
    默认的实现会首先找到一个ResourceBundle利用当前资源基本名称由设置setResourceBaseName和供应Locale ，使用中的注释中描述的应变机制ResourceBundle.getBundle 。如果找到了一个ResourceBundle ，那么元素名称后跟一个“/”字符后跟属性名称（ elementName + "/" + attrName ）将被用作其getString方法的键，并返回结果。如果没有找到ResourceBundle ，或者没有这样的钥匙， null将被退回。
    
    如果locale是null ，当前的默认Locale由归国Locale.getLocale将被使用。
    
    Specified by:
    
    getAttributeDescription中的 IIOMetadataFormat
    
    参数
    
    elementName - 元素的名称。
    
    attrName - 属性的名称。
    
    locale - 将 Locale的Locale，或 null 。
    
    结果
    
    属性描述。
    
    异常
    
    IllegalArgumentException - 如果 elementName是 null ，或者不是此格式的合法元素名称。
    
    IllegalArgumentException - 如果 attrName是 null或不是此元素的合法属性名称。
    
    另请参见：
    
    setResourceBaseName(java.lang.String)
  - getObjectValueType
```
public int getObjectValueType(String elementName)
```
    说明从界面： IIOMetadataFormat复制
    
    返回以所列举的值中的一个VALUE_ ，指示所允许的值（枚举，范围或阵列）的种类Object参考。如果给定元素中没有存储对象值，则该方法的结果将为VALUE_NONE 。
    Object引用的法定值定义为范围必须实现Comparable接口。
    
    Specified by:
    
    getObjectValueType在接口 IIOMetadataFormat
    
    参数
    
    elementName - 要查询的元素的名称。
    
    结果
    
    其中一个 VALUE_*常数。
    
    另请参见：
    
    Comparable
  - getObjectClass
```
public 类<?> getObjectClass(String elementName)
```
    从接口复制： IIOMetadataFormat
    
    返回存储在元素中的Object 类类型。如果此元素可能不包含Object引用，则将抛出IllegalArgumentException 。如果类类型是一个数组，则此字段指示底层类型（例如，对于int的数组，此方法将返回int.class ）。
    Object引用的法定值定义为范围必须实现Comparable接口。
    
    Specified by:
    
    getObjectClass在接口 IIOMetadataFormat
    
    参数
    
    elementName - 要查询的元素的名称。
    
    结果
    
    一个 类对象。
  - getObjectDefaultValue
```
public Object getObjectDefaultValue(String elementName)
```
    说明从界面： IIOMetadataFormat复制
    
    返回一个 Object ，其中 Object命名元素中的 Object引用的默认值。
    
    Specified by:
    
    getObjectDefaultValue在接口 IIOMetadataFormat
    
    参数
    
    elementName - 要查询的元素的名称。
    
    结果
    
    一个 Object 。
  - getObjectEnumerations
```
public Object[] getObjectEnumerations(String elementName)
```
    说明从界面复制： IIOMetadataFormat
    
    返回一个包含指定元素中Object引用的合法枚举值的Object Object。只有当getObjectValueType返回VALUE_ENUMERATION时，才应该调用此方法。
    的Object与接受枚举值必须等于由该方法返回的值中的一个，如由所定义的节点相关联==操作者（相对于所述Object.equals方法）。
    
    Specified by:
    
    getObjectEnumerations在界面 IIOMetadataFormat
    
    参数
    
    elementName - 要查询的元素的名称。
    
    结果
    
    一组 Object s。
  - getObjectMinValue
```
public Comparable<?> getObjectMinValue(String elementName)
```
    说明从界面： IIOMetadataFormat复制
    
    返回指定元素中Object引用的最小合法值。该值是否包含或排除可以由getObjectValueType的值getObjectValueType 。只有当getObjectValueType返回以VALUE_RANGE开头的VALUE_RANGE之一时，才应该调用此方法。
    
    Specified by:
    
    getObjectMinValue在接口 IIOMetadataFormat
    
    参数
    
    elementName - 要查询的元素的名称。
    
    结果
    
    该属性的最小合法值。
  - getObjectMaxValue
```
public Comparable<?> getObjectMaxValue(String elementName)
```
    从接口复制： IIOMetadataFormat
    
    返回指定元素中Object引用的最大合法值。该值是否包含或排除可以由getObjectValueType的值getObjectValueType 。只有当getObjectValueType返回以VALUE_RANGE开头的VALUE_RANGE之一时，才应该调用此方法。
    
    Specified by:
    
    getObjectMaxValue在界面 IIOMetadataFormat
    
    参数
    
    elementName - 要查询的元素的名称。
    
    结果
    
    该属性的最小合法值。
  - getObjectArrayMinLength
```
public int getObjectArrayMinLength(String elementName)
```
    说明从界面复制： IIOMetadataFormat
    
    返回可用于定义指定元素中Object引用的最小数组元素数。只有当getObjectValueType返回VALUE_LIST时，才应该调用此方法。
    
    Specified by:
    
    getObjectArrayMinLength在接口 IIOMetadataFormat
    
    参数
    
    elementName - 要查询的元素的名称。
    
    结果
    
    Object参考的最小有效数组长度。
  - getObjectArrayMaxLength
```
public int getObjectArrayMaxLength(String elementName)
```
    从接口复制： IIOMetadataFormat
    
    返回可用于定义指定元素中的Object引用的最大数组元素数。可以使用值Integer.MAX_VALUE来指定没有上限。只有当getObjectValueType返回VALUE_LIST时，才应该调用此方法。
    
    Specified by:
    
    getObjectArrayMaxLength在界面 IIOMetadataFormat
    
    参数
    
    elementName - 要查询的元素的名称。
    
    结果
    
    Object参考的最大有效数组长度。
  - getStandardFormatInstance
```
public static IIOMetadataFormat getStandardFormatInstance()
```
    返回一个 IIOMetadataFormat对象，描述了 javax.imageio.metadata包的注释中描述的标准，插件中性 javax.imageio_1.0元数据文档格式。
    
    结果
    
    一个预定 IIOMetadataFormat实例。

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class IIOMetadataFormatImpl

Field Summary

Fields inherited from interface javax.imageio.metadata.IIOMetadataFormat

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

字段详细信息

standardMetadataFormatName

构造方法详细信息

IIOMetadataFormatImpl

IIOMetadataFormatImpl

方法详细信息

setResourceBaseName

getResourceBaseName

addElement

addElement

addChildElement

removeElement

addAttribute

addAttribute

addAttribute

addAttribute

addBooleanAttribute

removeAttribute

addObjectValue

addObjectValue

addObjectValue

addObjectValue

removeObjectValue

getRootName

canNodeAppear

getElementMinChildren

getElementMaxChildren

getElementDescription

getChildPolicy

getChildNames

getAttributeNames

getAttributeValueType

getAttributeDataType

isAttributeRequired

getAttributeDefaultValue

getAttributeEnumerations

getAttributeMinValue

getAttributeMaxValue

getAttributeListMinLength

getAttributeListMaxLength

getAttributeDescription

getObjectValueType

getObjectClass

getObjectDefaultValue

getObjectEnumerations

getObjectMinValue

getObjectMaxValue

getObjectArrayMinLength

getObjectArrayMaxLength

getStandardFormatInstance