Класс MultipleDocumentHandling

public class MultipleDocumentHandling extends EnumSyntax implements PrintRequestAttribute, PrintJobAttribute

Класс MultipleDocumentHandling — это класс атрибута печати, перечисление, которое управляет операциями финиширования и размещением одной или нескольких страниц потока печати в оттисках и на листах носителя. Когда значение атрибута Copies превышает 1, MultipleDocumentHandling также управляет порядком создания копий, полученных в результате обработки документов. Этот атрибут актуален только для задания печати multidoc, состоящего из двух или более отдельных документов.

Вкратце, MultipleDocumentHandling определяет отношение между множеством входных (электронных) документов, подаваемых в задание печати multidoc, и выходным (физическим) документом или документами, создаваемыми заданием печати multidoc. Существуют два варианта:

• Множественные входные документы объединяются в один выходной документ. Операции финиширования (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.