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

类 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 总是将下一个文档或文档副本强制到新工作表上。

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

  • 使用 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 字符串表示。

参见：

  • 字段详细信息

  • 构造方法详细信息

    • MultipleDocumentHandling

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

  • 方法详情

    • getStringTable

      protected String [] getStringTable()
      返回 MultipleDocumentHandling string table
      重写：
      getStringTable 在类 EnumSyntax 中
      返回：
      字符串表

    • getEnumValueTable

      protected EnumSyntax [] getEnumValueTable()
      返回类 MultipleDocumentHandling 的枚举值表。
      重写：
      getEnumValueTable 在类 EnumSyntax 中
      返回：
      值表

    • getCategory

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

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

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

    • getName

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

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

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