Spec-Zone.ru › OpenJDK 25

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

equals, finalize, getClass, notify, notifyAll, wait, wait, wait

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

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, 2025, 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/print/attribute/standard/MultipleDocumentHandling.html

Spec-Zone.ru

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