Spec-Zone.ru › OpenJDK 27

Класс SheetCollate

java.lang.Object
javax.print.attribute.EnumSyntax
javax.print.attribute.standard.SheetCollate
Все реализуемые интерфейсы:
Serializable, Cloneable, Attribute, DocAttribute, PrintJobAttribute, PrintRequestAttribute
public final class SheetCollate extends EnumSyntax implements DocAttribute, PrintRequestAttribute, PrintJobAttribute
Класс SheetCollate — это класс атрибутов печати, перечисление, которое указывает, должны ли листы носителя каждой копии каждого печатаемого документа в задании располагаться последовательно, если для документа указано несколько копий с помощью атрибута Copies. Когда SheetCollate имеет значение COLLATED, каждая копия каждого документа печатается с расположением листов в потоке печати по порядку. Когда SheetCollate имеет значение UNCOLLATED, каждый лист в потоке печати печатается подряд столько раз, сколько указано в атрибуте Copies. Например, предположим, что документ выводится на двух листах носителя, значение атрибута Copies равно 6, а SheetCollate имеет значение UNCOLLATED; в этом случае сначала печатаются шесть копий первого листа носителя, а затем шесть копий второго листа.

Реализация эффекта сортировки листов путем размещения копий документа в нескольких выходных лотках или в одном выходном лотке с разделением документов, определяемым реализацией, зависит от реализации. Реализация этого эффекта путем нескольких проходов по заданию или с помощью сортировщика выходных документов также зависит от реализации.

Если принтер не поддерживает атрибут SheetCollate (то есть клиент не может указать конкретный порядок сортировки листов), принтер должен вести себя так, как если бы для SheetCollate всегда было задано значение COLLATED.

Атрибут SheetCollate взаимодействует с атрибутом MultipleDocumentHandling. Атрибут MultipleDocumentHandling описывает порядок сортировки целых документов, а атрибут SheetCollate описывает правила сортировки отдельных страниц внутри документа.

