javax.print.attribute

接口
异常
所有超级接口:
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)