Size2DSyntax (Платформа Java SE 7)

java.lang. Объект
- javax.print.attribute. Size2DSyntax

Все Реализованные Интерфейсы:

Сериализуемый, Cloneable

Прямые Известные Подклассы:

MediaSize
```
public abstract class Size2DSyntax
extends Object
implements Serializable, Cloneable
```
Класс Size2DSyntax является абстрактным базовым классом, обеспечивающим общую реализацию всех атрибутов, обозначающих размер в двух размерностях.
Двумерное значение атрибута размера состоит из двух элементов, X размерностей и размерности Y. Двумерный атрибут размера может быть создан, предоставляя два значения и указывая на модули, в которых измеряются значения. Методы обеспечиваются, чтобы возвратить двумерный размер значения атрибута, указывая на модули, в которых должны быть возвращены значения. Две наиболее распространенных единицы размера являются дюймами (в) и миллиметрами (MMS), и экспортируемые константы INCH и MM обеспечиваются для того, чтобы указали на те модули.
После того, как созданный, двумерное значение атрибута размера является неизменным.
Проект
Двумерный атрибут размера X и значения размерности Y сохранен внутренне как целые числа в модулях микрометров (µm), где 1 микрометр = ^{10-6 метров} = 1/1000 миллиметр = 1/25400 медленно двигается. Это разрешает размерностям быть представленными точно точности 1/1000 MMS (= 1 µm) или дюйм 1/100 (= 254 µm). Если дробные дюймы выражаются в отрицательных полномочиях два, это разрешает размерностям быть представленными точно точности дюйма 1/8 (= 3175 µm), но не 1/16 дюйм (потому что дюйм 1/16 не равняется целому числу µm).
Хранение размерностей внутренне в общих модулях µm позволяет двум атрибутам размера быть сравненными без отношения с модулями, в которых они создавались; например, 8.5 в сравнится равный 215.9 MMS, поскольку они оба сохранены как 215900 µm. Например, служба поиска может соответствовать атрибуты разрешения, основанные на равенстве их сериализированных представлений независимо от модулей, в которых они создавались. Используя целые числа для внутреннего хранения позволяет точным сравнениям равенства быть сделанными, который не был бы гарантирован, если бы внутреннее представление с плавающей точкой использовалось. Отметьте, что, если Вы ищете американскую букву измеренные носители в метрических модулях, необходимо искать размер носителей 215.9 x 279.4 MMS; округляя до интеграла 216 x 279 MMS не будут соответствовать.
Экспортируемая константа INCH фактически коэффициент преобразования, которым можно умножить значение в дюймах, чтобы получить значение в µm. Аналогично, экспортируемая константа MM коэффициент преобразования, которым можно умножить значение в MMS, чтобы получить значение в µm. Клиент может определить значение разрешения в модулях кроме дюймов или MMS, предоставляя его собственный коэффициент преобразования. Однако, начиная с внутренних модулей µm был выбран с поддержкой только внешних модулей дюйма и MMS в памяти, нет никакой гарантии, что коэффициентом преобразования для модулей клиента будет точное целое число. Если коэффициентом преобразования не будет точное целое число, то значения разрешения в модулях клиента не будут сохранены точно.

См. Также:
Сериализированная Форма

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`static int`	`ДЮЙМ` Значение, чтобы указать на модули дюймов (в).
`static int`	`MM` Значение, чтобы указать на модули миллиметров (MMS).

Сводка конструктора

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

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`boolean`	`equals(Object object)` Возвраты, эквивалентен ли этот двумерный атрибут размера переданному в объекте.
`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()` Возвращает значение хэш-кода для этого двумерного атрибута размера.
`Строка`	`toString()` Возвращает строковую версию этого двумерного атрибута размера.
`Строка`	`toString(int units, String unitsName)` Возвращает строковую версию этого двумерного атрибута размера в данных модулях.

Методы java.lang унаследованный от класса. Объект
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Полевая Деталь
  - ДЮЙМ
```
public static final int INCH
```
    Значение, чтобы указать на модули дюймов (в). Это - фактически коэффициент преобразования, которым можно умножить дюймы, чтобы привести к µm (25400).
    
    См. Также:
    Постоянные Значения полей
  - MM
```
public static final int MM
```
    Значение, чтобы указать на модули миллиметров (MMS). Это - фактически коэффициент преобразования, которым можно умножить MMS, чтобы привести к µm (1000).
    
    См. Также:
    Постоянные Значения полей
- Деталь конструктора
  - Size2DSyntax
