Spec-Zone.ru › OpenJDK 8

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

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

static SheetCollate UNCOLLATED

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

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

Модификатор Конструктор и описание
protected SheetCollate(int value)

Создаёт новое значение перечисления сортировки листов с заданным целочисленным значением.

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

Модификатор и тип Метод и описание
Class<? extends Attribute> getCategory()

Получить класс атрибутов печати, который должен использоваться в качестве «категории» для этого значения атрибута печати.

protected EnumSyntax[] getEnumValueTable()

Возвращает таблицу значений перечисления для класса SheetCollate.

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

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

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

© 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.

Spec-Zone.ru

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