Spec-Zone.ru › OpenJDK 17

Класс 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 — Все входные документы будут объединены в один выходной документ. Каждая печать будет состоять из ni страниц потока печати из выходного документа, где i — номер входного документа, соответствующего этому моменту в выходном документе. Когда следующий входной документ имеет другое значение number up, чем предыдущий, первая страница потока печати следующего входного документа будет находиться в начале следующей печати, возможно, оставив меньше, чем полное количество страниц потока печати на предыдущей печати.
    • 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)
Создаёт новый атрибут 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 переданному объекту. Для эквивалентности должны выполняться все следующие условия:
  1. object не null.
  2. object является экземпляром класса NumberUp.
  3. Значение этого атрибута number up и значение object равны.
Переопределяет:
equals в классе IntegerSyntax
Параметры:
object - объект Object для сравнения
Возвращает:
true если object эквивалентен этому атрибуту number up, 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, 2021, 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/17/docs/api/java.desktop/javax/print/attribute/standard/NumberUp.html

Spec-Zone.ru

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