Spec-Zone.ru › OpenJDK 25

Класс 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 используется несколькими способами:

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

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

См. также:
  • Сериализованная форма

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

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

DPCM, 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

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

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

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

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)
Возвращает значение, указывающее, эквивалентен ли этот атрибут разрешения принтера переданному объекту. Для эквивалентности должны выполняться все следующие условия:
  1. object не равен null.
  2. object является экземпляром класса PrinterResolution.
  3. Разрешение этого атрибута в направлении поперечной подачи равно разрешению object в направлении поперечной подачи.
  4. Разрешение этого атрибута в направлении подачи равно разрешению object в направлении подачи.
Переопределяет:
equals в классе ResolutionSyntax
Параметры:
object — Object для сравнения
Возвращает:
true, если object эквивалентен этому атрибуту разрешения принтера, иначе false
См. также:
  • Object.hashCode()
  • HashMap

getCategory

public final Class<? extends Attribute> getCategory()
Возвращает класс атрибута печати, который будет использоваться в качестве «категории» для этого значения атрибута печати.

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

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

getName

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

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

Определено в:
getName в интерфейсе Attribute
Возвращает:
имя категории атрибута

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков с концептуальными обзорами, определениями терминов, обходными решениями и примерами работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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/PrinterResolution.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API