当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

DocAttributeSet (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

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)

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。