Класс 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

Модификатор и тип	Поле	Описание
`static final int`	`INCH`	Значение, указывающее единицы измерения в дюймах (in).
`static final int`	`MM`	Значение, указывающее единицы измерения в миллиметрах (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

Модификатор и тип	Метод	Описание
`float[]`	`getSize(int units)`	Возвращает размеры этого атрибута двумерного размера в заданных единицах в виде значений с плавающей запятой.
`float`	`getX(int units)`	Возвращает размер `X` этого атрибута двумерного размера в заданных единицах в виде значения с плавающей запятой.
`protected int`	`getXMicrometers()`	Возвращает размер `X` этого атрибута двумерного размера в микрометрах (µm).
`float`	`getY(int units)`	Возвращает размер `Y` этого атрибута двумерного размера в заданных единицах в виде значения с плавающей запятой.
`protected int`	`getYMicrometers()`	Возвращает размер `Y` этого атрибута двумерного размера в микрометрах (µm).
`int`	`hashCode()`	Возвращает хеш-код этого атрибута двумерного размера.
`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, либо до истечения указанного интервала реального времени.

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

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.