Spec-Zone.ru › OpenJDK 17

Класс 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, 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/Finishings.html

Spec-Zone.ru

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