Spec-Zone.ru › OpenJDK 25

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

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.
Переопределяет:
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, 2025, 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/print/attribute/standard/Finishings.html

Spec-Zone.ru

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