Module  java.desktop
软件包  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)操作进行了说明，以保证此额外的不变量。

    • 方法详细信息

      • 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)