Spec-Zone.ru › OpenJDK 24

Класс 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
Создать новое значение перечисления привязки отделки с заданным целочисленным значением.

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

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

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

clone, getValue, hashCode, readResolve, toString

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

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

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

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.
Overrides:
getStringTable в классе EnumSyntax
Возвращает:
таблицу строк

getEnumValueTable

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

getOffset

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

getCategory

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

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

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

getName

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

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

Specified by:
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/Finishings.html

Spec-Zone.ru

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