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

Если для всех документов указано одинаковое значение number up n, то любое значение MultipleDocumentHandling имеет смысл, а обработка принтером зависит от значения MultipleDocumentHandling:
- SINGLE_DOCUMENT — Все входные документы объединяются в один выходной документ. Каждый оттиск на носителе будет содержать nm страниц потока печати из выходного документа.
- 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)`	Возвращает значение true, если этот атрибут number up эквивалентен переданному объекту.
`final Class<? extends Attribute>`	`getCategory()`	Возвращает класс атрибута печати, который используется в качестве «категории» для этого значения атрибута печати.
`final String`	`getName()`	Возвращает имя категории, экземпляром которой является это значение атрибута.

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

getValue, hashCode, toString

Методы, объявленные в классе 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)

Возвращает значение true, если этот атрибут 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/print/attribute/standard/NumberUp.html