Класс 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.