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)

如果指定的屬性值不存在，則將其添加到此屬性集中，方法是首先移除與指定屬性值相同的屬性類別別中的任何現有值（可選操作）。

指定者：

介面 AttributeSet 中的 add

參數：

attribute - 要添加到此屬性集的屬性值。

返回：

如果此屬性集由於調用而發生改變（即：給定的屬性值還不是此屬性集的成員），則返回 true。

拋出：

UnmodifiableSetException - （未經檢查的異常）如果此屬性集不支持 add() 操作，則拋出該異常。

ClassCastException - （未經檢查的異常）如果 attribute 不是介面 DocAttribute 的一個實例，則拋出該異常。

NullPointerException - （未經檢查的異常）如果 attribute 為 null，則拋出該異常。

addAll

boolean addAll(AttributeSet attributes)

將指定集合中的所有元素添加到此屬性中。該結果與使用指定集合中的每個元素將 add(Attribute) 操作成功地應用到此屬性集中相同。如果指定集合中的任何類別別都與此屬性集中的類別別不相同，則 addAll() 操作會有效地修改此屬性集，使其值成為兩個集合的並集。

如果正在進行此操作的同時修改了指定的集合，則 addAll() 操作的行為是不確定的。

如果 addAll() 操作拋出一個異常，則對此屬性集狀態的影響取決於實作方法；在異常點之前，不一定將指定集合中的元素添加到了此屬性集。

指定者：

介面 AttributeSet 中的 addAll

參數：

attributes - 要將其元素添加到此屬性集中的屬性。

返回：

如果此屬性集由於調用而發生改變，則返回 true。

拋出：

UnmodifiableSetException - （未經檢查的異常）如果此屬性集不支持 addAll() 方法，則拋出該異常。

ClassCastException - （未經檢查的異常）如果指定集中的某個元素不是介面 DocAttribute 的一個實例，則拋出該異常。

NullPointerException - （未經檢查的異常）如果指定的集合為 null，則拋出該異常。

另請參見：

add(Attribute)