Класс 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 — все входные документы объединяются в один выходной документ. Каждый оттиск на носителе будет содержать 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()`	Возвращает имя категории, экземпляром которой является это значение атрибута.

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

getValue, hashCode, toString

Модификатор и тип	Метод	Описание
`int`	`getValue()`	Возвращает целочисленное значение этого целочисленного атрибута.
`int`	`hashCode()`	Возвращает хеш-код этого целочисленного атрибута.
`String`	`toString()`	Возвращает строковое представление этого целочисленного атрибута.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API планируется удалить в одной из будущих версий. Метод завершения работы устарел и планируется к удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Приостанавливает выполнение текущего потока до его пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Приостанавливает выполнение текущего потока до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает выполнение текущего потока до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного времени.

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

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.