モジュール java.desktop
パッケージ javax.print.attribute

インタフェースDocAttributeSet

  • すべてのスーパー・インタフェース:
    AttributeSet
    既知のすべての実装クラス:
    HashDocAttributeSet
    public interface DocAttributeSet
extends AttributeSet
    インタフェースDocAttributeSetは、doc属性のセット、つまりインタフェースDocAttributeを実装する印刷属性のインタフェースを指定します。 プリント・サービスAPIでは、クライアントはDocAttributeSetを使用して、個々のドキュメントの特性と個々のドキュメントに適用される印刷ジョブ設定を指定します。

    DocAttributeSetは、DocAttributeSet内のすべての属性値がDocAttributeインタフェースのインスタンスでなければならないというコンストラクタと変更操作が追加の不変条件を保証するAttributeSetです。 add(Attribute)およびaddAll(AttributeSet)操作は、この追加の一様性を保証するために以下で再指定されています。

    • メソッドの詳細

      • add

        boolean add​(Attribute attribute)
        属性をまだ保持していない場合、最初に指定された属性値と同じ属性カテゴリにある値を削除してから、この属性セットに指定された属性を追加します(オプションの操作)。
        定義:
        add、インタフェース: AttributeSet
        パラメータ:
        attribute - この属性セットに追加する属性値
        戻り値:
        この属性セットが呼出しの結果として変更された場合、つまり、指定された属性値がすでにこの属性セットのメンバーでなくなっている場合はtrue
        例外:
        UnmodifiableSetException - この属性セットがadd()操作をサポートしていない場合
        ClassCastException - attributeがインタフェースDocAttributeのインスタンスでない場合
        NullPointerException - attributeがnullの場合

      • addAll

        boolean addAll​(AttributeSet attributes)
        指定されたセットのすべての要素をこの属性に追加します。 その結果は、add(Attribute)操作が指定されたセットの各要素を持つ属性セットに連続的に適用された場合と同じです。 指定されたセット内のカテゴリがこの属性セット内のどのカテゴリとも同じでない場合、addAll()操作はこの属性セットを、その値が2つのセットの和集合になるように効率的に変更します。

        指定されたセットがaddAll()操作の進行中に変更された場合、その操作の動作は指定されていません。

        addAll()操作が例外をスローした場合、この属性セットの状態への影響は実装に依存します。例外が発生した時点の前に指定されたセットの要素は、この属性セットに追加される場合とされない場合があります。

        定義:
        addAll、インタフェース: AttributeSet
        パラメータ:
        attributes - 要素がこの属性セットに追加される属性
        戻り値:
        この属性セットが呼出しの結果として変更された場合はtrue
        例外:
        UnmodifiableSetException - この属性セットがaddAll()メソッドをサポートしていない場合
        ClassCastException - 指定されたセットの要素がインタフェースDocAttributeのインスタンスでない場合
        NullPointerException - 指定されたセットがnullの場合
        関連項目:
        add(Attribute)