Spec-Zone.ru › OpenJDK 25

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

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

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

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, 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/SheetCollate.html

Spec-Zone.ru

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