Spec-Zone.ru › OpenJDK 27

Класс Finishings

java.lang.Object
javax.print.attribute.EnumSyntax
javax.print.attribute.standard.Finishings
Все реализуемые интерфейсы:
Serializable, Cloneable, Attribute, DocAttribute, PrintJobAttribute, PrintRequestAttribute
public class Finishings extends EnumSyntax implements DocAttribute, PrintRequestAttribute, PrintJobAttribute
Класс Finishings — это класс атрибутов печати, перечисление, которое указывает, выполняет ли принтер для каждой копии каждого печатаемого в задании документа какую-либо операцию финишной обработки, например переплёт. Для заданий печати с несколькими документами (заданий, содержащих несколько документов) атрибут MultipleDocumentHandling определяет, что считается «копией» для целей финишной обработки.

Стандартные значения Finishings:

  • NONE
  • STAPLE
  • EDGE_STITCH
  • BIND
  • SADDLE_STITCH
  • COVER

Следующие значения Finishings более конкретны: они указывают угол или край так, как если бы документ был книжной ориентации:

  • STAPLE_TOP_LEFT
  • EDGE_STITCH_LEFT
  • STAPLE_DUAL_LEFT
  • STAPLE_BOTTOM_LEFT
  • EDGE_STITCH_TOP
  • STAPLE_DUAL_TOP
  • STAPLE_TOP_RIGHT
  • EDGE_STITCH_RIGHT
  • STAPLE_DUAL_RIGHT
  • STAPLE_BOTTOM_RIGHT
  • EDGE_STITCH_BOTTOM
  • STAPLE_DUAL_BOTTOM

Значения STAPLE_XXX задаются относительно документа так, как если бы он имел книжную ориентацию. Если документ фактически имеет альбомную или обратную альбомную ориентацию, клиент передаёт соответствующее преобразованное значение. Например, чтобы расположить скобу в верхнем левом углу альбомного документа при его положении для чтения, клиент передаёт значение STAPLE_BOTTOM_LEFT (поскольку альбомная ориентация определяется как поворот на +90 градусов относительно книжной, то есть против часовой стрелки). В свою очередь, чтобы расположить скобу в верхнем левом углу документа с обратной альбомной ориентацией при его положении для чтения, клиент передаёт значение STAPLE_TOP_RIGHT (поскольку обратная альбомная ориентация определяется как поворот на -90 градусов относительно книжной, то есть по часовой стрелке).

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

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

  • Если для всех документов задан одинаковый переплёт, то допустимо любое значение MultipleDocumentHandling, а обработка принтером зависит от значения MultipleDocumentHandling:
    • SINGLE_DOCUMENT — все входные документы будут переплетены вместе в один выходной документ с указанным типом переплёта.
    • SINGLE_DOCUMENT_NEW_SHEET — все входные документы будут переплетены вместе в один выходной документ с указанным типом переплёта, причём первая страница каждого входного документа всегда будет начинаться на новом листе носителя.
    • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES — каждый входной документ будет переплетён отдельно с указанным типом переплёта.
    • SEPARATE_DOCUMENTS_COLLATED_COPIES — каждый входной документ будет переплетён отдельно с указанным типом переплёта.
  • Если для разных документов заданы разные варианты переплёта, то допустимы только два значения MultipleDocumentHandling; при указании любого другого значения принтер сообщает об ошибке при отправке задания:
    • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES — каждый входной документ будет переплетён отдельно с указанным для него типом переплёта.
    • SEPARATE_DOCUMENTS_COLLATED_COPIES — каждый входной документ будет переплетён отдельно с указанным для него типом переплёта.

