Класс MultipleDocumentHandling

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.