Класс 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

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

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

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

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/print/attribute/standard/PageRanges.html