Класс PrinterResolution

java.lang.Object

javax.print.attribute.ResolutionSyntax

javax.print.attribute.standard.PrinterResolution

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

public final class PrinterResolution extends ResolutionSyntax implements DocAttribute, PrintRequestAttribute, PrintJobAttribute

Класс PrinterResolution — это класс атрибута печати, указывающий точное разрешение, поддерживаемое принтером или используемое для задания печати. Этот атрибут предполагает, что принтеры поддерживают небольшой набор разрешений устройства, а не непрерывный диапазон значений.

PrinterResolution используется несколькими способами:

Если клиент ищет принтер, точно поддерживающий требуемое разрешение (не больше и не меньше), он указывает экземпляр класса PrinterResolution, задающий требуемое разрешение. По результатам поиска будут найдены только принтеры, поддерживающие это точное разрешение.
Если клиенту необходимо выполнить печать задания с точно заданным требуемым разрешением (не больше и не меньше), он указывает экземпляр класса PrinterResolution в качестве атрибута задания печати. Это приведет к ошибке, если задание печати не поддерживает указанное точное разрешение и Fidelity имеет значение true.

Если клиенту требуется найти принтер, поддерживающий разрешение выше некоторого минимально необходимого, может понадобиться исключить этот атрибут из запроса поиска, напрямую запросить набор поддерживаемых разрешений и указать наиболее подходящее из них. В некоторых случаях этого можно проще добиться, указав атрибут PrintQuality, который часто управляет разрешением.

Совместимость с IPP: Информацию, необходимую для создания атрибута IPP "printer-resolution", можно получить, вызывая методы объекта PrinterResolution. Имя категории, возвращаемое методом getName(), задает имя атрибута IPP.

См. также:

Краткое описание полей

Поля, объявленные в классе ResolutionSyntax

DPCM, DPI

Модификатор и тип	Поле	Описание
`static final int`	`DPCM`	Значение, указывающее единицы измерения в точках на сантиметр (dpcm).
`static final int`	`DPI`	Значение, указывающее единицы измерения в точках на дюйм (dpi).

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

Конструктор	Описание
`PrinterResolution(int crossFeedResolution, int feedResolution, int units)`	Создает новый атрибут разрешения принтера на основе заданных значений.

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

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

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

getCrossFeedResolution, getCrossFeedResolutionDphi, getFeedResolution, getFeedResolutionDphi, getResolution, hashCode, lessThanOrEquals, toString, toString

Модификатор и тип	Метод	Описание
`int`	`getCrossFeedResolution(int units)`	Возвращает разрешение этого атрибута в направлении поперечной подачи в заданных единицах измерения.
`protected int`	`getCrossFeedResolutionDphi()`	Возвращает разрешение этого атрибута в направлении поперечной подачи в единицах dphi.
`int`	`getFeedResolution(int units)`	Возвращает разрешение этого атрибута в направлении подачи в заданных единицах измерения.
`protected int`	`getFeedResolutionDphi()`	Возвращает разрешение этого атрибута в направлении подачи в единицах dphi.
`int[]`	`getResolution(int units)`	Возвращает значения разрешения этого атрибута в заданных единицах измерения.
`int`	`hashCode()`	Возвращает хеш-код этого атрибута разрешения.
`boolean`	`lessThanOrEquals(ResolutionSyntax other)`	Определяет, меньше ли или равно значение этого атрибута разрешения значению заданного атрибута разрешения.
`String`	`toString()`	Возвращает строковое представление этого атрибута разрешения.
`String`	`toString(int units, String unitsName)`	Возвращает строковое представление этого атрибута разрешения в заданных единицах измерения.

Методы, объявленные в классе 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, либо до истечения заданного промежутка реального времени.

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

PrinterResolution

public PrinterResolution(int crossFeedResolution, int feedResolution, int units)

Создает новый атрибут разрешения принтера на основе заданных значений.

Параметры:: crossFeedResolution — разрешение в направлении поперечной подачи; feedResolution — разрешение в направлении подачи; units — коэффициент преобразования единиц измерения, например ResolutionSyntax.DPI или ResolutionSyntax.DPCM
Исключения:: IllegalArgumentException — если crossFeedResolution < 1, feedResolution < 1 или units < 1

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

equals

public boolean equals(Object object)

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

object не является null.
object является экземпляром класса PrinterResolution.
Разрешение этого атрибута в направлении поперечной подачи равно разрешению object в направлении поперечной подачи.
Разрешение этого атрибута в направлении подачи равно разрешению object в направлении подачи.

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

equals в классе ResolutionSyntax

Параметры:

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

Возвращает:

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

См. также:

getCategory

public final Class<? extends Attribute> getCategory()

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

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

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

getName

public final String getName()

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

Для класса PrinterResolution именем категории является "printer-resolution".

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