Module java.desktop
Package javax.print.attribute.standard

Class Finishings

java.lang.Object
javax.print.attribute.EnumSyntax
javax.print.attribute.standard.Finishings
所有已实现的接口:
Serializable, Cloneable, Attribute, DocAttribute, PrintJobAttribute, PrintRequestAttribute
public class Finishings extends EnumSyntax implements DocAttribute, PrintRequestAttribute, PrintJobAttribute
类Finishings是一个打印属性类，一个枚举，用于标识打印机是否对作业中每份打印文档的每份副本应用某种装订或装订操作。对于多文档打印作业（包含多个文档的作业），MultipleDocumentHandling属性确定了对于装订而言什么构成了“副本”。

标准的Finishings值包括：

以下Finishings值更具体；它们指示一个角落或一个边缘，就好像文档是一个纵向文档一样：

STAPLE_XXX值是相对于文档指定的，就好像文档是一个纵向文档一样。如果文档实际上是一个横向或反向横向文档，客户端会提供适当的转换值。例如，要在横向文档上的左上角位置一个订书钉，客户端提供STAPLE_BOTTOM_LEFT值（因为横向被定义为从纵向顺时针旋转90度）。另一方面，要在反向横向文档上的左上角位置一个订书钉，客户端提供STAPLE_TOP_RIGHT值（因为反向横向被定义为从纵向逆时针旋转90度）。

每个订书钉相对于文档的角度（垂直、水平、倾斜）取决于实现，这可能又取决于属性的值。

Finishings属性对于多文档打印作业（包含多个文档的作业）的影响取决于所有文档是否指定了相同的装订，或者不同文档是否指定了不同的装订，并且取决于（可能默认的）MultipleDocumentHandling属性的值。

  • 如果所有文档都指定了相同的装订，那么任何MultipleDocumentHandling的值都是有意义的，打印机的处理取决于MultipleDocumentHandling的值：
    • SINGLE_DOCUMENT -- 所有输入文档将被绑定在一起作为一个具有指定装订的输出文档。
    • SINGLE_DOCUMENT_NEW_SHEET -- 所有输入文档将被绑定在一起作为一个具有指定装订的输出文档，并且每个输入文档的第一印象始终从新介质开始。
    • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES -- 每个输入文档将被单独绑定，具有指定的装订。
    • SEPARATE_DOCUMENTS_COLLATED_COPIES -- 每个输入文档将被单独绑定，具有指定的装订。
  • 如果不同文档指定了不同的装订，那么只有两个MultipleDocumentHandling的值是有意义的，如果指定了其他任何值，打印机在提交作业时会报告错误：
    • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES -- 每个输入文档将被单独绑定，具有自己指定的装订。
    • SEPARATE_DOCUMENTS_COLLATED_COPIES -- 每个输入文档将被单独绑定，具有自己指定的装订。

IPP兼容性: 类Finishings封装了一些可以包含在IPP“finishings”属性中的IPP枚举值，这是一组枚举值。由getName()返回的类别名称是IPP属性名称。枚举的整数值是IPP枚举值。toString()方法返回属性值的IPP字符串表示。在IPP中，Finishings是一个多值属性，此API目前只允许指定一个装订。

参见:

  • Field Details

    • NONE

      public static final Finishings NONE
      不进行装订。

    • STAPLE

      public static final Finishings STAPLE
      用一个或多个订书钉将文档装订。订书钉的确切数量和位置由站点定义。

    • COVER

      public static final Finishings COVER
      当希望为文档选择非打印（或预打印）封面时指定此值。这不取代文档本身指定的打印封面（在封面纸介质上）。

    • BIND

      public static final Finishings BIND
      此值表示要对文档应用装订；装订的类型和位置由站点定义。

    • SADDLE_STITCH

      public static final Finishings SADDLE_STITCH
      用一个或多个订书钉将文档沿中间折叠处装订。订书钉和中间折叠的确切数量和位置由实现和/或站点定义。

    • EDGE_STITCH

      public static final Finishings EDGE_STITCH
      用一个或多个订书钉将文档沿一边装订。订书钉的确切数量和位置由实现和/或站点定义。

    • STAPLE_TOP_LEFT

      public static final Finishings STAPLE_TOP_LEFT
      在左上角用一个或多个订书钉将文档装订。

    • STAPLE_BOTTOM_LEFT

      public static final Finishings STAPLE_BOTTOM_LEFT
      在左下角用一个或多个订书钉将文档装订。

    • STAPLE_TOP_RIGHT

      public static final Finishings STAPLE_TOP_RIGHT
      在右上角用一个或多个订书钉将文档装订。

    • STAPLE_BOTTOM_RIGHT

      public static final Finishings STAPLE_BOTTOM_RIGHT
      在右下角用一个或多个订书钉将文档装订。

    • EDGE_STITCH_LEFT

      public static final Finishings EDGE_STITCH_LEFT
      用一个或多个订书钉将文档沿左边装订。订书钉的确切数量和位置由实现和/或站点定义。

    • EDGE_STITCH_TOP

      public static final Finishings EDGE_STITCH_TOP
      用一个或多个订书钉将文档沿顶边装订。订书钉的确切数量和位置由实现和/或站点定义。

    • EDGE_STITCH_RIGHT

      public static final Finishings EDGE_STITCH_RIGHT
      用一个或多个订书钉将文档沿右边装订。订书钉的确切数量和位置由实现和/或站点定义。

    • EDGE_STITCH_BOTTOM

      public static final Finishings EDGE_STITCH_BOTTOM
      用一个或多个订书钉将文档沿底边装订。订书钉的确切数量和位置由实现和/或站点定义。

    • STAPLE_DUAL_LEFT

      public static final Finishings STAPLE_DUAL_LEFT
      在左边用两个订书钉将文档装订，假设文档是纵向的（见上文）。

    • STAPLE_DUAL_TOP

      public static final Finishings STAPLE_DUAL_TOP
      在顶边用两个订书钉将文档装订，假设文档是纵向的（见上文）。

    • STAPLE_DUAL_RIGHT

      public static final Finishings STAPLE_DUAL_RIGHT
      在右边用两个订书钉将文档装订，假设文档是纵向的（见上文）。

    • STAPLE_DUAL_BOTTOM

      public static final Finishings STAPLE_DUAL_BOTTOM
      将文档与两个订书钉（金属钉）绑定在底部边缘，假设是纵向文档（见上文）。

  • Constructor Details

    • Finishings

      protected Finishings(int value)
      使用给定的整数值构造一个新的装订绑定枚举值。
      参数:
      value - 整数值

  • Method Details

    • getStringTable

      protected String[] getStringTable()
      返回类Finishings的字符串表。
      覆盖:
      getStringTable 在类 EnumSyntax中
      返回:
      字符串表

    • getEnumValueTable

      protected EnumSyntax[] getEnumValueTable()
      返回类Finishings的枚举值表。
      覆盖:
      getEnumValueTable 在类 EnumSyntax中
      返回:
      值表

    • getOffset

      protected int getOffset()
      返回类Finishings中使用的最低整数值。
      覆盖:
      getOffset 在类 EnumSyntax中
      返回:
      最低枚举值的偏移量

    • getCategory

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

      对于类Finishings和任何供应商定义的子类，类别就是类Finishings本身。

      指定者:
      getCategory 在接口 Attribute中
      返回:
      打印属性类（类别），是java.lang.Class类的实例

    • getName

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

      对于类Finishings和任何供应商定义的子类，类别名称是"finishings"。

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