Класс MediaSize

java.lang.Object

javax.print.attribute.Size2DSyntax

javax.print.attribute.standard.MediaSize

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

public class MediaSize extends Size2DSyntax implements Attribute

Класс MediaSize — это класс атрибута печати, содержащий размер в двух измерениях и указывающий размеры носителя в книжной ориентации: измерение X проходит вдоль нижнего края, а измерение Y — вдоль левого края. Таким образом, измерение Y должно быть больше или равно измерению X. Класс MediaSize объявляет множество стандартных значений размеров носителей, сгруппированных во вложенные классы для носителей ISO, JIS, Северной Америки, инженерных и других носителей.

MediaSize пока не используется для указания носителей. В настоящее время он служит отображением для именованных носителей (см. MediaSizeName). Клиенты могут использовать метод отображения MediaSize.getMediaSizeForName(MediaSizeName) для определения физических размеров экземпляров MediaSizeName, перечисленных в этом API. Это полезно клиентам, которым нужны эти сведения для форматирования и разбиения на страницы при печати.

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`static final class`	`MediaSize.Engineering`	Класс `MediaSize.Engineering` содержит значения `MediaSize` для инженерных носителей.
`static final class`	`MediaSize.ISO`	Класс `MediaSize.ISO` содержит значения `MediaSize` для носителей ISO.
`static final class`	`MediaSize.JIS`	Класс `MediaSize.JIS` содержит значения `MediaSize` для носителей JIS (японских).
`static final class`	`MediaSize.NA`	Класс `MediaSize.NA` содержит значения `MediaSize` для носителей Северной Америки.
`static final class`	`MediaSize.Other`	Класс `MediaSize.Other` содержит значения `MediaSize` для прочих носителей.

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

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

INCH, MM

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

Конструктор	Описание
`MediaSize(float x, float y, int units)`	Создает новый атрибут размера носителя из заданных значений с плавающей точкой.
`MediaSize(float x, float y, int units, MediaSizeName media)`	Создает новый атрибут размера носителя из заданных значений с плавающей точкой.
`MediaSize(int x, int y, int units)`	Создает новый атрибут размера носителя из заданных целочисленных значений.
`MediaSize(int x, int y, int units, MediaSizeName media)`	Создает новый атрибут размера носителя из заданных целочисленных значений.

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

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object object)`	Возвращает, эквивалентен ли этот атрибут размера носителя переданному объекту.
`static MediaSizeName`	`findMedia(float x, float y, int units)`	Указанные размеры используются для поиска соответствующего экземпляра `MediaSize` среди всех стандартных экземпляров `MediaSize`.
`final Class<? extends Attribute>`	`getCategory()`	Возвращает класс атрибута печати, используемый в качестве «категории» для этого значения атрибута печати.
`static MediaSize`	`getMediaSizeForName(MediaSizeName media)`	Возвращает `MediaSize` для указанного именованного носителя.
`MediaSizeName`	`getMediaSizeName()`	Возвращает имя носителя, если оно задано для этого размера.
`final String`	`getName()`	Возвращает имя категории, экземпляром которой является это значение атрибута.

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

getSize, getX, getXMicrometers, getY, getYMicrometers, hashCode, toString, toString

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

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

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

MediaSize

public MediaSize(float x, float y, int units)

Создает новый атрибут размера носителя из заданных значений с плавающей точкой.

Параметры:: x — измерение X; y — измерение Y; units — коэффициент преобразования единиц измерения, например Size2DSyntax.INCH или Size2DSyntax.MM
Исключения:: IllegalArgumentException — если x < 0, y < 0, units < 1 или x > y

MediaSize

public MediaSize(int x, int y, int units)

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

Параметры:: x — измерение X; y — измерение Y; units — коэффициент преобразования единиц измерения, например Size2DSyntax.INCH или Size2DSyntax.MM
Исключения:: IllegalArgumentException — если x < 0, y < 0, units < 1 или x > y

MediaSize

public MediaSize(float x, float y, int units, MediaSizeName media)

Создает новый атрибут размера носителя из заданных значений с плавающей точкой.

Параметры:: x — измерение X; y — измерение Y; units — коэффициент преобразования единиц измерения, например Size2DSyntax.INCH или Size2DSyntax.MM; media — имя носителя, связываемое с этим MediaSize
Исключения:: IllegalArgumentException — если x < 0, y < 0, units < 1 или x > y

MediaSize

public MediaSize(int x, int y, int units, MediaSizeName media)

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

Параметры:: x — измерение X; y — измерение Y; units — коэффициент преобразования единиц измерения, например Size2DSyntax.INCH или Size2DSyntax.MM; media — имя носителя, связываемое с этим MediaSize
Исключения:: IllegalArgumentException — если x < 0, y < 0, units < 1 или x > y

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

getMediaSizeName

public MediaSizeName getMediaSizeName()

Возвращает имя носителя, если оно задано для этого размера.

Возвращает:: имя этого размера носителя или null, если этому размеру не было сопоставлено имя (анонимный размер)

getMediaSizeForName

public static MediaSize getMediaSizeForName(MediaSizeName media)

Возвращает MediaSize для указанного именованного носителя.

Параметры:: media — имя носителя, размер которого требуется найти
Возвращает:: размер носителя или null, если с этим носителем не связан никакой размер

findMedia

public static MediaSizeName findMedia(float x, float y, int units)

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

Затем MediaSize используется для поиска объекта MediaSizeName. Этот метод может вернуть null, если для наиболее близкого соответствующего MediaSize не существует соответствующего экземпляра Media.

Этот метод полезен клиентам, которым известны только размеры и которые хотят найти Media, соответствующий этим размерам.

Параметры:: x — измерение X; y — измерение Y; units — коэффициент преобразования единиц измерения, например Size2DSyntax.INCH или Size2DSyntax.MM
Возвращает:: MediaSizeName, соответствующий этим размерам, или null
Исключения:: IllegalArgumentException — если x <= 0, y <= 0 или units < 1

equals

public boolean equals(Object object)

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

object не равен null.
object является экземпляром класса MediaSize.
Измерение X этого атрибута размера носителя равно измерению X объекта object.
Измерение Y этого атрибута размера носителя равно измерению Y объекта object.

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

equals в классе Size2DSyntax

Параметры:

object — объект Object для сравнения

Возвращает:

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

См. также:

getCategory

public final Class<? extends Attribute> getCategory()

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

Для класса MediaSize и любых подклассов, определенных поставщиком, категорией является сам класс MediaSize.

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

getName

public final String getName()

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

Для класса MediaSize и любых подклассов, определенных поставщиком, именем категории является "media-size".

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