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

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

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

Сериализуемый, Атрибут, DocAttribute, PrintJobAttribute, PrintRequestAttribute
```
public final class MediaPrintableArea
extends Object
implements DocAttribute, PrintRequestAttribute, PrintJobAttribute
```
Класс MediaPrintableArea является атрибутом печати, используемым, чтобы отличить печатаемые и непечатаемые области носителей.
Печатаемая область определяется, чтобы быть прямоугольником, в пределах габаритных размеров носители.
Большинство принтеров не может напечатать на всей поверхности носителей, из-за аппаратных ограничений принтера. Этот класс может использоваться, чтобы запросить приемлемые значения для воображаемого задания печати, и запросить область в пределах ограничений печатаемой области использоваться на задании печати.
Чтобы запросить для печатаемой области, клиент должен предоставить подходящий контекст. Не определяя по крайней мере размер носителей, используемых, никакое значимое значение для печатаемой области не может быть получено.
Атрибут не описывается с точки зрения расстояния от края бумаги, частично чтобы подчеркнуть, что этот атрибут весьма зависим из детали носители, но должен быть описан в пределах контекста выбора других атрибутов. Дополнительно обычно более удобно для клиента использовать печатаемую область.
Минимальные поля аппаратных средств не являются только свойством принтера, но и могут быть функцией размера носителей, ориентации, типа носителя, и любой определил finishings. PrintService обеспечивает метод, чтобы запросить поддерживаемые значения атрибута в подходящем контексте: См. PrintService.getSupportedAttributeValues()
Прямоугольная печатаемая область определяется таким образом: (x, y) источник располагается в верхнюю левую из бумаги в режиме портрета независимо от ориентации, определенной в контексте запроса. Например у печатаемой области для листа А4 в портретной или альбомной ориентации будет высота> ширина.
Значения атрибута печатаемой области сохранены внутренне как целые числа в модулях микрометров (µ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).
Совместимость IPP: MediaPrintableArea не является атрибутом IPP.

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

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

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

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

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

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

Методы
Модификатор и Тип	Метод и Описание
`boolean`	`equals(Object object)` Возвраты, эквивалентен ли этот атрибут полей носителей переданному в объекте.
`Class<? extends Attribute>`	`getCategory()` Получите класс атрибута печати, который должен использоваться в качестве "категории" для этого значения атрибута печати.
`float`	`getHeight(int units)` Получите высоту печатаемой области в указанных модулях.
`Строка`	`getName()` Получите имя категории, которой это значение атрибута является экземпляром.
`float[]`	`getPrintableArea(int units)` Получите печатаемую область как массив 4 значений в порядке x, y, w, h.
`float`	`getWidth(int units)` Получите ширину печатаемой области в указанных модулях.
`float`	`getX(int units)` Получите x расположение источника печатаемой области в указанных модулях.
`float`	`getY(int units)` Получите y расположение источника печатаемой области в указанных модулях.
`int`	`hashCode()` Возвращает значение хэш-кода для этого атрибута.
`Строка`	`toString()` Возвращает строковую версию этого прямоугольного атрибута размера в MMS.
`Строка`	`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).
    
    См. Также:
    Постоянные Значения полей
- Деталь конструктора
  - MediaPrintableArea
```
public MediaPrintableArea(float x,
                  float y,
                  float w,
                  float h,
                  int units)
```
    Создает объект MediaPrintableArea из значений с плавающей точкой.
    
    Параметры:
    x - печатаемый x
    y - печатаемый y
    w - печатаемая ширина
    h - печатаемая высота
    units - в котором выражаются значения.
    
    Броски:
    
    IllegalArgumentException - Брошенный, если x < 0 or y < 0 or w <= 0 or h <= 0 or модули < 1.
  - MediaPrintableArea
```
public MediaPrintableArea(int x,
                  int y,
                  int w,
                  int h,
                  int units)