Эффект атрибута SheetCollate для задания печати с несколькими документами (задания, содержащего несколько документов) зависит от того, указана ли для всех документов одинаковая сортировка листов или для разных документов указана разная сортировка листов, а также от (возможно, значения по умолчанию) атрибута MultipleDocumentHandling.

  • Если для всех документов указана одинаковая сортировка листов, допускаются следующие сочетания SheetCollate и MultipleDocumentHandling. Если указано любое другое сочетание, принтер сообщает об ошибке при отправке задания:
    • SheetCollate = COLLATED, MultipleDocumentHandling = SINGLE_DOCUMENT -- Все входные документы будут объединены в один выходной документ. Будет создано несколько копий выходного документа со страницами в отсортированном порядке, то есть страницы 1, 2, 3, . . ., 1, 2, 3, . . .
    • SheetCollate = COLLATED, MultipleDocumentHandling = SINGLE_DOCUMENT_NEW_SHEET -- Все входные документы будут объединены в один выходной документ, причем первая страница каждого входного документа всегда будет начинаться на новом листе носителя. Будет создано несколько копий выходного документа со страницами в отсортированном порядке, то есть страницы 1, 2, 3, . . ., 1, 2, 3, . . .
    • SheetCollate = COLLATED, MultipleDocumentHandling = SEPARATE_DOCUMENTS_UNCOLLATED_COPIES -- Каждый входной документ останется отдельным выходным документом. Будет создано несколько копий каждого выходного документа (обозначим их A, B, . . .); страницы каждого документа будут расположены в отсортированном порядке, а сами документы — в несортированном порядке, то есть страницы A1, A2, A3, . . ., A1, A2, A3, . . ., B1, B2, B3, . . ., B1, B2, B3, . . .
    • SheetCollate = COLLATED, MultipleDocumentHandling = SEPARATE_DOCUMENTS_COLLATED_COPIES -- Каждый входной документ останется отдельным выходным документом. Будет создано несколько копий каждого выходного документа (обозначим их A, B, . . .); страницы каждого документа будут расположены в отсортированном порядке, и сами документы также будут расположены в отсортированном порядке, то есть страницы A1, A2, A3, . . ., B1, B2, B3, . . ., A1, A2, A3, . . ., B1, B2, B3, . . .
    • SheetCollate = UNCOLLATED, MultipleDocumentHandling = SINGLE_DOCUMENT -- Все входные документы будут объединены в один выходной документ. Будет создано несколько копий выходного документа со страницами в несортированном порядке, то есть страницы 1, 1, . . ., 2, 2, . . ., 3, 3, . . .
    • SheetCollate = UNCOLLATED, MultipleDocumentHandling = SINGLE_DOCUMENT_NEW_SHEET -- Все входные документы будут объединены в один выходной документ, причем первая страница каждого входного документа всегда будет начинаться на новом листе носителя. Будет создано несколько копий выходного документа со страницами в несортированном порядке, то есть страницы 1, 1, . . ., 2, 2, . . ., 3, 3, . . .
    • SheetCollate = UNCOLLATED, MultipleDocumentHandling = SEPARATE_DOCUMENTS_UNCOLLATED_COPIES -- Каждый входной документ останется отдельным выходным документом. Будет создано несколько копий каждого выходного документа (обозначим их A, B, . . .); страницы каждого документа будут расположены в несортированном порядке, и сами документы также будут расположены в несортированном порядке, то есть страницы A1, A1, . . ., A2, A2, . . ., A3, A3, . . ., B1, B1, . . ., B2, B2, . . ., B3, B3, . . .
  • Если для разных документов указана разная сортировка листов, допускается только одно значение MultipleDocumentHandling. Если указано любое другое значение, принтер сообщает об ошибке при отправке задания:
    • MultipleDocumentHandling = SEPARATE_DOCUMENTS_UNCOLLATED_COPIES -- Каждый входной документ останется отдельным выходным документом. Будет создано несколько копий каждого выходного документа (обозначим их A, B, . . .); страницы каждого документа будут расположены в отсортированном или несортированном порядке в соответствии со значением атрибута SheetCollate соответствующего входного документа, а сами документы будут расположены в несортированном порядке. Если для документа A задано SheetCollate = UNCOLLATED, а для документа B — SheetCollate = COLLATED, будут созданы следующие страницы: A1, A1, . . ., A2, A2, . . ., A3, A3, . . ., B1, B2, B3, . . ., B1, B2, B3, . . .

Совместимость с IPP: в настоящее время SheetCollate не является атрибутом IPP.

См. также:
  • MultipleDocumentHandling
  • Сериализованная форма

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

Модификатор и тип Поле Описание
static final SheetCollate COLLATED
При печати нескольких копий листы внутри документа располагаются в отсортированном порядке.
static final SheetCollate UNCOLLATED
При печати нескольких копий листы внутри документа располагаются в несортированном порядке.

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

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

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

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

Методы, объявленные в классе 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, либо до истечения заданного промежутка реального времени.

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

UNCOLLATED

public static final SheetCollate UNCOLLATED
При печати нескольких копий листы внутри документа располагаются в несортированном порядке.

COLLATED

public static final SheetCollate COLLATED
При печати нескольких копий листы внутри документа располагаются в отсортированном порядке.

Подробное описание конструкторов

SheetCollate

protected SheetCollate(int value)
Создает новое значение перечисления сортировки листов с заданным целочисленным значением.
Параметры:
value — целочисленное значение

Подробное описание методов

getStringTable

protected String[] getStringTable()
Возвращает таблицу строк для класса SheetCollate.
Переопределяет:
getStringTable в классе EnumSyntax
Возвращает:
таблицу строк

getEnumValueTable

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

getCategory

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

Для класса SheetCollate категорией является сам класс SheetCollate.

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

getName

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

Для класса SheetCollate именем категории является "sheet-collate".

Определено в:
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