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。与 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 Compatibility: getName() 所返回的类别名称为 IPP 属性名称。枚举的整数值为 IPP 枚举值。toString() 方法返回属性值的 IPP 字符串表示形式。

另请参见：

Copies, Finishings, NumberUp, PageRanges, SheetCollate, Sides, 序列化表格

字段摘要

static MultipleDocumentHandling	SEPARATE_DOCUMENTS_COLLATED_COPIES 独立文档逐份打印副本 －－ 有关更多信息，请参见上文。
static MultipleDocumentHandling	SEPARATE_DOCUMENTS_UNCOLLATED_COPIES 独立文档非逐份打印副本 －－ 有关更多信息，请参见上文。
static MultipleDocumentHandling	SINGLE_DOCUMENT 单个文档 －－ 有关更多信息，请参见上文。
static MultipleDocumentHandling	SINGLE_DOCUMENT_NEW_SHEET 单个文档新纸张 －－ 有关更多信息，请参见上文。

构造方法摘要

protected

MultipleDocumentHandling(int value) 构造具有给定整数值的新的多文档处理枚举值。

方法摘要

Class<? extends Attribute>	getCategory() 获取将被用作此打印属性值的“类别”的打印属性类。
protected EnumSyntax[]	getEnumValueTable() 返回 MultipleDocumentHandling 类的枚举值表。
String	getName() 获取类别名称，此属性值为该类别的实例。
protected String[]	getStringTable() 返回 MultipleDocumentHandling 类的字符串表。

从类 javax.print.attribute.EnumSyntax 继承的方法

clone, getOffset, getValue, hashCode, readResolve, toString

从类 java.lang.Object 继承的方法

equals, finalize, getClass, notify, notifyAll, wait, wait, wait

字段详细信息

SINGLE_DOCUMENT

public static final MultipleDocumentHandling SINGLE_DOCUMENT

单个文档 －－ 有关更多信息，请参见上文。

SEPARATE_DOCUMENTS_UNCOLLATED_COPIES

public static final MultipleDocumentHandling SEPARATE_DOCUMENTS_UNCOLLATED_COPIES

独立文档非逐份打印副本 －－ 有关更多信息，请参见上文。

SEPARATE_DOCUMENTS_COLLATED_COPIES

public static final MultipleDocumentHandling SEPARATE_DOCUMENTS_COLLATED_COPIES

独立文档逐份打印副本 －－ 有关更多信息，请参见上文。

SINGLE_DOCUMENT_NEW_SHEET

public static final MultipleDocumentHandling SINGLE_DOCUMENT_NEW_SHEET

单个文档新纸张 －－ 有关更多信息，请参见上文。

构造方法详细信息

MultipleDocumentHandling

protected MultipleDocumentHandling(int value)

构造具有给定整数值的新的多文档处理枚举值。

参数：

value - 整数值。

方法详细信息

getStringTable

protected String[] getStringTable()

返回 MultipleDocumentHandling 类的字符串表。

覆盖：

类 EnumSyntax 中的 getStringTable

返回：

字符串表

getEnumValueTable

protected EnumSyntax[] getEnumValueTable()

返回 MultipleDocumentHandling 类的枚举值表。

覆盖：

类 EnumSyntax 中的 getEnumValueTable

返回：

值表

getCategory

public final Class<? extends Attribute> getCategory()

获取将被用作此打印属性值的“类别”的打印属性类。

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

指定者：

接口 Attribute 中的 getCategory

返回：

打印属性类（类别），它是 java.lang.Class 类的实例。

getName

public final String getName()

获取类别名称，此属性值为该类别的实例。

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

指定者：

接口 Attribute 中的 getName

返回：

属性类别名称。