```
    Создает объект MediaPrintableArea из целочисленных значений.
    
    Параметры:
    x - печатаемый x
    y - печатаемый y
    w - печатаемая ширина
    h - печатаемая высота
    units - в котором выражаются значения.
    
    Броски:
    
    IllegalArgumentException - Брошенный, если x < 0 or y < 0 or w <= 0 or h <= 0 or модули < 1.
- Деталь метода
  - getPrintableArea
```
public float[] getPrintableArea(int units)
```
    Получите печатаемую область как массив 4 значений в порядке x, y, w, h. Возвращенные значения находятся в данных модулях.
    
    Параметры:
    units - Коэффициент преобразования модуля, например. INCH или MM.
    
    Возвраты:
    печатаемая область как массив x, y, w, h в указанных модулях.
    
    Броски:
    
    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.
  - getWidth
```
public float getWidth(int units)
```
    Получите ширину печатаемой области в указанных модулях.
    
    Параметры:
    units - Коэффициент преобразования модуля, например. INCH или MM.
    
    Возвраты:
    ширина печатаемой области в указанных модулях.
    
    Броски:
    
    IllegalArgumentException - (исключение непроверенное) Брошенный, если units < 1.
  - getHeight
```
public float getHeight(int units)
```
    Получите высоту печатаемой области в указанных модулях.
    
    Параметры:
    units - Коэффициент преобразования модуля, например. INCH или MM.
    
    Возвраты:
    высота печатаемой области в указанных модулях.
    
    Броски:
    
    IllegalArgumentException - (исключение непроверенное) Брошенный, если units < 1.
  - равняется
```
public boolean equals(Object object)
```
    Возвраты, эквивалентен ли этот атрибут полей носителей переданному в объекте. Чтобы быть эквивалентными, все следующие условия должны быть истиной:
    1. object не нуль.
    2. object экземпляр класса MediaPrintableArea.
    3. Источник и размерности являются тем же самым.
    Переопределения:
    
    equals в классе Object
    
    Параметры:
    object - Объект сравниться с.
    
    Возвраты:
    Истина, если object эквивалентно этому атрибуту полей носителей, ложь иначе.
    См. Также:
    Object.hashCode(), HashMap
  - getCategory
```
public final Class<? extends Attribute> getCategory()
```
    Получите класс атрибута печати, который должен использоваться в качестве "категории" для этого значения атрибута печати.
    Для класса MediaPrintableArea категория является классом MediaPrintableArea непосредственно.
    
    Определенный:
    
    getCategory в интерфейсе Attribute
    
    Возвраты:
    Печатая класс атрибута (категория), экземпляр класса java.lang.Class.
  - getName
```
public final String getName()
```
    Получите имя категории, которой это значение атрибута является экземпляром.
    Для класса MediaPrintableArea название категории "media-printable-area".
    Это не IPP V1.1 атрибут.
    
    Определенный:
    
    getName в интерфейсе Attribute
    
    Возвраты:
    Название категории атрибута.
  - toString
```
public String toString(int units,
              String unitsName)
```
    Возвращает строковую версию этого прямоугольного атрибута размера в данных модулях.
    
    Параметры:
    units - Коэффициент преобразования модуля, например. INCH или MM.
    unitsName - Модули называют строку, например. "in" или "mm". Если ноль, никакое имя модулей не добавляется к результату.
    
    Возвраты:
    Строковая версия этого двумерного атрибута размера.
    
    Броски:
    
    IllegalArgumentException - (исключение непроверенное) Брошенный, если units < 1.
  - toString
```
public String toString()
```
    Возвращает строковую версию этого прямоугольного атрибута размера в MMS.
    
    Переопределения:
    
    toString в классе Object
    
    Возвраты:
    строковое представление объекта.
  - хэш-код
```
public int hashCode()
```
    Возвращает значение хэш-кода для этого атрибута.
    
    Переопределения:
    
    hashCode в классе Object
    
    Возвраты:
    значение хэш-кода для этого объекта.
    См. Также:
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

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

Класс MediaPrintableArea

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

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

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

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

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

ДЮЙМ

MM

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

MediaPrintableArea

MediaPrintableArea

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

getPrintableArea

getX

getY

getWidth

getHeight

равняется

getCategory

getName

toString

toString

хэш-код