Класс 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 в задаче печати с несколькими документами (задача с несколькими документами) зависит от того, имеют ли все документы одинаковые значения number up или разные, и от (возможно, по умолчанию) значения атрибута MultipleDocumentHandling.

Если все документы имеют одинаковое значение number up 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 — Все входные документы будут объединены в один выходной документ. Каждый оттиск носителя будет состоять из n_i страниц потока печати из выходного документа, где i — номер входного документа, соответствующего этой точке в выходном документе. Когда следующий входной документ имеет другое значение number up, чем предыдущий входной документ, первая страница потока печати следующего входного документа размещается в начале следующего оттиска носителя, возможно, оставляя меньше полного количества страниц потока печати на предыдущем оттиске носителя.
- SINGLE_DOCUMENT_NEW_SHEET — Все входные документы будут объединены в один выходной документ. Каждый оттиск носителя будет состоять из n страниц потока печати из выходного документа. Однако, первый оттиск каждого входного документа всегда будет начинаться на новой странице носителя; это означает, что последний оттиск входного документа может содержать меньше, чем n страниц потока печати.
- SEPARATE_DOCUMENTS_UNCOLLATED_COPIES — Входные документы останутся отдельными. Для входного документа i каждый оттиск носителя будет состоять из n_i страниц потока печати из входного документа. Поскольку входные документы отдельные, первый оттиск каждого входного документа всегда будет начинаться на новой странице носителя; это означает, что последний оттиск входного документа может содержать меньше, чем n_i страниц потока печати.
- SEPARATE_DOCUMENTS_COLLATED_COPIES — Входные документы останутся отдельными. Для входного документа i каждый оттиск носителя будет состоять из n_i страниц потока печати из входного документа. Поскольку входные документы отдельные, первый оттиск каждого входного документа всегда будет начинаться на новой странице носителя; это означает, что последний оттиск входного документа может содержать меньше, чем n_i страниц потока печати.

Совместимость с IPP: Целое значение соответствует целому значению IPP. Имя категории, возвращаемое getName(), соответствует имени атрибута IPP.

См. также:

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

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

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

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object object)`	Возвращает, эквивалентен ли этот атрибут number up переданному объекту.
`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)

Создает новый атрибут number up со заданным целым значением.

Параметры:: value - Целое значение
Исключения:: IllegalArgumentException - если value < 1

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

equals

public boolean equals(Object object)

Возвращает, эквивалентен ли этот атрибут number up переданному объекту. Для эквивалентности должны выполняться все следующие условия:

object не является null.
object является экземпляром класса NumberUp.
Значение этого атрибута number up и значение object равны.

Переопределяет:

equals в классе IntegerSyntax

Параметры:

object - Object для сравнения

Возвращает:

true, если object эквивалентен этому атрибуту number up, false в противном случае

См. также:

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