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

Class MultipleDocumentHandling

java.lang.Object
javax.print.attribute.EnumSyntax
javax.print.attribute.standard.MultipleDocumentHandling
所有已实现的接口:
Serializable, Cloneable, Attribute, PrintJobAttribute, PrintRequestAttribute
public class MultipleDocumentHandling extends EnumSyntax implements PrintRequestAttribute, PrintJobAttribute
类MultipleDocumentHandling是一个打印属性类，一个枚举，它控制完成操作以及一个或多个打印流页面放入印象并放在介质页上。当Copies属性的值超过1时，MultipleDocumentHandling还控制处理文档产生的副本的顺序。此属性仅适用于由两个或多个单独文档组成的多文档打印作业。

简而言之，MultipleDocumentHandling确定了输入的多个（电子）文档与多文档打印作业产生的输出（物理）文档或文档之间的关系。有两种可能性：

  • 多个输入文档合并为单个输出文档。完成操作（Finishings）在此单个输出文档上执行。Copies属性告诉要生成多少份此单个输出文档的副本。MultipleDocumentHandling值SINGLE_DOCUMENT和SINGLE_DOCUMENT_NEW_SHEET指定了这种可能性的两种变体。
  • 多个输入文档保持单独的输出文档。完成操作（Finishings）在每个输出文档上单独执行。Copies属性告诉要生成多少份每个单独输出文档的副本。MultipleDocumentHandling值SEPARATE_DOCUMENTS_UNCOLLATED_COPIES和SEPARATE_DOCUMENTS_COLLATED_COPIES指定了这种可能性的两种变体。
在下面的详细说明中，如果“a”表示文档数据的一个实例，则处理文档“a”中的数据的结果是由“a(*)”表示的介质页序列。

标准的MultipleDocumentHandling值为：

  • SINGLE_DOCUMENT。如果打印作业有多个文档--比如，文档数据称为a和b--那么处理所有文档数据（a然后b）的结果必须被视为用于完成操作的单个介质页序列；也就是说，完成操作将在序列a(*),b(*)的连接上执行。打印机不得强制每个文档实例中的数据格式化到新的打印流页面上，也不得在新的介质页上启动新的印象。如果制作多份副本，则从处理文档数据产生的介质页集的排序必须是a(*),b(*),a(*),b(*),...，并且打印机对象必须强制每份副本（a(*),b(*)）从新的介质页开始。
  • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES。如果打印作业有多个文档--比如，文档数据称为a和b--那么必须将每个文档实例中的数据处理结果视为用于完成操作的单个介质页序列；也就是说，集合a(*)和b(*)将分别完成。打印机必须强制处理单个文档数据结果的每份副本从新的介质页开始。如果制作多份副本，则从处理文档数据产生的介质页集的排序必须是a(*),a(*),...,b(*),b(*)...。
  • SEPARATE_DOCUMENTS_COLLATED_COPIES。如果打印作业有多个文档--比如，文档数据称为a和b--那么必须将每个文档实例中的数据处理结果视为用于完成操作的单个介质页序列；也就是说，集合a(*)和b(*)将分别完成。打印机必须强制处理单个文档数据结果的每份副本从新的介质页开始。如果制作多份副本，则从处理文档数据产生的介质页集的排序必须是a(*),b(*),a(*),b(*),...。
  • SINGLE_DOCUMENT_NEW_SHEET。与SINGLE_DOCUMENT相同，只是打印机必须确保作业中每个文档实例的第一个印象放在新的介质页上。此值允许多个文档用单个订书钉订在一起，其中每个文档都从新的介质页开始。

SINGLE_DOCUMENT与SEPARATE_DOCUMENTS_COLLATED_COPIES在打印流页面排序方面相同，但在介质页生成方面不同，因为如果到目前为止作业已产生奇数页，则SINGLE_DOCUMENT会将下一个文档的第一页放在一张纸的背面，而SEPARATE_DOCUMENTS_COLLATED_COPIES总是将下一个文档或文档副本强制放在新的介质页上。

此外，如果指定了Finishings属性为STAPLE，则：

  • 对于SINGLE_DOCUMENT，文档a和b被一起订书钉为单个文档，而不考虑新的介质页。
  • 对于SINGLE_DOCUMENT_NEW_SHEET，文档a和b被一起订书钉为单个文档，但文档b从新的介质页开始。
  • 对于SEPARATE_DOCUMENTS_UNCOLLATED_COPIES和SEPARATE_DOCUMENTS_COLLATED_COPIES，文档a和b被分开订书钉。
注意： 这些值都不提供在文档内生成未整理的介质页的方法，即在同一文档的介质页n之前生成多份副本，然后再生成介质页n+1。要指定这一点，请参阅SheetCollate属性。

IPP兼容性： getName()返回的类别名称是IPP属性名称。枚举的整数值是IPP枚举值。toString()方法返回属性值的IPP字符串表示形式。

参见:

  • Field Details

    • SINGLE_DOCUMENT

      public static final MultipleDocumentHandling SINGLE_DOCUMENT
      单个文档 -- 请参见上文获取SINGLE_DOCUMENT的更多信息。

    • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES

      public static final MultipleDocumentHandling SEPARATE_DOCUMENTS_UNCOLLATED_COPIES
      分开文档未整理副本 -- 请参见上文获取SEPARATE_DOCUMENTS_UNCOLLATED_COPIES的更多信息。

    • SEPARATE_DOCUMENTS_COLLATED_COPIES

      public static final MultipleDocumentHandling SEPARATE_DOCUMENTS_COLLATED_COPIES
      分开文档整理副本 -- 请参见上文获取SEPARATE_DOCUMENTS_COLLATED_COPIES的更多信息。

    • SINGLE_DOCUMENT_NEW_SHEET

      public static final MultipleDocumentHandling SINGLE_DOCUMENT_NEW_SHEET
      单个文档新介质页 -- 请参见上文获取SINGLE_DOCUMENT_NEW_SHEET的更多信息。

  • Constructor Details

    • MultipleDocumentHandling

      protected MultipleDocumentHandling(int value)
      使用给定的整数值构造一个新的多文档处理枚举值。
      参数:
      value - 整数值

  • Method Details

    • getStringTable

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

    • getEnumValueTable

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

    • getCategory

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

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

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

    • getName

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

      对于类 MultipleDocumentHandling 和任何供应商定义的子类，类别名称为 "multiple-document-handling"。

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