Класс 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()`	Получает имя категории, экземпляром которой является это значение атрибута.

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

contains, contains, getMembers, hashCode, next, toString

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

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

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

PageRanges

public PageRanges(int[][] members)

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

Параметры:: members - члены набора в формате массива
Исключения:: NullPointerException - если members является null или любой элемент members является null; IllegalArgumentException - если любой элемент members не является массивом длины 1 или 2. Также, если 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/print/attribute/standard/PageRanges.html