Класс 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 не является массивом длины один или два. Также, если 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, 2023, 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/21/docs/api/java.desktop/javax/print/attribute/standard/PageRanges.html