Spec-Zone.ru › OpenJDK 21

Класс 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 с заданным целым значением.
Parameters:
value - Целое значение

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

getStringTable

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

getEnumValueTable

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

getOffset

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

getCategory

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

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

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

getName

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

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

Specified by:
getName в интерфейсе Attribute
Returns:
имя категории атрибута

© 1993, 2023, 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/21/docs/api/java.desktop/javax/print/attribute/standard/Finishings.html

Spec-Zone.ru

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