Spec-Zone.ru › OpenJDK 24

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

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

clone, getOffset, getValue, hashCode, readResolve, toString

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

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

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

НЕСВЯЗАННЫЕ

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

СВЯЗАННЫЕ

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
Возвращает:
имя категории атрибута

© 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/print/attribute/standard/SheetCollate.html

Spec-Zone.ru

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