モジュール java.desktop
パッケージ javax.imageio.metadata

クラスIIOMetadataFormatImpl

  • すべての実装されたインタフェース:
    IIOMetadataFormat


    public abstract class IIOMetadataFormatImpl
    extends Object
    implements IIOMetadataFormat
    IIOMetadataFormatインタフェースの再使用可能な実装を提供する具象クラスです。 さらに、標準の、プラグインに依存しないjavax_imageio_1.0形式を表す静的インスタンスがgetStandardFormatInstanceメソッドにより提供されます。

    ローカライズされた要素と属性の説明を提供するためには、this.getClass().getName()+"Resources"のベース名を持つResourceBundleを、ResourceBundle.getBundleで使用される通常のメカニズムを介して提供する必要があります。 つまり、サブクラサーは命名規則に従って1つまたは複数の追加クラスを提供します(デフォルトでは、IIMetadataFormatImpl、文字列"Resources"、国、言語、およびバリアントのアンダースコアで区切られたコードを拡張するサブクラスの完全指定名)。 実行時には、getElementDescriptionまたはgetAttributeDescriptionの呼出しによって、指定されたロケールに従ってこのようなクラスの動的なロードが試行され、要素名、またはあとに「/」文字と属性名が続く要素名がキーとして使用されます。 このキーはResourceBundlegetStringメソッドに提供され、ローカライズされたノードまたは属性の説明が返されます。

    サブクラスは、setResourceBaseNameメソッドを使用してリソース・バンドルの異なるベース名を提供できます。

    必要に応じて、サブクラスは、getElementDescriptionおよびgetAttributeDescriptionの提供された実装をオーバーライドして、独自のローカリゼーション・メカニズムを選択できます。

    関連項目:
    ResourceBundle.getBundle(String,Locale)
    • コンストラクタのサマリー

      コンストラクタ 
      コンストラクタ 説明
      IIOMetadataFormatImpl​(String rootName, int childPolicy)
      指定されたルート要素名と子ポリシー(CHILD_POLICY_REPEAT以外)を使用して、空白のIIOMetadataFormatImplインスタンスを構築します。
      IIOMetadataFormatImpl​(String rootName, int minChildren, int maxChildren)
      指定されたルート要素名とCHILD_POLICY_REPEATの子ポリシーを使用して、空白のIIOMetadataFormatImplインスタンスを構築します。
    • メソッドのサマリー

      すべてのメソッド staticメソッド インスタンス・メソッド 抽象メソッド 具象メソッド 
      修飾子と型 メソッド 説明
      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, String minValue, String maxValue, boolean minInclusive, boolean maxInclusive)
      新しい属性を、値の範囲で定義される事前に定義された要素に追加します。
      protected void addAttribute​(String elementName, String attrName, int dataType, boolean required, String defaultValue, List<String> enumeratedValues)
      新しい属性を、列挙値のセットで定義される事前に定義された要素に追加します。
      protected void addBooleanAttribute​(String elementName, String attrName, boolean hasDefaultValue, boolean defaultValue)
      新しい属性を、DATATYPE_BOOLEANのデータ型で、列挙値TRUEおよびFALSEで定義される事前に定義された要素に追加します。
      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 <T> void addObjectValue​(String elementName, Class<T> classType, boolean required, T defaultValue)
      指定されたクラス型のObject参照を、名前付き要素を実装するノードに格納できるようにします。
      protected <T> void addObjectValue​(String elementName, Class<T> classType, boolean required, T defaultValue, List<? extends T> enumeratedValues)
      指定されたクラス型のObject参照を、名前付き要素を実装するノードに格納できるようにします。
      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参照を、名前付き要素を実装するノードに格納できるようにします。
      abstract boolean canNodeAppear​(String elementName, ImageTypeSpecifier imageType)
      要素とその下のサブツリーを、ImageTypeSpecifierで定義された、指定されたタイプのイメージのメタデータ・ドキュメントに表示できる場合は、trueを返します。
      int getAttributeDataType​(String elementName, String attrName)
      名前付き要素内の指定された属性の値の形式と解釈を示すDATATYPE_で始まる定数の1つを返します。
      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_で始まる定数の1つを返し、名前付き要素内の指定された属性の値が任意であるか、指定された範囲内に限定されるか、一連の列挙値の1つに限定されるか、または空白で区切られた任意の値のリストであるかどうかを示します。
      String[] getChildNames​(String elementName)
      名前付き要素の子になることができる要素の名前を示すStringの配列を出現順に返します。
      int getChildPolicy​(String elementName)
      名前付き要素の子の有効なパターンを示す、CHILD_POLICY_で始まる定数の1つを返します。
      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)
      要素内に格納されたObject参照のClass型を返します。
      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)
      Object参照に使用できる値(列挙、範囲、または配列)の型を示すVALUE_で始まる列挙値の1つを返します。
      protected String getResourceBaseName​()
      ResourceBundleを検索するための、現在設定されているベース名を返します。
      String getRootName​()
      形式のルート要素の名前を返します。
      static IIOMetadataFormat getStandardFormatInstance​()
      javax.imageio.metadataパッケージのコメントに記述されている、標準の、プラグインに依存しないjavax.imageio_1.0メタデータ・ドキュメント形式を記述するIIOMetadataFormatオブジェクトを返します。
      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を検索するための新しいベース名を設定します。
    • フィールドの詳細

      • standardMetadataFormatName

        public static final String standardMetadataFormatName
        標準の形式名"javax_imageio_1.0"が格納されているString定数。
        関連項目:
        定数フィールド値
    • コンストラクタの詳細

      • IIOMetadataFormatImpl

        public IIOMetadataFormatImpl​(String rootName,
                                     int childPolicy)
        指定されたルート要素名と子ポリシー(CHILD_POLICY_REPEAT以外)を使用して、空白のIIOMetadataFormatImplインスタンスを構築します。 追加要素と、その属性およびObject参照情報は、各種のaddメソッドを使用して追加できます。
        パラメータ:
        rootName - ルート要素の名前。
        childPolicy - CHILD_POLICY_REPEAT以外の、CHILD_POLICY_*定数の1つ。
        例外:
        IllegalArgumentException - rootNamenullの場合。
        IllegalArgumentException - childPolicyが事前に定義された定数の1つでない場合。
      • IIOMetadataFormatImpl

        public IIOMetadataFormatImpl​(String rootName,
                                     int minChildren,
                                     int maxChildren)
        指定されたルート要素名とCHILD_POLICY_REPEATの子ポリシーを使用して、空白のIIOMetadataFormatImplインスタンスを構築します。 追加要素と、その属性およびObject参照情報は、各種のaddメソッドを使用して追加できます。
        パラメータ:
        rootName - ルート要素の名前。
        minChildren - ノードの子の最小数。
        maxChildren - ノードの子の最大数。
        例外:
        IllegalArgumentException - rootNamenullの場合。
        IllegalArgumentException - minChildrenが負の値の場合、またはmaxChildrenより大きい場合。
    • メソッドの詳細

      • setResourceBaseName

        protected void setResourceBaseName​(String resourceBaseName)
        この形式の要素と属性の説明が格納されているResourceBundleを検索するための新しいベース名を設定します。

        最初にこのメソッドを呼び出すまでは、ベース名はthis.getClass().getName()+"Resources"に等しくなっています。

        パラメータ:
        resourceBaseName - 新しいベース名が格納されているString
        例外:
        IllegalArgumentException - resourceBaseNamenullの場合。
        関連項目:
        getResourceBaseName()
      • getResourceBaseName

        protected String getResourceBaseName​()
        ResourceBundleを検索するための、現在設定されているベース名を返します。
        戻り値:
        ベース名が格納されているString
        関連項目:
        setResourceBaseName(java.lang.String)
      • addElement

        protected void addElement​(String elementName,
                                  String parentName,
                                  int childPolicy)
        CHILD_POLICY_REPEAT以外の子ポリシーを持つこのメタデータ・ドキュメント形式に新しい要素型を追加します。
        パラメータ:
        elementName - 新しい要素の名前。
        parentName - 新しい要素の親になる要素の名前。
        childPolicy - 新しい要素の子ポリシーを示す、CHILD_POLICY_REPEAT以外のCHILD_POLICY_*定数の1つ。
        例外:
        IllegalArgumentException - parentNamenullの場合、またはこの形式の有効な要素名でない場合。
        IllegalArgumentException - childPolicyが事前に定義された定数の1つでない場合。
      • addElement

        protected void addElement​(String elementName,
                                  String parentName,
                                  int minChildren,
                                  int maxChildren)
        CHILD_POLICY_REPEATの子ポリシーを持つこのメタデータ・ドキュメント形式に新しい要素型を追加します。
        パラメータ:
        elementName - 新しい要素の名前。
        parentName - 新しい要素の親になる要素の名前。
        minChildren - ノードの子の最小数。
        maxChildren - ノードの子の最大数。
        例外:
        IllegalArgumentException - parentNamenullの場合、またはこの形式の有効な要素名でない場合。
        IllegalArgumentException - minChildrenが負の値の場合、またはmaxChildrenより大きい場合。
      • addChildElement

        protected void addChildElement​(String elementName,
                                       String parentName)
        既存の要素を、指定された親ノードの型の有効な子のリストに追加します。
        パラメータ:
        parentName - 要素の新しい親になる要素の名前。
        elementName - 子として追加される要素の名前。
        例外:
        IllegalArgumentException - elementNamenullの場合、またはこの形式の有効な要素名でない場合。
        IllegalArgumentException - parentNamenullの場合、またはこの形式の有効な要素名でない場合。
      • 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_*定数の1つ。
        required - 属性が存在する必要がある場合はtrue
        defaultValue - 属性のデフォルト値、またはnull
        例外:
        IllegalArgumentException - elementNamenullの場合、またはこの形式の有効な要素名でない場合。
        IllegalArgumentException - attrNamenullの場合。
        IllegalArgumentException - dataTypeが事前に定義された定数の1つでない場合。
      • addAttribute

        protected void addAttribute​(String elementName,
                                    String attrName,
                                    int dataType,
                                    boolean required,
                                    String defaultValue,
                                    List<String> enumeratedValues)
        新しい属性を、列挙値のセットで定義される事前に定義された要素に追加します。
        パラメータ:
        elementName - 要素の名前。
        attrName - 追加される属性の名前。
        dataType - 属性のデータ型(文字列形式)で、DATATYPE_*定数の1つ。
        required - 属性が存在する必要がある場合はtrue
        defaultValue - 属性のデフォルト値、またはnull
        enumeratedValues - 属性の有効な値が格納されているStringList
        例外:
        IllegalArgumentException - elementNamenullの場合、またはこの形式の有効な要素名でない場合。
        IllegalArgumentException - attrNamenullの場合。
        IllegalArgumentException - dataTypeが事前に定義された定数の1つでない場合。
        IllegalArgumentException - enumeratedValuesnullの場合。
        IllegalArgumentException - enumeratedValuesにエントリが1つも格納されていない場合。
        IllegalArgumentException - enumeratedValuesStringでない要素、または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_*定数の1つ。
        required - 属性が存在する必要がある場合はtrue
        defaultValue - 属性のデフォルト値、またはnull
        minValue - Stringとしての、属性の最小(この値を含むか含まないかはminInclusiveの値によって決まります)の有効な値。
        maxValue - Stringとしての、属性の最大(この値を含むか含まないかはminInclusiveの値によって決まります)の有効な値。
        minInclusive - minValueが範囲に含まれる場合はtrue
        maxInclusive - maxValueが範囲に含まれる場合はtrue
        例外:
        IllegalArgumentException - elementNamenullの場合、またはこの形式の有効な要素名でない場合。
        IllegalArgumentException - attrNamenullの場合。
        IllegalArgumentException - dataTypeが事前に定義された定数の1つでない場合。
      • addAttribute

        protected void addAttribute​(String elementName,
                                    String attrName,
                                    int dataType,
                                    boolean required,
                                    int listMinLength,
                                    int listMaxLength)
        新しい属性を、値のリストで定義される事前に定義された要素に追加します。
        パラメータ:
        elementName - 要素の名前。
        attrName - 追加される属性の名前。
        dataType - 属性のデータ型(文字列形式)で、DATATYPE_*定数の1つ。
        required - 属性が存在する必要がある場合はtrue
        listMinLength - リスト項目の有効な最小数。
        listMaxLength - リスト項目の有効な最大数。
        例外:
        IllegalArgumentException - elementNamenullの場合、またはこの形式の有効な要素名でない場合。
        IllegalArgumentException - attrNamenullの場合。
        IllegalArgumentException - dataTypeが事前に定義された定数の1つでない場合。
        IllegalArgumentException - listMinLengthが負の値の場合、またはlistMaxLengthより大きい場合。
      • addBooleanAttribute

        protected void addBooleanAttribute​(String elementName,
                                           String attrName,
                                           boolean hasDefaultValue,
                                           boolean defaultValue)
        新しい属性を、DATATYPE_BOOLEANのデータ型で、列挙値TRUEおよびFALSEで定義される事前に定義された要素に追加します。
        パラメータ:
        elementName - 要素の名前。
        attrName - 追加される属性の名前。
        hasDefaultValue - デフォルト値が存在する必要がある場合はtrue
        defaultValue - booleanとしての属性のデフォルト値。hasDefaultValuefalseの場合は無視される。
        例外:
        IllegalArgumentException - elementNamenullの場合、またはこの形式の有効な要素名でない場合。
        IllegalArgumentException - attrNamenullの場合。
      • removeAttribute

        protected void removeAttribute​(String elementName,
                                       String attrName)
        事前に定義された要素から属性を削除します。 指定された名前を持つ属性が指定された要素内に存在しなかった場合は、何も実行されず、例外はスローされません。
        パラメータ:
        elementName - 要素の名前。
        attrName - 削除される属性の名前。
        例外:
        IllegalArgumentException - elementNamenullの場合、またはこの形式の有効な要素名でない場合。
      • addObjectValue

        protected <T> void addObjectValue​(String elementName,
                                          Class<T> classType,
                                          boolean required,
                                          T defaultValue)
        指定されたクラス型のObject参照を、名前付き要素を実装するノードに格納できるようにします。 Objectの値は、そのクラス型による以外には制限されません。

        Object参照が以前に許可された場合、以前の設定値は上書きされます。

        型パラメータ:
        T - オブジェクトの型。
        パラメータ:
        elementName - 要素の名前。
        classType - オブジェクト値の有効なクラス型を示すClass変数。
        required - オブジェクト値が存在する必要がある場合はtrue
        defaultValue - Object参照のデフォルト値、またはnull
        例外:
        IllegalArgumentException - elementNamenullの場合、またはこの形式の有効な要素名でない場合。
      • addObjectValue

        protected <T> void addObjectValue​(String elementName,
                                          Class<T> classType,
                                          boolean required,
                                          T defaultValue,
                                          List<? extends T> enumeratedValues)
        指定されたクラス型のObject参照を、名前付き要素を実装するノードに格納できるようにします。 Objectの値は、enumeratedValuesで指定された値の1つである必要があります。

        Object参照が以前に許可された場合、以前の設定値は上書きされます。

        型パラメータ:
        T - オブジェクトの型。
        パラメータ:
        elementName - 要素の名前。
        classType - オブジェクト値の有効なクラス型を示すClass変数。
        required - オブジェクト値が存在する必要がある場合はtrue
        defaultValue - Object参照のデフォルト値、またはnull
        enumeratedValues - オブジェクト参照の有効な値が格納されているObjectList
        例外:
        IllegalArgumentException - elementNamenullの場合、またはこの形式の有効な要素名でない場合。
        IllegalArgumentException - enumeratedValuesnullの場合。
        IllegalArgumentException - enumeratedValuesにエントリが1つも格納されていない場合。
        IllegalArgumentException - enumeratedValuesclassTypeによって示されるクラス型のインスタンスでない要素を格納しているか、またはnullの場合。
      • addObjectValue

        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参照が以前に許可された場合、以前の設定値は上書きされます。

        型パラメータ:
        T - オブジェクトの型。
        パラメータ:
        elementName - 要素の名前。
        classType - オブジェクト値の有効なクラス型を示すClass変数。
        defaultValue - 次のデフォルト値:
        minValue - Stringとしての、オブジェクト値の最小(この値を含むか含まないかはminInclusiveの値によって決まります)の有効な値。
        maxValue - Stringとしての、オブジェクト値の最大(この値を含むか含まないかはminInclusiveの値によって決まります)の有効な値。
        minInclusive - minValueが範囲に含まれる場合はtrue
        maxInclusive - maxValueが範囲に含まれる場合はtrue
        例外:
        IllegalArgumentException - elementNamenullの場合、またはこの形式の有効な要素名でない場合。
      • addObjectValue

        protected void addObjectValue​(String elementName,
                                      Class<?> classType,
                                      int arrayMinLength,
                                      int arrayMaxLength)
        指定されたクラス型のObject参照を、名前付き要素を実装するノードに格納できるようにします。 Objectの値は、少なくともarrayMinLengthの要素、最大でarrayMaxLengthの要素を持つ、classTypeで指定されたクラス型のオブジェクトの配列である必要があります。

        Object参照が以前に許可された場合、以前の設定値は上書きされます。

        パラメータ:
        elementName - 要素の名前。
        classType - オブジェクト値の有効なクラス型を示すClass変数。
        arrayMinLength - 配列の最小の有効な長さ。
        arrayMaxLength - 配列の最大の有効な長さ。
        例外:
        IllegalArgumentException - elementNameがこの形式の有効な要素名でない場合。
      • removeObjectValue

        protected void removeObjectValue​(String elementName)
        Object参照を、名前付き要素を実装するノードに格納できないようにします。
        パラメータ:
        elementName - 要素の名前。
        例外:
        IllegalArgumentException - elementNameがこの形式の有効な要素名でない場合。
      • canNodeAppear

        public abstract boolean canNodeAppear​(String elementName,
                                              ImageTypeSpecifier imageType)
        インタフェースからコピーされた説明: IIOMetadataFormat
        要素とその下のサブツリーを、ImageTypeSpecifierで定義された、指定されたタイプのイメージのメタデータ・ドキュメントに表示できる場合は、trueを返します。 たとえば、メタデータ・ドキュメント形式にはイメージの一次色を記述する要素が格納される場合がありますが、グレー・スケール・イメージを記述する場合には使用できません。
        定義:
        canNodeAppear、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 照会される要素の名前。
        imageType - メタデータと関連するイメージのタイプを示すImageTypeSpecifier
        戻り値:
        指定されたタイプのイメージに対してノードが有効な場合はtrue
      • getElementMinChildren

        public int getElementMinChildren​(String elementName)
        インタフェースからコピーされた説明: IIOMetadataFormat
        子ポリシーCHILD_POLICY_REPEATを持つ名前付き要素の子の最小数を返します。 たとえば、色の一次情報を表す要素には、各一次色に1つ、少なくとも3つの子が必要になる場合があります。
        定義:
        getElementMinChildren、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 照会される要素の名前。
        戻り値:
        int
      • getElementMaxChildren

        public int getElementMaxChildren​(String elementName)
        インタフェースからコピーされた説明: IIOMetadataFormat
        子ポリシーCHILD_POLICY_REPEATを持つ名前付き要素の子の最大数を返します。 たとえば、8ビットのカラー・パレット内のエントリを表す要素は256回まで反復できる場合があります。 Integer.MAX_VALUEの値を使用して、上限なしを指定することができます。
        定義:
        getElementMaxChildren、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 照会される要素の名前。
        戻り値:
        int
      • getElementDescription

        public String getElementDescription​(String elementName,
                                            Locale locale)
        名前付き要素の説明を格納したString、またはnullを返します。 説明は、可能であれば、指定されたLocaleにローカライズされます。

        デフォルトの実装では、まずsetResourceBaseNameで設定された現在のリソースのベース名を使用してResourceBundleを検索し、ResourceBundle.getBundleのコメントに記述された代替メカニズムを使用して、指定されたLocaleを検索します。 ResourceBundleが見つかった場合は、要素名がそのgetStringメソッドのキーとして使用され、結果が返されます。 ResourceBundleが見つからないか、そのようなキーが存在しない場合は、nullが返されます。

        localenullの場合、Locale.getLocaleによって返された現在のデフォルトLocaleが使用されます。

        定義:
        getElementDescription、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 要素の名前。
        locale - ローカリゼーションを試みる対象となるLocale
        戻り値:
        要素の説明。
        例外:
        IllegalArgumentException - elementNamenullの場合、またはこの形式の有効な要素名でない場合。
        関連項目:
        setResourceBaseName(java.lang.String)
      • getChildPolicy

        public int getChildPolicy​(String elementName)
        インタフェースからコピーされた説明: IIOMetadataFormat
        名前付き要素の子の有効なパターンを示す、CHILD_POLICY_で始まる定数の1つを返します。
        定義:
        getChildPolicy、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 照会される要素の名前。
        戻り値:
        CHILD_POLICY_*定数の1つ。
      • getChildNames

        public String[] getChildNames​(String elementName)
        インタフェースからコピーされた説明: IIOMetadataFormat
        名前付き要素の子になることができる要素の名前を示すStringの配列を出現順に返します。 要素が子を持つことができない場合は、nullが返されます。
        定義:
        getChildNames、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 照会される要素の名前。
        戻り値:
        Stringの配列、またはnull。
      • getAttributeNames

        public String[] getAttributeNames​(String elementName)
        インタフェースからコピーされた説明: IIOMetadataFormat
        名前付き要素に関連付けることができる属性の名前をリスト表示するStringの配列を返します。
        定義:
        getAttributeNames、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 照会される要素の名前。
        戻り値:
        Stringの配列。
      • getAttributeValueType

        public int getAttributeValueType​(String elementName,
                                         String attrName)
        インタフェースからコピーされた説明: IIOMetadataFormat
        VALUE_で始まる定数の1つを返し、名前付き要素内の指定された属性の値が任意であるか、指定された範囲内に限定されるか、一連の列挙値の1つに限定されるか、または空白で区切られた任意の値のリストであるかどうかを示します。
        定義:
        getAttributeValueType、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 照会される要素の名前。
        attrName - 照会される属性の名前。
        戻り値:
        VALUE_*定数の1つ。
      • getAttributeDataType

        public int getAttributeDataType​(String elementName,
                                        String attrName)
        インタフェースからコピーされた説明: IIOMetadataFormat
        名前付き要素内の指定された属性の値の形式と解釈を示すDATATYPE_で始まる定数の1つを返します。 getAttributeValueTypeVALUE_LISTを返す場合、有効な値は、返されるデータ型の値の空白で区切られたリストです。
        定義:
        getAttributeDataType、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 照会される要素の名前。
        attrName - 照会される属性の名前。
        戻り値:
        DATATYPE_*定数の1つ。
      • isAttributeRequired

        public boolean isAttributeRequired​(String elementName,
                                           String attrName)
        インタフェースからコピーされた説明: IIOMetadataFormat
        名前付き属性が名前付き要素内に存在する必要がある場合にtrueを返します。
        定義:
        isAttributeRequired、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 照会される要素の名前。
        attrName - 照会される属性の名前。
        戻り値:
        属性が存在する必要がある場合はtrue
      • getAttributeDefaultValue

        public String getAttributeDefaultValue​(String elementName,
                                               String attrName)
        インタフェースからコピーされた説明: IIOMetadataFormat
        名前付き属性が名前付き要素内に明示的に存在しない場合は、名前付き属性のデフォルト値をStringとして返します。デフォルト値が利用できない場合はnullを返します。
        定義:
        getAttributeDefaultValue、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 照会される要素の名前。
        attrName - 照会される属性の名前。
        戻り値:
        デフォルト値が格納されているString、またはnull
      • getAttributeEnumerations

        public String[] getAttributeEnumerations​(String elementName,
                                                 String attrName)
        インタフェースからコピーされた説明: IIOMetadataFormat
        名前付き要素内の指定された属性の有効な列挙値が格納されているStringの配列を返します。 このメソッドは、getAttributeValueTypeVALUE_ENUMERATIONを返す場合にだけ呼び出します。
        定義:
        getAttributeEnumerations、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 照会される要素の名前。
        attrName - 照会される属性の名前。
        戻り値:
        Stringの配列。
      • getAttributeMinValue

        public String getAttributeMinValue​(String elementName,
                                           String attrName)
        インタフェースからコピーされた説明: IIOMetadataFormat
        属性の有効な最小値を返します。 この値を含むか含まないかは、getAttributeValueTypeの値で判定することができます。 値はStringとして返されます。その解釈はgetAttributeDataTypeの値により異なります。 このメソッドは、getAttributeValueTypeVALUE_RANGE_*を返す場合にだけ呼び出します。
        定義:
        getAttributeMinValue、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 照会される要素の名前。
        attrName - 照会される属性の名前。
        戻り値:
        属性の有効な最小値が格納されているString
      • getAttributeMaxValue

        public String getAttributeMaxValue​(String elementName,
                                           String attrName)
        インタフェースからコピーされた説明: IIOMetadataFormat
        属性の有効な最大値を返します。 この値を含むか含まないかは、getAttributeValueTypeの値で判定することができます。 値はStringとして返されます。その解釈はgetAttributeDataTypeの値により異なります。 このメソッドは、getAttributeValueTypeVALUE_RANGE_*を返す場合にだけ呼び出します。
        定義:
        getAttributeMaxValue、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - Stringとしての、照会される要素の名前。
        attrName - 照会される属性の名前。
        戻り値:
        属性の有効な最大値が格納されているString
      • getAttributeListMinLength

        public int getAttributeListMinLength​(String elementName,
                                             String attrName)
        インタフェースからコピーされた説明: IIOMetadataFormat
        この属性を定義するのに使用できるリスト項目の最小数を返します。 属性自体は、空白で区切られた複数の項目が格納されているStringとして定義されます。 このメソッドは、getAttributeValueTypeVALUE_LISTを返す場合にだけ呼び出します。
        定義:
        getAttributeListMinLength、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 照会される要素の名前。
        attrName - 照会される属性の名前。
        戻り値:
        属性のリスト項目の有効な最小数。
      • getAttributeListMaxLength

        public int getAttributeListMaxLength​(String elementName,
                                             String attrName)
        インタフェースからコピーされた説明: IIOMetadataFormat
        この属性を定義するのに使用できるリスト項目の最大数を返します。 Integer.MAX_VALUEの値を使用して、上限なしを指定することができます。 属性自体は、空白で区切られた複数の項目が格納されているStringとして定義されます。 このメソッドは、getAttributeValueTypeVALUE_LISTを返す場合にだけ呼び出します。
        定義:
        getAttributeListMaxLength、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 照会される要素の名前。
        attrName - 照会される属性の名前。
        戻り値:
        属性のリスト項目の有効な最大数。
      • getAttributeDescription

        public String getAttributeDescription​(String elementName,
                                              String attrName,
                                              Locale locale)
        名前付き属性の説明を格納したString、またはnullを返します。 説明は、可能であれば、指定されたLocaleにローカライズされます。

        デフォルトの実装では、まずsetResourceBaseNameで設定された現在のリソースのベース名を使用してResourceBundleを検索し、ResourceBundle.getBundleのコメントに記述された代替メカニズムを使用して、指定されたLocaleを検索します。 ResourceBundleが見つかった場合は、あとに「/」文字と属性名が続く要素名(elementName+"/"+attrName)がそのgetStringメソッドのキーとして使用され、結果が返されます。 ResourceBundleが見つからないか、そのようなキーが存在しない場合は、nullが返されます。

        localenullの場合、Locale.getLocaleによって返された現在のデフォルトLocaleが使用されます。

        定義:
        getAttributeDescription、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 要素の名前。
        attrName - 属性の名前。
        locale - ローカリゼーションを試みる、対象となるLocale、またはnull
        戻り値:
        属性の説明
        例外:
        IllegalArgumentException - elementNamenullの場合、またはこの形式の有効な要素名でない場合。
        IllegalArgumentException - attrNamenullの場合、またはこの要素の有効な属性名でない場合。
        関連項目:
        setResourceBaseName(java.lang.String)
      • getObjectValueType

        public int getObjectValueType​(String elementName)
        インタフェースからコピーされた説明: IIOMetadataFormat
        Object参照に使用できる値(列挙、範囲、または配列)の型を示すVALUE_で始まる列挙値の1つを返します。 指定された要素内にオブジェクトの値を格納できない場合、このメソッドの結果はVALUE_NONEになります。

        有効な値が範囲として定義されるObject参照は、Comparableインタフェースを実装する必要があります。

        定義:
        getObjectValueType、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 照会される要素の名前。
        戻り値:
        VALUE_*定数の1つ。
        関連項目:
        Comparable
      • getObjectClass

        public Class<?> getObjectClass​(String elementName)
        インタフェースからコピーされた説明: IIOMetadataFormat
        要素内に格納されたObject参照のClass型を返します。 この要素にObject参照を格納できない場合は、IllegalArgumentExceptionがスローされます。 クラス型が配列である場合、このフィールドは基本となるクラス型を示します(たとえばintの配列の場合、このメソッドはint.classを返します)。

        有効な値が範囲として定義されるObject参照は、Comparableインタフェースを実装する必要があります。

        定義:
        getObjectClass、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 照会される要素の名前。
        戻り値:
        Classオブジェクト。
      • getObjectDefaultValue

        public Object getObjectDefaultValue​(String elementName)
        インタフェースからコピーされた説明: IIOMetadataFormat
        名前付き要素内のObject参照のデフォルト値が格納されているObjectを返します。
        定義:
        getObjectDefaultValue、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 照会される要素の名前。
        戻り値:
        Object
      • getObjectEnumerations

        public Object[] getObjectEnumerations​(String elementName)
        インタフェースからコピーされた説明: IIOMetadataFormat
        名前付き要素内のObject参照の有効な列挙値が格納されているObjectの配列を返します。 このメソッドは、getObjectValueTypeVALUE_ENUMERATIONを返す場合にだけ呼び出します。

        ==演算子で定義されるように(Object.equalsメソッドとは異なります)、列挙値を受け取るノードに関連付けられたObjectは、このメソッドから返される値の1つと等しくなければいけません。

        定義:
        getObjectEnumerations、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 照会される要素の名前。
        戻り値:
        Objectの配列。
      • getObjectMinValue

        public Comparable<?> getObjectMinValue​(String elementName)
        インタフェースからコピーされた説明: IIOMetadataFormat
        名前付き要素内のObject参照の有効な最小値を返します。 この値を含むか含まないかは、getObjectValueTypeの値で判定することができます。 このメソッドは、getObjectValueTypeVALUE_RANGEで始まる定数の1つを返す場合にだけ呼び出します。
        定義:
        getObjectMinValue、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 照会される要素の名前。
        戻り値:
        属性の有効な最小値。
      • getObjectMaxValue

        public Comparable<?> getObjectMaxValue​(String elementName)
        インタフェースからコピーされた説明: IIOMetadataFormat
        名前付き要素内のObject参照の有効な最大値を返します。 この値を含むか含まないかは、getObjectValueTypeの値で判定することができます。 このメソッドは、getObjectValueTypeVALUE_RANGEで始まる定数の1つを返す場合にだけ呼び出します。
        定義:
        getObjectMaxValue、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 照会される要素の名前。
        戻り値:
        属性の有効な最小値。
      • getObjectArrayMinLength

        public int getObjectArrayMinLength​(String elementName)
        インタフェースからコピーされた説明: IIOMetadataFormat
        名前付き要素内のObject参照の定義に使用できる配列要素の最小数を返します。 このメソッドは、getObjectValueTypeVALUE_LISTを返す場合にだけ呼び出します。
        定義:
        getObjectArrayMinLength、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 照会される要素の名前。
        戻り値:
        Object参照の配列の有効な最小の長さ。
      • getObjectArrayMaxLength

        public int getObjectArrayMaxLength​(String elementName)
        インタフェースからコピーされた説明: IIOMetadataFormat
        名前付き要素内のObject参照の定義に使用できる配列要素の最大数を返します。 Integer.MAX_VALUEの値を使用して、上限なしを指定することができます。 このメソッドは、getObjectValueTypeVALUE_LISTを返す場合にだけ呼び出します。
        定義:
        getObjectArrayMaxLength、インタフェース: IIOMetadataFormat
        パラメータ:
        elementName - 照会される要素の名前。
        戻り値:
        Object参照の配列の有効な最大の長さ。
      • getStandardFormatInstance

        public static IIOMetadataFormat getStandardFormatInstance​()
        javax.imageio.metadataパッケージのコメントに記述されている、標準の、プラグインに依存しないjavax.imageio_1.0メタデータ・ドキュメント形式を記述するIIOMetadataFormatオブジェクトを返します。
        戻り値:
        事前に定義されたIIOMetadataFormatインスタンス。