Java javax.print.attribute 接口 DocAttributeSet（JDK5）

所有类

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) 操作，以保证此附加不变量。

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)