Класс PageRanges

java.lang.Object

javax.print.attribute.SetOfIntegerSyntax

javax.print.attribute.standard.PageRanges

Все реализуемые интерфейсы:: Serializable, Cloneable, Attribute, DocAttribute, PrintJobAttribute, PrintRequestAttribute

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

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

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

Если для задания печати не указан атрибут 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 «page-ranges». Объяснение канонической формы массива см. в классе SetOfIntegerSyntax. Имя категории, возвращаемое getName(), задаёт имя атрибута IPP.

См. также:

Краткое описание конструкторов

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

Краткое описание методов

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

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

contains, contains, getMembers, hashCode, next, toString

Модификатор и тип	Метод	Описание
`boolean`	`contains(int x)`	Определяет, содержит ли этот атрибут множества целых чисел указанное значение.
`boolean`	`contains(IntegerSyntax attribute)`	Определяет, содержит ли этот атрибут множества целых чисел значение указанного целочисленного атрибута.
`int[][]`	`getMembers()`	Возвращает элементы этого атрибута множества целых чисел в канонической форме массива.
`int`	`hashCode()`	Возвращает значение хеш-кода для этого атрибута множества целых чисел.
`int`	`next(int x)`	Определяет наименьшее целое число в этом атрибуте множества целых чисел, которое больше указанного значения.
`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, либо до истечения заданного промежутка реального времени.

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

PageRanges

public PageRanges(int[][] members)

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

Параметры:: members — элементы множества в форме массива
Исключения:: NullPointerException — если members равно null или любой элемент members равен null; IllegalArgumentException — если какой-либо элемент members не является массивом длины один или два. Также если members — массив нулевой длины или любой элемент множества меньше 1.

PageRanges

public PageRanges(String members)

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

Параметры:: members — элементы множества в строковом представлении
Исключения:: NullPointerException — если members равно null или любой элемент members равен null; IllegalArgumentException — если members не соответствует требуемому синтаксису. Также если построенное множество целых чисел является массивом нулевой длины или любой элемент множества меньше 1.

PageRanges

public PageRanges(int member)

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

Параметры:: member — элемент множества
Исключения:: IllegalArgumentException — если member < 1

PageRanges

public PageRanges(int lowerBound, int upperBound)

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

Параметры:: lowerBound — нижняя граница диапазона; upperBound — верхняя граница диапазона
Исключения:: IllegalArgumentException — если указан диапазон null или диапазон non-null, в котором lowerBound меньше 1

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

equals

public boolean equals(Object object)

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

object не равен null.
object является экземпляром класса PageRanges.
Элементы этого атрибута диапазонов страниц совпадают с элементами object.

Переопределяет:

equals в классе SetOfIntegerSyntax

Параметры:

object — Object для сравнения

Возвращает:

true, если object эквивалентен этому атрибуту диапазонов страниц, в противном случае — false

См. также:

getCategory

public final Class<? extends Attribute> getCategory()

Возвращает класс атрибута печати, используемый в качестве «категории» для этого значения атрибута печати.

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

Определено в:: getCategory в интерфейсе Attribute
Возвращает:: класс атрибута печати (категория), экземпляр класса java.lang.Class

getName

public final String getName()

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

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

Определено в:: 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.