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)