模块  java.desktop
软件包  javax.print.attribute.standard

Class PrinterStateReasons

  • 实现的所有接口
    Serializable ， Cloneable ， Map<PrinterStateReason,​Severity> ， Attribute ， PrintServiceAttribute 
    public final class PrinterStateReasons
extends HashMap<PrinterStateReason,​Severity>
implements PrintServiceAttribute
    类PrinterStateReasons是打印属性类，一组枚举值，提供有关打印机当前状态的附加信息，即增加打印机PrinterState属性值的信息。

    PrinterStateReason的实例不直接出现在Print Service的属性集中。 而是，打印服务的属性集中会出现PrinterStateReasons属性。 所述PrinterStateReasons属性包含零个，一个或多于一个的PrinterStateReason ，其涉及到打印服务的状态的对象，并且每个PrinterStateReason对象与相关联Severity水平的REPORT （最不严重）， WARNING ，或ERROR （最严重）。 当打印机的相应条件成立时，打印机将PrinterStateReason对象添加到打印服务的PrinterStateReasons属性，并且当相应条件变为假时，打印机再次移除PrinterStateReason对象，无论打印服务的整体PrinterState是否也已更改。

    类PrinterStateReasons从类java.util.HashMap继承其实现。 地图中的每个条目都包含一个PrinterStateReason对象（键）映射到Severity对象（值）：

    与大多数一旦构造不可变的打印属性不同，类PrinterStateReasons被设计为可变的; 您可以将PrinterStateReason对象添加到现有PrinterStateReasons对象并再次删除它们。 但是，如类java.util.HashMap ，类PrinterStateReasons不是多线程安全的。 如果多个线程将使用PrinterStateReasons对象，请确保同步其操作（例如，使用从类java.util.Collections获取的同步映射视图）。

    IPP兼容性：每个PrinterStateReason对象和相关联的Severity对象的toString()方法返回的字符串值与中间的连字符（ "-" ）连接在一起，给出IPP关键字值。 getName()返回的类别名称给出了IPP属性名称。

    另请参见：
    Serialized Form

    • 构造方法详细信息

      • PrinterStateReasons

        public PrinterStateReasons()
        构造一个新的空打印机状态原因属性; 底层哈希映射具有默认的初始容量和加载因子。

      • PrinterStateReasons

        public PrinterStateReasons​(int initialCapacity)
        构造一个新的空打印机状态原因属性; 底层哈希映射具有给定的初始容量和默认的加载因子。
        参数
        initialCapacity - 初始容量
        异常
        IllegalArgumentException - 如果初始容量为负数

      • PrinterStateReasons

        public PrinterStateReasons​(int initialCapacity,
                           float loadFactor)
        构造一个新的空打印机状态原因属性; 底层哈希映射具有给定的初始容量和负载因子。
        参数
        initialCapacity - 初始容量
        loadFactor - 负载系数
        异常
        IllegalArgumentException - 如果初始容量为负数

    • 方法详细信息

      • getCategory

        public final 类<? extends Attribute> getCategory()
        获取将用作此打印属性值的“类别”的打印属性类。

        对于类PrinterStateReasons ，该类别是类PrinterStateReasons本身。

        Specified by:
        getCategory在界面 Attribute
        结果
        打印属性类（类别），类java.lang.Class的实例

      • getName

        public final String getName()
        获取此属性值为实例的类别的名称。

        对于类PrinterStateReasons ，类别名称是"printer-state-reasons" 。

        Specified by:
        getName接口 Attribute
        结果
        属性类别名称

      • printerStateReasonSet

        public Set<PrinterStateReason> printerStateReasonSet​(Severity severity)
        在此PrinterStateReasons属性中获取给定严重性级别的各个打印机状态原因属性的不可修改的设置视图。 设置视图中的每个元素都是PrinterStateReason对象。 设置视图中的唯一元素是映射到给定严重性值的PrinterStateReason对象。 set视图由此PrinterStateReasons属性支持，因此对此PrinterStateReasons属性的更改将反映在set视图中。 set视图不支持元素插入或删除。 set视图的迭代器不支持元素删除。
        参数
        severity - 严重性级别
        结果
        在给定的Severity级别设置单个PrinterStateReason属性的视图
        异常
        NullPointerException - 如果 severity是 null