Module java.desktop
Package javax.print.attribute

Interface DocAttributeSet

所有超级接口:
AttributeSet
所有已知实现类:
HashDocAttributeSet
public interface DocAttributeSet extends AttributeSet
接口DocAttributeSet指定了一组文档属性的接口，即实现了接口DocAttribute的打印属性。在打印服务API中，客户端使用DocAttributeSet来指定单个文档的特性以及要应用于单个文档的打印作业设置。

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

  • Method Details

    • add

      boolean add(Attribute attribute)
      如果尚未存在，则将指定的属性值添加到此属性集中，首先删除与指定属性值相同属性类别中的任何现有值（可选操作）。
      指定者:
      add 在接口 AttributeSet中
      参数:
      attribute - 要添加到此属性集的属性值
      返回:
      true如果此属性集因调用而更改，即给定的属性值尚不是此属性集的成员
      抛出:
      UnmodifiableSetException - 如果此属性集不支持add()操作
      ClassCastException - 如果attribute不是接口DocAttribute的实例
      NullPointerException - 如果attribute为null

    • addAll

      boolean addAll(AttributeSet attributes)
      将指定集合中的所有元素添加到此属性中。结果与逐个将指定集合中的每个元素应用于此属性集的add(Attribute)操作相同。如果指定集合中的任何类别与此属性集中的任何类别不同，则addAll()操作有效地修改此属性集，使其值为两个集合的并集。

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

      如果addAll()操作引发异常，则对此属性集状态的影响取决于实现；在异常点之前指定集合中的元素可能已添加到此属性集，也可能未添加。

      指定者:
      addAll 在接口 AttributeSet中
      参数:
      attributes - 要添加到此属性集的元素
      返回:
      true如果此属性集因调用而更改
      抛出:
      UnmodifiableSetException - 如果此属性集不支持addAll()方法
      ClassCastException - 如果指定集合中的某个元素不是接口DocAttribute的实例
      NullPointerException - 如果指定集合为null
      参见: