Spec-Zone.ru › OpenJDK 17

Класс 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, 2021, 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/17/docs/api/java.desktop/javax/print/attribute/standard/SheetCollate.html

Spec-Zone.ru

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