Совместимость с IPP: Класс Finishings инкапсулирует некоторые значения перечисления IPP, которые могут включаться в атрибут IPP «finishings», представляющий собой набор значений перечисления. Имя категории, возвращаемое методом getName(), является именем атрибута IPP. Целочисленное значение перечисления соответствует значению перечисления IPP. Метод toString() возвращает строковое представление значения атрибута в IPP. В IPP Finishings является атрибутом с несколькими значениями, однако данный API в настоящее время позволяет указать только один вариант переплёта.

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

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

Модификатор и тип Поле Описание
static final Finishings BIND
Это значение указывает, что к документу следует применить переплёт; его тип и расположение определяются конкретной системой.
static final Finishings COVER
Это значение указывается, если для документа требуется выбрать непечатную (или предварительно отпечатанную) обложку.
static final Finishings EDGE_STITCH
Переплести документ(ы) одной или несколькими скобами (проволочными скрепками) вдоль одного края.
static final Finishings EDGE_STITCH_BOTTOM
Переплести документ(ы) одной или несколькими скобами (проволочными скрепками) вдоль нижнего края.
static final Finishings EDGE_STITCH_LEFT
Переплести документ(ы) одной или несколькими скобами (проволочными скрепками) вдоль левого края.
static final Finishings EDGE_STITCH_RIGHT
Переплести документ(ы) одной или несколькими скобами (проволочными скрепками) вдоль правого края.
static final Finishings EDGE_STITCH_TOP
Переплести документ(ы) одной или несколькими скобами (проволочными скрепками) вдоль верхнего края.
static final Finishings NONE
Не выполнять переплёт.
static final Finishings SADDLE_STITCH
Переплести документ(ы) одной или несколькими скобами (проволочными скрепками) вдоль центрального сгиба.
static final Finishings STAPLE
Переплести документ(ы) одной или несколькими скобами.
static final Finishings STAPLE_BOTTOM_LEFT
Переплести документ(ы) одной или несколькими скобами в нижнем левом углу.
static final Finishings STAPLE_BOTTOM_RIGHT
Переплести документ(ы) одной или несколькими скобами в нижнем правом углу.
static final Finishings STAPLE_DUAL_BOTTOM
Переплести документ(ы) двумя скобами (проволочными скрепками) вдоль нижнего края, предполагая, что документ имеет книжную ориентацию (см. выше).
static final Finishings STAPLE_DUAL_LEFT
Переплести документ(ы) двумя скобами (проволочными скрепками) вдоль левого края, предполагая, что документ имеет книжную ориентацию (см. выше).
static final Finishings STAPLE_DUAL_RIGHT
Переплести документ(ы) двумя скобами (проволочными скрепками) вдоль правого края, предполагая, что документ имеет книжную ориентацию (см. выше).
static final Finishings STAPLE_DUAL_TOP
Переплести документ(ы) двумя скобами (проволочными скрепками) вдоль верхнего края, предполагая, что документ имеет книжную ориентацию (см. выше).
static final Finishings STAPLE_TOP_LEFT
Переплести документ(ы) одной или несколькими скобами в верхнем левом углу.
static final Finishings STAPLE_TOP_RIGHT
Переплести документ(ы) одной или несколькими скобами в верхнем правом углу.

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

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

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

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

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

clone, getValue, hashCode, readResolve, toString
Модификатор и тип Метод Описание
Object clone()
Возвращает клон этого значения перечисления; для сохранения семантики значений перечисления это тот же объект, что и исходное значение.
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, либо до истечения заданного промежутка реального времени.

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

NONE

public static final Finishings NONE
Не выполнять переплёт.

STAPLE

public static final Finishings STAPLE
Переплести документ(ы) одной или несколькими скобами. Точное количество и расположение скоб определяется конкретной системой.

COVER

public static final Finishings COVER
Это значение указывается, если для документа требуется выбрать непечатную (или предварительно отпечатанную) обложку. Оно не заменяет указание в самом документе на печатную обложку (на материале для обложек).

BIND

public static final Finishings BIND
Это значение указывает, что к документу следует применить переплёт; его тип и расположение определяются конкретной системой.

