Module  java.desktop
软件包  javax.print.attribute.standard

Class PrinterResolution

  • All Implemented Interfaces:
    Serializable ， Cloneable ， Attribute ， DocAttribute ， PrintJobAttribute ， PrintRequestAttribute 

    public final class PrinterResolution
extends ResolutionSyntax
implements DocAttribute, PrintRequestAttribute, PrintJobAttribute
    PrinterResolution类是一个打印属性类，它指定打印机支持的准确分辨率或用于打印作业。 该属性假设打印机具有一小组设备分辨率，在这些设备分辨率下可以进行操作，而不是连续体。

    PrinterResolution以多种方式使用：

    1. 当客户端搜索正确地寻找支持客户端所需分辨率的打印机（不再更多，不少于）时，客户端会指定一个PrinterResolution类的实例，指示客户端想要的确切解决方案。 只有支持该精确分辨率的打印机才能匹配搜索。
    2. 当客户端需要使用客户端所需的分辨率（不再更多，不少于）打印作业时，客户端将PrinterResolution类的实例指定为打印作业的属性。 如果打印作业不支持精确的分辨率，并且将Fidelity设置为true，则此操作将失败。
    如果客户端想要找到支持大于某一最小要求的分辨率的打印机，则可能需要从查找请求中排除该属性，并直接查询支持的分辨率集，并指定最接近客户端要求。 在某些情况下，这可以通过指定经常控制分辨率的PrintQuality属性来更简单地实现。

    IPP兼容性：可以通过调用PrinterResolution对象上的方法来获取构建IPP "printer-resolution"属性所需的信息。 由getName()返回的类别名称提供IPP属性名称。

    另请参见：
    Serialized Form

    • 构造方法详细信息

      • PrinterResolution

        public PrinterResolution​(int crossFeedResolution,
                         int feedResolution,
                         int units)
        从给定项目构建新的打印机分辨率属性。
        参数
        crossFeedResolution - 交叉进给方向分辨率。
        feedResolution - 进 feedResolution方向分辨率。
        units - 单位换算系数，例如 ResolutionSyntax.DPI或 ResolutionSyntax.DPCM 。
        异常
        IllegalArgumentException - （未经检查的异常）抛出 crossFeedResolution < 1或 feedResolution < 1或 units < 1 。

    • 方法详细信息

      • equals

        public boolean equals​(Object object)
        返回此打印机分辨率属性是否等同于传入的对象。 要相等的，所有以下条件必须为真：
        1. object不为空。
        2. object是PrinterResolution类的一个实例。
        3. 该属性的交叉进给方向分辨率等于object的交叉进给方向分辨率。
        4. 此属性的进纸方向分辨率等于object的进纸方向分辨率。
        重写：
        equals在 ResolutionSyntax
        参数
        object - 要比较的对象。
        结果
        如果 object等效于此打印机分辨率属性， object true，否则为false。
        另请参见：
        Object.hashCode() ， HashMap

      • getCategory

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

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

        Specified by:
        getCategory在接口 Attribute
        结果
        打印属性类（category），一个java.lang.Class类的实例。

      • getName

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

        对于PrinterResolution类，类别名称为"printer-resolution" 。

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