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