Класс NumberUp

public final class NumberUp
extends IntegerSyntax
implements DocAttribute, PrintRequestAttribute, PrintJobAttribute

Класс NumberUp — это класс целочисленного атрибута печати, который определяет количество страниц потока печати, накладываемых на одну сторону экземпляра выбранного носителя. То есть, если значение NumberUp равно n, принтер должен разместить n страниц потока печати на одной стороне экземпляра выбранного носителя. Для этого принтер может добавить какой-либо вид преобразования, масштабирования или поворота. Этот атрибут в основном управляет преобразованием, масштабированием и поворотом страниц потока печати.

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

• Если все документы имеют одинаковое значение NumberUp, равное 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 — номер входного документа, соответствующий этому моменту в выходном документе. Когда следующий входной документ имеет другое значение NumberUp, чем предыдущий входной документ, первая страница потока печати следующего входного документа расположена в начале следующего отпечатка на носителе, возможно, оставляя меньше, чем полное количество страниц потока печати на предыдущем отпечатке на носителе.
  • 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

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

Возвращает:

имя категории атрибута