Класс 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 также управляет порядком, в котором производятся копии, полученные в результате обработки документов. Этот атрибут актуален только для задания печати 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.
- См. также:
-
Copies,Finishings,NumberUp,PageRanges,SheetCollate,Sides, Serialized Form
Поля
| Модификатор и тип | Поле и описание |
|---|---|
static MultipleDocumentHandling |
SEPARATE_DOCUMENTS_COLLATED_COPIES Отдельные документы, упорядоченные копии — см. выше для дополнительной информации. |
static MultipleDocumentHandling |
SEPARATE_DOCUMENTS_UNCOLLATED_COPIES Отдельные документы, неупорядоченные копии — см. выше для дополнительной информации. |
static MultipleDocumentHandling |
SINGLE_DOCUMENT Один документ — см. выше для дополнительной информации. |
static MultipleDocumentHandling |
SINGLE_DOCUMENT_NEW_SHEET Один документ на новый лист — см. выше для дополнительной информации. |
Краткое описание конструкторов
| Модификатор | Конструктор и описание |
|---|---|
protected |
MultipleDocumentHandling(int value) Создает новое значение перечисления обработки нескольких документов с заданным целочисленным значением. |
Краткое описание методов
| Модификатор и тип | Метод и описание |
|---|---|
Class<? extends Attribute> |
getCategory() Получить класс атрибута печати, который будет использоваться в качестве «категории» для данного значения атрибута печати. |
protected EnumSyntax[] |
getEnumValueTable() Возвращает таблицу значений перечисления для класса MultipleDocumentHandling. |
String |
getName() Получить имя категории, экземпляром которой является данное значение атрибута. |
protected String[] |
getStringTable() Возвращает строковую таблицу для класса MultipleDocumentHandling. |
Наследованные методы из класса javax.print.attribute.EnumSyntax
clone, getOffset, getValue, hashCode, readResolve, toString Наследованные методы из класса java.lang.Object
equals, finalize, getClass, notify, notifyAll, wait, wait, wait Поля
SINGLE_DOCUMENT
public static final MultipleDocumentHandling SINGLE_DOCUMENT
Единый документ — см. дополнительную информацию выше.
РАЗДЕЛЬНЫЕ_ДОКУМЕНТЫ_НЕСОРТИРОВАННЫЕ_КОПИИ
public static final MultipleDocumentHandling SEPARATE_DOCUMENTS_UNCOLLATED_COPIES
Раздельные документы несортированные копии — см. дополнительную информацию выше.
РАЗДЕЛЬНЫЕ_ДОКУМЕНТЫ_СОРТИРОВАННЫЕ_КОПИИ
public static final MultipleDocumentHandling SEPARATE_DOCUMENTS_COLLATED_COPIES
Раздельные документы отсортированные копии — см. дополнительную информацию выше.
ЕДИНЫЙ_ДОКУМЕНТ_НОВЫЙ_ЛИСТ
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".
© 1993, 2020, 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.