SADDLE_STITCH

public static final Finishings SADDLE_STITCH
Переплести документ(ы) одной или несколькими скобами (проволочными скрепками) вдоль центрального сгиба. Точное количество и расположение скоб, а также положение центрального сгиба определяются реализацией и/или конкретной системой.

EDGE_STITCH

public static final Finishings EDGE_STITCH
Переплести документ(ы) одной или несколькими скобами (проволочными скрепками) вдоль одного края. Точное количество и расположение скоб определяется реализацией и/или конкретной системой.

STAPLE_TOP_LEFT

public static final Finishings STAPLE_TOP_LEFT
Переплести документ(ы) одной или несколькими скобами в верхнем левом углу.

STAPLE_BOTTOM_LEFT

public static final Finishings STAPLE_BOTTOM_LEFT
Переплести документ(ы) одной или несколькими скобами в нижнем левом углу.

STAPLE_TOP_RIGHT

public static final Finishings STAPLE_TOP_RIGHT
Переплести документ(ы) одной или несколькими скобами в верхнем правом углу.

STAPLE_BOTTOM_RIGHT

public static final Finishings STAPLE_BOTTOM_RIGHT
Переплести документ(ы) одной или несколькими скобами в нижнем правом углу.

EDGE_STITCH_LEFT

public static final Finishings EDGE_STITCH_LEFT
Переплести документ(ы) одной или несколькими скобами (проволочными скрепками) вдоль левого края. Точное количество и расположение скоб определяется реализацией и/или конкретной системой.

EDGE_STITCH_TOP

public static final Finishings EDGE_STITCH_TOP
Переплести документ(ы) одной или несколькими скобами (проволочными скрепками) вдоль верхнего края. Точное количество и расположение скоб определяется реализацией и/или конкретной системой.

EDGE_STITCH_RIGHT

public static final Finishings EDGE_STITCH_RIGHT
Переплести документ(ы) одной или несколькими скобами (проволочными скрепками) вдоль правого края. Точное количество и расположение скоб определяется реализацией и/или конкретной системой.

EDGE_STITCH_BOTTOM

public static final Finishings EDGE_STITCH_BOTTOM
Переплести документ(ы) одной или несколькими скобами (проволочными скрепками) вдоль нижнего края. Точное количество и расположение скоб определяется реализацией и/или конкретной системой.

STAPLE_DUAL_LEFT

public static final Finishings STAPLE_DUAL_LEFT
Переплести документ(ы) двумя скобами (проволочными скрепками) вдоль левого края, предполагая, что документ имеет книжную ориентацию (см. выше).

STAPLE_DUAL_TOP

public static final Finishings STAPLE_DUAL_TOP
Переплести документ(ы) двумя скобами (проволочными скрепками) вдоль верхнего края, предполагая, что документ имеет книжную ориентацию (см. выше).

STAPLE_DUAL_RIGHT

public static final Finishings STAPLE_DUAL_RIGHT
Переплести документ(ы) двумя скобами (проволочными скрепками) вдоль правого края, предполагая, что документ имеет книжную ориентацию (см. выше).

STAPLE_DUAL_BOTTOM

public static final Finishings STAPLE_DUAL_BOTTOM
Переплести документ(ы) двумя скобами (проволочными скрепками) вдоль нижнего края, предполагая, что документ имеет книжную ориентацию (см. выше).

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

Finishings

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

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

getStringTable

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

getEnumValueTable

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

getOffset

protected int getOffset()
Возвращает наименьшее целочисленное значение, используемое классом Finishings.
Переопределяет:
getOffset в классе EnumSyntax
Возвращает:
смещение наименьшего значения перечисления

getCategory

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

Для класса Finishings и любых подклассов, определённых поставщиками, категорией является сам класс Finishings.

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

getName

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

Для класса Finishings и любых подклассов, определённых поставщиками, именем категории является "finishings".

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