Spec-Zone.ru › OpenJDK 21

Класс NumberUp

java.lang.Object
javax.print.attribute.IntegerSyntax
javax.print.attribute.standard.NumberUp
Все реализуемые интерфейсы:
Serializable, Cloneable, Attribute, DocAttribute, PrintJobAttribute, PrintRequestAttribute 
public final class NumberUp extends IntegerSyntax implements DocAttribute, PrintRequestAttribute, PrintJobAttribute
Класс NumberUp — это класс целочисленного атрибута печати, который указывает количество страниц потока печати, которые необходимо наложить на одну сторону экземпляра выбранного носителя. То есть, если значение NumberUp равно n, принтер должен разместить n страниц потока печати на одной стороне экземпляра выбранного носителя. Для этого принтер может добавить какой-либо вид преобразования, масштабирования или поворота. Этот атрибут в основном управляет преобразованием, масштабированием и поворотом страниц потока печати.

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

  • Если все документы имеют одинаковое значение NumberUp n, то любое значение атрибута MultipleDocumentHandling имеет смысл, и обработка принтера зависит от значения MultipleDocumentHandling:
    • SINGLE_DOCUMENT — все входные документы будут объединены в один выходной документ. Каждый отпечаток носителя будет состоять из n страниц потока печати из выходного документа.
    • SINGLE_DOCUMENT_NEW_SHEET — все входные документы будут объединены в один выходной документ. Каждый отпечаток носителя будет состоять из n страниц потока печати из выходного документа. Однако первый отпечаток каждого входного документа всегда будет начинаться на новой странице носителя; это означает, что на последнем отпечатке входного документа может быть меньше n страниц потока печати.
    • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES — входные документы останутся отдельными. Каждый отпечаток носителя будет состоять из n страниц потока печати из входного документа. Поскольку входные документы отдельные, первый отпечаток каждого входного документа всегда будет начинаться на новой странице носителя; это означает, что на последнем отпечатке входного документа может быть меньше n страниц потока печати.
    • SEPARATE_DOCUMENTS_COLLATED_COPIES — входные документы останутся отдельными. Каждый отпечаток носителя будет состоять из n страниц потока печати из входного документа. Поскольку входные документы отдельные, первый отпечаток каждого входного документа всегда будет начинаться на новой странице носителя; это означает, что на последнем отпечатке входного документа может быть меньше n страниц потока печати.
    • SINGLE_DOCUMENT — все входные документы будут объединены в один выходной документ. Каждый отпечаток носителя будет состоять из ni страниц потока печати из выходного документа, где i — номер входного документа, соответствующий этому моменту в выходном документе. Когда следующий входной документ имеет другое значение NumberUp, чем предыдущий входной документ, первая страница потока печати следующего входного документа располагается в начале следующего отпечатка носителя, возможно, оставляя меньше полного числа страниц потока печати на предыдущем отпечатке носителя.
    • SINGLE_DOCUMENT_NEW_SHEET — все входные документы будут объединены в один выходной документ. Каждый отпечаток носителя будет состоять из n страниц потока печати из выходного документа. Однако первый отпечаток каждого входного документа всегда будет начинаться на новой странице носителя; это означает, что на последнем отпечатке входного документа может быть меньше n страниц потока печати.
    • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES — входные документы останутся отдельными. Для входного документа i каждый отпечаток носителя будет состоять из ni страниц потока печати из входного документа. Поскольку входные документы отдельные, первый отпечаток каждого входного документа всегда будет начинаться на новой странице носителя; это означает, что на последнем отпечатке входного документа может быть меньше ni страниц потока печати.
    • SEPARATE_DOCUMENTS_COLLATED_COPIES — входные документы останутся отдельными. Для входного документа i каждый отпечаток носителя будет состоять из ni страниц потока печати из входного документа. Поскольку входные документы отдельные, первый отпечаток каждого входного документа всегда будет начинаться на новой странице носителя; это означает, что на последнем отпечатке входного документа может быть меньше ni страниц потока печати.
Совместимость с IPP: Целое значение соответствует целому значению IPP. Имя категории, возвращаемое getName(), соответствует имени атрибута IPP.
См. также:
  • Сериализованная форма

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

Конструктор Описание
NumberUp(int value)
Создаёт новый атрибут NumberUp с заданным целочисленным значением.

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

Модификатор и тип Метод Описание
boolean equals(Object object)
Возвращает, эквивалентен ли этот атрибут NumberUp переданному объекту.
final Class<? extends Attribute> getCategory()
Получает класс атрибута печати, который будет использоваться в качестве «категории» для этого значения атрибута печати.
final String getName()
Получает имя категории, экземпляром которой является данное значение атрибута.

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

getValue, hashCode, toString

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

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

NumberUp

public NumberUp(int value)
Создаёт новый атрибут NumberUp с заданным целочисленным значением.
Параметры:
value - Целочисленное значение
Исключения:
IllegalArgumentException - если value < 1

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

equals

public boolean equals(Object object)
Возвращает, эквивалентен ли этот атрибут NumberUp переданному объекту. Для эквивалентности должны выполняться все следующие условия:
  1. object не null.
  2. object является экземпляром класса NumberUp.
  3. Значение этого атрибута NumberUp и значение object равны.
Переопределяет:
equals в классе IntegerSyntax
Параметры:
object - Object для сравнения
Возвращает:
true если object эквивалентен этому атрибуту NumberUp, false в противном случае
См. также:
  • Object.hashCode()
  • HashMap

getCategory

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

Для класса NumberUp, категорией является сам класс NumberUp.

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

getName

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

Для класса NumberUp, именем категории является "number-up".

Установлено в:
getName в интерфейсе Attribute
Возвращает:
имя категории атрибута

© 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/NumberUp.html

Spec-Zone.ru

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