javax.print.attribute.standard

Класс PageRanges

java.lang. Объект

javax.print.attribute. SetOfIntegerSyntax

javax.print.attribute.standard.PageRanges

Все Реализованные Интерфейсы:

Сериализуемый, Cloneable, Атрибут, DocAttribute, PrintJobAttribute, PrintRequestAttribute

public final class PageRanges
extends SetOfIntegerSyntax
implements DocAttribute, PrintRequestAttribute, PrintJobAttribute

PageRanges класса является классом атрибута печати, ряд целых чисел, который идентифицирует диапазон (ы) страниц потока печати, которые объект Принтера использует для каждой копии каждого документа, которые должны быть напечатаны. Ничто не печатается ни для каких страниц, идентифицированных, которые не существуют в документе (ах). Атрибут связывается со страницами потока печати, не страницами с номером приложения (например, номера страниц, найденные в заголовках и или нижние колонтитулы для определенных приложений обработки текста).

В большинстве случаев точные страницы, которые будут напечатаны, будут сгенерированы драйвером устройства, и этот атрибут не требовался бы. Однако, печатая заархивированный документ, который был уже отформатирован, конечный пользователь может выбрать печатать только подмножество страниц, содержавшихся в документе. В этом случае, если диапазон страницы "n-m" определяется, первая страница, которая будет напечатана, будет страницей n. Все последующие страницы документа будут напечатаны через и включая страницу м.

Если атрибут PageRanges не будет определен для задания печати, то все страницы документа будут напечатаны. Другими словами значение по умолчанию для атрибута PageRanges всегда {{1, Integer.MAX_VALUE}}.

Эффект атрибута PageRanges на задании печати мультидокумента (задание с многократными документами) зависит от того, есть ли у всех документов те же самые определенные диапазоны страницы или определили ли различным документам различные диапазоны страницы, и на (возможно, принимал значение по умолчанию), значение MultipleDocumentHandling атрибут.

• Если у всех документов есть те же самые определенные диапазоны страницы, то какое-либо значение MultipleDocumentHandling имеет смысл, и обработка принтера зависит от MultipleDocumentHandling значение:
  • SINGLE_DOCUMENT - Все входные документы будут объединены вместе в один выходной документ. Указанные диапазоны страницы того выходного документа будут напечатаны.

  • SINGLE_DOCUMENT_NEW_SHEET - Все входные документы будут объединены вместе в один выходной документ, и первое впечатление от каждого входного документа будет всегда запускаться на новом листе носителей. Указанные диапазоны страницы того выходного документа будут напечатаны.

  • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES - Для каждого отдельного входного документа, указанные диапазоны страницы будут напечатаны.

  • SEPARATE_DOCUMENTS_COLLATED_COPIES - Для каждого отдельного входного документа, указанные диапазоны страницы будут напечатаны.
  • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES - Для каждого отдельного входного документа, его собственные указанные диапазоны страницы будут напечатаны..

  • SEPARATE_DOCUMENTS_COLLATED_COPIES - Для каждого отдельного входного документа, его собственные указанные диапазоны страницы будут напечатаны..

Совместимость IPP: каноническая форма массива атрибута PageRanges дает нижнюю и верхнюю границу для каждого диапазона страниц, которые будут включены в и атрибут "диапазонов страницы" IPP. См. класс SetOfIntegerSyntax для объяснения канонической формы массива. Название категории возвратилось getName() дает название атрибута IPP.

См. Также:

Сериализированная Форма

Сводка конструктора

Конструкторы

Конструктор и Описание
PageRanges(int member) Создайте новый атрибут диапазонов страницы, содержащий единственное целое число.
PageRanges(int[][] members) Создайте новый атрибут диапазонов страницы с данными элементами.
PageRanges(int lowerBound, int upperBound) Создайте новый атрибут диапазонов страницы, содержащий единственный диапазон целых чисел.
PageRanges(String members) Создайте новый атрибут диапазонов страницы с данными элементами в строковой форме.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
boolean	equals(Object object) Возвраты, эквивалентен ли этот атрибут диапазонов страницы переданному в объекте.
Class<? extends Attribute>	getCategory() Получите класс атрибута печати, который должен использоваться в качестве "категории" для этого значения атрибута печати.
Строка	getName() Получите имя категории, которой это значение атрибута является экземпляром.

Методы javax.print.attribute унаследованный от класса. SetOfIntegerSyntax

contains, contains, getMembers, hashCode, next, toString

Методы java.lang унаследованный от класса. Объект

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

Деталь конструктора

PageRanges

public PageRanges(int[][] members)

Создайте новый атрибут диапазонов страницы с данными элементами. Элементы определяются в "форме массива;" см. класс SetOfIntegerSyntax для объяснения формы массива.

Параметры:

members - Элементы множества в форме массива.

Броски:

NullPointerException - (исключение непроверенное) Брошенный, если members нуль или любой элемент members нуль.

IllegalArgumentException - (исключение непроверенное) Брошенный, если любой элемент members не длина один, или длина два выстраивают. Также брошенный, если members массив нулевой длиной или если какой-либо элемент набора - меньше чем 1.

PageRanges

public PageRanges(String members)

Создайте новый атрибут диапазонов страницы с данными элементами в строковой форме. См. класс SetOfIntegerSyntax для объяснения синтаксиса.

Параметры:

members - Элементы множества в строковой форме.

Броски:

NullPointerException - (исключение непроверенное) Брошенный, если members нуль или любой элемент members нуль.

IllegalArgumentException - (Исключение непроверенное) Брошенный, если members не повинуется надлежащему синтаксису. Также брошенный, если созданный набор целого числа является массивом нулевым длиной или если какой-либо элемент набора - меньше чем 1.

PageRanges

public PageRanges(int member)

Создайте новый атрибут диапазонов страницы, содержащий единственное целое число. Таким образом, только одна страница должна быть напечатана.

Параметры:

member - Элемент множества.

Броски:

IllegalArgumentException - (Исключение непроверенное) Брошенный, если member меньше чем 1.

PageRanges

public PageRanges(int lowerBound,
          int upperBound)

Создайте новый атрибут диапазонов страницы, содержащий единственный диапазон целых чисел. Таким образом, только те страницы в одном диапазоне должны быть напечатаны.

Параметры:

lowerBound - Нижняя граница диапазона.

upperBound - Верхняя граница диапазона.

Броски:

IllegalArgumentException - (Исключение непроверенное) Брошенный, если нулевой диапазон определяется или если ненулевой диапазон определяется с lowerBound меньше чем 1.

Деталь метода

равняется

public boolean equals(Object object)

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

1. object не нуль.
2. object экземпляр класса PageRanges.
3. Эта страница располагается элементы атрибута и object's элементы то же самое.

Переопределения:

equals в классе SetOfIntegerSyntax

Параметры:

object - Объект сравниться с.

Возвраты:

Истина, если object эквивалентно этому атрибуту диапазонов страницы, ложь иначе.

См. Также:

Object.hashCode(), HashMap

getCategory

public final Class<? extends Attribute> getCategory()

Получите класс атрибута печати, который должен использоваться в качестве "категории" для этого значения атрибута печати.

Для класса PageRanges категория является классом PageRanges непосредственно.

Определенный:

getCategory в интерфейсе Attribute

Возвраты:

Печатая класс атрибута (категория), экземпляр класса java.lang.Class.

getName

public final String getName()

Получите имя категории, которой это значение атрибута является экземпляром.

Для класса PageRanges название категории "page-ranges".

Определенный:

getName в интерфейсе Attribute

Возвраты:

Название категории атрибута.