```
protected Size2DSyntax(float x,
            float y,
            int units)
```
    Создайте новый двумерный атрибут размера из данных значений с плавающей точкой.
    
    Параметры:
    x - X размерностей.
    y - Y размерность.
    units - Коэффициент преобразования модуля, например. INCH или MM.
    
    Броски:
    
    IllegalArgumentException - (Исключение непроверенное) Брошенный, если x < 0 or y < 0 or модули < 1.
  - Size2DSyntax
```
protected Size2DSyntax(int x,
            int y,
            int units)
```
    Создайте новый двумерный атрибут размера из данных целочисленных значений.
    
    Параметры:
    x - X размерностей.
    y - Y размерность.
    units - Коэффициент преобразования модуля, например. INCH или MM.
    
    Броски:
    
    IllegalArgumentException - (Исключение непроверенное) Брошенный, если x < 0 or y < 0 or модули < 1.
- Деталь метода
  - getSize
```
public float[] getSize(int units)
```
    Получите этот двумерный размер размерности атрибута в данных модулях как значения с плавающей точкой.
    
    Параметры:
    units - Коэффициент преобразования модуля, например. INCH или MM.
    
    Возвраты:
    Массив с двумя элементами с X размерностями по индексу 0 и размерностью Y по индексу 1.
    
    Броски:
    
    IllegalArgumentException - (исключение непроверенное) Брошенный, если units < 1.
  - getX
```
public float getX(int units)
```
    Возвраты этот двумерный атрибут размера X размерностей в данных модулях как значение с плавающей точкой.
    
    Параметры:
    units - Коэффициент преобразования модуля, например. INCH или MM.
    
    Возвраты:
    X размерностей.
    
    Броски:
    
    IllegalArgumentException - (исключение непроверенное) Брошенный, если units < 1.
  - getY
```
public float getY(int units)
```
    Возвраты размерность атрибута этого двумерного размера Y в данных модулях как значение с плавающей точкой.
    
    Параметры:
    units - Коэффициент преобразования модуля, например. INCH или MM.
    
    Возвраты:
    Y размерность.
    
    Броски:
    
    IllegalArgumentException - (исключение непроверенное) Брошенный, если units < 1.
  - toString
```
public String toString(int units,
              String unitsName)
```
    Возвращает строковую версию этого двумерного атрибута размера в данных модулях. Строка принимает форму "XxY U", где X X размерностей, Y является размерностью Y, и U является именем модулей. Значения выводятся на экран в плавающей точке.
    
    Параметры:
    units - Коэффициент преобразования модуля, например. INCH или MM.
    unitsName - Модули называют строку, например. "in" или "mm". Если ноль, никакое имя модулей не добавляется к результату.
    
    Возвраты:
    Строковая версия этого двумерного атрибута размера.
    
    Броски:
    
    IllegalArgumentException - (исключение непроверенное) Брошенный, если units < 1.
  - равняется
```
public boolean equals(Object object)
```
    Возвраты, эквивалентен ли этот двумерный атрибут размера переданному в объекте. Чтобы быть эквивалентными, все следующие условия должны быть истиной:
    1. object не нуль.
    2. object экземпляр класса Size2DSyntax.
    3. X размерностей этого атрибута равны object's X размерностей.
    4. Размерность этого атрибута Y равна object's Y размерность.
    Переопределения:
    
    equals в классе Object
    
    Параметры:
    object - Объект сравниться с.
    
    Возвраты:
    Истина, если object эквивалентно этому двумерному атрибуту размера, ложь иначе.
    См. Также:
    Object.hashCode(), HashMap
  - хэш-код
```
public int hashCode()
```
    Возвращает значение хэш-кода для этого двумерного атрибута размера.
    
    Переопределения:
    
    hashCode в классе Object
    
    Возвраты:
    значение хэш-кода для этого объекта.
    См. Также:
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    Возвращает строковую версию этого двумерного атрибута размера. Строка принимает форму "XxY um", где X X размерностей, и Y является размерностью Y. О значениях сообщают во внутренних модулях микрометров.
    
    Переопределения:
    
    toString в классе Object
    
    Возвраты:
    строковое представление объекта.
  - getXMicrometers
```
protected int getXMicrometers()
```
    Возвраты этот двумерный атрибут размера X размерностей в модулях микрометров (µm). (Для использования в подклассе.)
    
    Возвраты:
    X размерностей (µm).
  - getYMicrometers
```
protected int getYMicrometers()
```
    Возвраты размерность атрибута этого двумерного размера Y в модулях микрометров (µm). (Для использования в подклассе.)
    
    Возвраты:
    Y размерность (µm).

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс Size2DSyntax

Полевая Сводка

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Полевая Деталь

ДЮЙМ

MM

Деталь конструктора

Size2DSyntax

Size2DSyntax

Деталь метода

getSize

getX

getY

toString

равняется

хэш-код

toString

getXMicrometers

getYMicrometers