javax.print.attribute

Interface DocAttributeSet

All Superinterfaces:

AttributeSet

所有已知实现类：

HashDocAttributeSet

public interface DocAttributeSet
extends AttributeSet

接口DocAttributeSet指定一组doc属性的接口，即打印实现接口DocAttribute的属性 。 在打印服务API中，客户端使用DocAttributeSet指定单个文档的特征以及要应用于单个文档的打印作业设置。

DocAttributeSet只是一个AttributeSet ，其构造函数和突变操作保证一个额外的不变量，即DocAttributeSet中的所有属性值都必须是接口DocAttribute的实例 。 add(Attribute)和addAll(AttributeSet)操作在下面进行了说明，以保证这个额外的不变量。

方法摘要

Modifier and Type	Method and Description
boolean	add(Attribute attribute) 如果指定的属性值不存在，请将指定的属性值添加到该属性集中，首先删除与指定的属性值相同的属性类别中的任何现有值（可选操作）。
boolean	addAll(AttributeSet attributes) 将指定集合中的所有元素添加到此属性。

Methods inherited from interface javax.print.attribute.AttributeSet

clear, containsKey, containsValue, equals, get, hashCode, isEmpty, remove, remove, size, toArray

方法详细信息

add

boolean add(Attribute attribute)

如果指定的属性值不存在，请将指定的属性值添加到该属性集中，首先删除与指定的属性值相同的属性类别中的任何现有值（可选操作）。

Specified by:

add在界面 AttributeSet

参数

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

结果

true如果此属性集由于调用而更改，即给定的属性值尚不是此属性集的成员。

异常

UnmodifiableSetException - （未经检查的异常）如果此属性集不支持 add()操作。

ClassCastException - （未经检查的异常）如果attribute不是接口DocAttribute的实例，则抛出 。

NullPointerException - （未选中的异常）如果 attribute为空，则抛出。

addAll

boolean addAll(AttributeSet attributes)

将指定集合中的所有元素添加到此属性。 结果与add(Attribute)操作已经与指定集合中的每个元素连续应用于此属性集一样。 如果没有在指定的集合类是相同的此属性设置任何类，addAll()操作有效地修改此属性集，使其价值是两个集合的并集 。

如果在操作进行中修改了指定的集合，那么addAll()操作的行为是未指定的。

如果addAll()操作引发异常，对该属性集的状态的影响是依赖于实现的; 在异常点之前的指定集合中的元素可能已经被添加到该属性集中，也可能不被添加到该属性集中。

Specified by:

addAll在界面 AttributeSet

参数

attributes - attributes元素添加到此属性集。

结果

true如果此属性集由于调用而更改。

异常

UnmodifiableSetException - （未检查异常）如果此属性集不支持 addAll()方法，则抛出该异常。

ClassCastException - （未检查异常）如果指定集合中的某些元素不是接口DocAttribute的实例，则抛出 。

NullPointerException - （未检查的异常）如果指定的集合为空，则抛出。

另请参见：

add(Attribute)