JavaTM Platform
Standard Ed. 6

javax.print.attribute
インタフェース PrintServiceAttributeSet

すべてのスーパーインタフェース:
AttributeSet
既知の実装クラスの一覧:
HashPrintServiceAttributeSet

public interface PrintServiceAttributeSet
extends AttributeSet

PrintServiceAttributeSet インタフェースは、印刷ジョブ属性のセットに対するインタフェース、つまり、PrintServiceAttribute インタフェースを実装する印刷属性を指定します。Print Service API では、Print Service インスタンスは PrintServiceAttributeSet を使って印刷サービスの状態を報告します。  

PrintServiceAttributeSet は、そのコンストラクタと変更操作が追加の不変式を保証する AttributeSet です。 つまり、PrintServiceAttributeSet のすべての属性の値は PrintServiceAttribute インタフェースのインスタンスでなければなりません。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)
属性をまだ保持していない場合、最初に指定された属性値と同じ属性カテゴリにある値を削除してから、この属性セットに指定された属性を追加します (任意のオペレーション)。

定義:
インタフェース AttributeSet 内の add
パラメータ:
attribute - 属性セットに追加される属性値
戻り値:
属性セットが呼び出しの結果変更された場合、 つまり指定された属性値がすでに属性セットのメンバーでなくなっている場合は true
例外:
UnmodifiableSetException - 未確認の例外。属性セットが add() オペレーションを サポートしない場合、スローされる
ClassCastException - 未確認の例外。attributePrintServiceAttribute インタフェースのインスタンスではない場合、 スローされる
NullPointerException - 未確認の例外。attribute が null の場合、スローされる

addAll

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

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

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

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

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。