javax.print.attribute

インタフェースDocAttributeSet

すべてのスーパー・インタフェース:

AttributeSet

既知のすべての実装クラス:

HashDocAttributeSet

public interface DocAttributeSet
extends AttributeSet

DocAttributeSetインタフェースは、ドキュメントの属性のセットに対するインタフェース、つまりDocAttributeインタフェースを実装する印刷属性を指定します。Print Service APIで、クライアントは、DocAttributeSetを使用して個々のドキュメントの特性および個々のドキュメントに適用される印刷ジョブの設定を指定します。

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

メソッドのサマリー

修飾子と型	メソッドと説明
boolean	add(Attribute attribute) 属性をまだ保持していない場合、最初に指定された属性値と同じ属性カテゴリにある値を削除してから、この属性セットに指定された属性を追加します(オプションの操作)。
boolean	addAll(AttributeSet attributes) 指定されたセットのすべての要素をこの属性に追加します。

インタフェース javax.print.attribute.AttributeSetから継承されたメソッド

clear, containsKey, containsValue, equals, get, hashCode, isEmpty, remove, remove, size, toArray

メソッドの詳細

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)