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

public boolean add(Attribute attribute)

属性をまだ保持していない場合、最初に指定された属性値と同じ属性カテゴリにある値を削除してから、この属性セットに指定された属性を追加します (任意のオペレーション)。@param attribute 属性セットに追加される属性値

定義:

インタフェース AttributeSet 内の add

パラメータ:

attribute - 属性セットに追加される属性値

戻り値:

属性セットが呼び出しの結果変更された場合、つまり指定された値がすでにこの属性セットのメンバでなくなっている場合は true

例外:

UnmodifiableSetException - 未確認の例外。属性セットが add() オペレーションをサポートしない場合、スローされる

ClassCastException - 未確認の例外。attribute が DocAttribute インタフェースのインスタンスではない場合、スローされる

NullPointerException - 未確認の例外。attribute が null の場合、スローされる

addAll

public boolean addAll(AttributeSet attributes)

指定されたセットのすべての要素をこの属性に追加します。その結果は、add(Attribute) オペレーションが指定されたセットの各要素を持つ属性セットに連続的に適用された場合と同じです。指定されたセットのカテゴリがこの属性セットの任意のカテゴリと同じではない場合、addAll() オペレーションは、その値が 2 つのセットの「共用体」となるようにこの属性セットを効率的に変更します。

オペレーションが行われている間に指定されたセットが変更された場合、addAll() オペレーションの動作は指定されません。

addAll オペレーションが例外をスローする場合、属性セットの状態に対する影響は実装に依存します。例外の位置の前に指定されたセットの要素は、属性セットに追加される場合とされない場合があります。

定義:

インタフェース AttributeSet 内の addAll

パラメータ:

attributes - 属性セットに追加される要素

戻り値:

呼び出しの結果、この属性セットが変更された場合は true

例外:

UnmodifiableSetException - 未確認の例外。属性セットが addAll メソッドをサポートしない場合、スローされる

ClassCastException - 未確認の例外。指定されたセットの一部が DocAttribute インタフェースのインスタンスではない場合、スローされる

NullPointerException - 未確認の例外。指定されたセットが null の場合、スローされる

関連項目:

add(Attribute)