Spec-Zone.ru › OpenJDK 27

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

См. также:
  • Copies
  • Finishings
  • NumberUp
  • PageRanges
  • SheetCollate
  • Sides
  • Сериализованная форма

Краткое описание полей

Модификатор и тип Поле Описание
static final MultipleDocumentHandling SEPARATE_DOCUMENTS_COLLATED_COPIES
Отдельные документы, сортированные копии — см. выше дополнительную информацию.
static final MultipleDocumentHandling SEPARATE_DOCUMENTS_UNCOLLATED_COPIES
Отдельные документы, несортированные копии — см. выше дополнительную информацию.
static final MultipleDocumentHandling SINGLE_DOCUMENT
Один документ — см. выше дополнительную информацию.
static final MultipleDocumentHandling SINGLE_DOCUMENT_NEW_SHEET
Один документ, новый лист — см. выше дополнительную информацию.

Краткое описание конструкторов

MultipleDocumentHandling(int value)
Модификатор Конструктор Описание
protected
Создаёт новое значение перечисления для управления обработкой нескольких документов с заданным целочисленным значением.

Краткое описание методов

Модификатор и тип Метод Описание
final Class<? extends Attribute> getCategory()
Возвращает класс атрибута печати, который используется в качестве «категории» для этого значения атрибута печати.
protected EnumSyntax[] getEnumValueTable()
Возвращает таблицу значений перечисления для класса MultipleDocumentHandling.
final String getName()
Возвращает имя категории, экземпляром которой является это значение атрибута.
protected String[] getStringTable()
Возвращает таблицу строк для класса MultipleDocumentHandling.

Методы, объявленные в классе EnumSyntax

clone, getOffset, getValue, hashCode, readResolve, toString
Модификатор и тип Метод Описание
Object clone()
Возвращает копию этого значения перечисления, которая для сохранения семантики значений перечисления является тем же объектом, что и это значение.
protected int getOffset()
Возвращает наименьшее целочисленное значение, используемое классом перечисления этого значения перечисления.
int getValue()
Возвращает целочисленное значение этого значения перечисления.
int hashCode()
Возвращает хеш-код этого значения перечисления.
protected Object readResolve()
При чтении объекта преобразует этот десериализованный экземпляр перечисления в соответствующее значение перечисления, определённое в классе атрибута перечисления.
String toString()
Возвращает строковое значение, соответствующее этому значению перечисления.

Методы, объявленные в классе Object

equals, finalize, getClass, notify, notifyAll, wait, wait, wait
Модификатор и тип Метод Описание
boolean equals(Object obj)
Указывает, равен ли некоторый другой объект этому объекту.
protected void finalize()
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Финализация устарела и может быть удалена в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
final void wait()
Заставляет текущий поток ждать пробуждения, обычно в результате вызова notify или interrupt.
final void wait(long timeoutMillis)
Заставляет текущий поток ждать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ждать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.

Подробное описание полей

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.
Переопределяет:
getStringTable в классе EnumSyntax
Возвращает:
таблицу строк

getEnumValueTable

protected EnumSyntax[] getEnumValueTable()
Возвращает таблицу значений перечисления для класса MultipleDocumentHandling.
Переопределяет:
getEnumValueTable в классе EnumSyntax
Возвращает:
таблицу значений

getCategory

public final Class<? extends Attribute> getCategory()
Возвращает класс атрибута печати, который используется в качестве «категории» для этого значения атрибута печати.

Для класса MultipleDocumentHandling и любых подклассов, определённых поставщиками, категорией является сам класс MultipleDocumentHandling.

Определён в:
getCategory в интерфейсе Attribute
Возвращает:
класс атрибута печати (категория), экземпляр класса java.lang.Class

getName

public final String getName()
Возвращает имя категории, экземпляром которой является это значение атрибута.

Для класса MultipleDocumentHandling и любых подклассов, определённых поставщиками, именем категории является "multiple-document-handling".

Определён в:
getName в интерфейсе Attribute
Возвращает:
имя категории атрибута

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, обзор концепций, определения терминов, обходные решения и примеры рабочего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторские права © 1993, 2026, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API