Module java.desktop

Class PrinterResolution

java.lang.Object
javax.print.attribute.ResolutionSyntax
javax.print.attribute.standard.PrinterResolution
所有已实现的接口:
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兼容性: 构造IPP "printer-resolution"属性所需的信息可以通过调用PrinterResolution对象上的方法来获取。通过getName()返回的类别名称给出了IPP属性名称。

参见:
  • Constructor Details

    • PrinterResolution

      public PrinterResolution(int crossFeedResolution, int feedResolution, int units)
      从给定项构造新的打印机分辨率属性。
      参数:
      crossFeedResolution - 横向分辨率
      feedResolution - 纵向分辨率
      units - 单位转换因子,例如ResolutionSyntax.DPIResolutionSyntax.DPCM
      抛出:
      IllegalArgumentException - 如果crossFeedResolution < 1feedResolution < 1units < 1
  • Method Details

    • equals

      public boolean equals(Object object)
      返回此打印机分辨率属性是否等效于传入的对象。要等效,必须满足以下所有条件:
      1. object不是null
      2. objectPrinterResolution类的实例。
      3. 此属性的横向分辨率等于object的横向分辨率。
      4. 此属性的纵向分辨率等于object的纵向分辨率。
      覆盖:
      equals 在类 ResolutionSyntax
      参数:
      object - 要比较的Object
      返回:
      如果object等效于此打印机分辨率属性,则返回true,否则返回false
      参见:
    • getCategory

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

      对于类PrinterResolution,类别是PrinterResolution类本身。

      指定者:
      getCategory 在接口 Attribute
      返回:
      打印属性类(类别),java.lang.Class类的实例
    • getName

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

      对于类PrinterResolution,类别名称是"printer-resolution"

      指定者:
      getName 在接口 Attribute
      返回:
      属性类别名称