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

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

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

Сериализуемый, Атрибут, DocAttribute, PrintJobAttribute, PrintRequestAttribute
```
public final class MediaPrintableArea
extends Object
implements DocAttribute, PrintRequestAttribute, PrintJobAttribute
```
Класс MediaPrintableArea является атрибутом печати, используемым, чтобы отличить печатаемые и непечатаемые области носителей.
Печатаемая область определяется, чтобы быть прямоугольником, в пределах габаритных размеров носители.
Большинство принтеров не может напечатать на всей поверхности носителей, из-за аппаратных ограничений принтера. Этот class может использоваться, чтобы запросить приемлемые значения для воображаемого задания печати, и запросить область в пределах ограничений печатаемой области использоваться на задании печати.
Чтобы запросить для печатаемой области, клиент должен предоставить подходящий контекст. Не определяя по крайней мере размер носителей, используемых, никакое значимое значение для печатаемой области не может быть получено.
Атрибут не описывается с точки зрения расстояния от края бумаги, частично чтобы подчеркнуть, что этот атрибут весьма зависим из детали носители, но должен быть описан в пределах контекста выбора других атрибутов. Дополнительно обычно более удобно для клиента использовать печатаемую область.
Минимальные поля аппаратных средств не являются только свойством принтера, но и могут быть функцией размера носителей, ориентации, типа носителей, и любой определил finishings. PrintService обеспечивает метод, чтобы запросить поддерживаемые значения атрибута в подходящем контексте: См. PrintService.getSupportedAttributeValues()
Прямоугольная печатаемая область определяется таким образом: (x, y) источник располагается в верхнюю левую из бумаги в режиме портрета независимо от ориентации, определенной в контексте запроса. Например у печатаемой области для листа А4 в портретной или альбомной ориентации будет height> width.
Значения атрибута печатаемой области сохранены внутренне как целые числа в модулях микрометров (µ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()` Доберитесь печать приписывают class, который должен использоваться в качестве "категории" для этого значения атрибута печати.
`float`	`getHeight(int units)` Получите height печатаемой области в указанных модулях.
`Строка`	`getName()` Получите имя категории, которой это значение атрибута является экземпляром.
`float[]`	`getPrintableArea(int units)` Получите печатаемую область как массив 4 значений в порядке x, y, w, h.
`float`	`getWidth(int units)` Получите width печатаемой области в указанных модулях.
`float`	`getX(int units)` Получите x расположение источника печатаемой области в указанных модулях.
`float`	`getY(int units)` Получите y расположение источника печатаемой области в указанных модулях.
`int`	`hashCode()` Возвращает значение хэш-кода для этого атрибута.
`Строка`	`toString()` Возвращает строковую версию этого прямоугольного атрибута размера в MMS.
`Строка`	`toString(int units, String unitsName)` Возвращает строковую версию этого прямоугольного атрибута размера в данных модулях.

Методы, наследованные от class 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 - печатаемый width
    
    h - печатаемый height
    
    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 - печатаемый width
    
    h - печатаемый height
    
    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)
```
    Получите width печатаемой области в указанных модулях.
    
    Параметры:
    
    units - Коэффициент преобразования модуля, например. INCH или MM.
    
    Возвраты:
    
    width печатаемой области в указанных модулях.
    
    Броски:
    
    IllegalArgumentException - (исключение непроверенное) Брошенный, если units < 1.
  - getHeight
```
public float getHeight(int units)
```
    Получите height печатаемой области в указанных модулях.
    
    Параметры:
    
    units - Коэффициент преобразования модуля, например. INCH или MM.
    
    Возвраты:
    
    height печатаемой области в указанных модулях.
    
    Броски:
    
    IllegalArgumentException - (исключение непроверенное) Брошенный, если units < 1.
  - равняется
```
public boolean equals(Object object)
```
    Возвраты, эквивалентен ли этот атрибут полей носителей переданному в объекте. Чтобы быть эквивалентными, все следующие условия должны быть истиной:
    1. object не нуль.
    2. object экземпляр class MediaPrintableArea.
    3. Источник и размерности являются тем же самым.
    Переопределения:
    
    equals в class Object
    
    Параметры:
    
    object - Объект сравниться с.
    
    Возвраты:
    
    Истина, если object эквивалентно этому атрибуту полей носителей, ложь иначе.
    
    См. Также:
    
    Object.hashCode(), HashMap
  - getCategory
```
public final Class<? extends Attribute> getCategory()
```
    Доберитесь печать приписывают class, который должен использоваться в качестве "категории" для этого значения атрибута печати.
    Для class MediaPrintableArea категорией является class MediaPrintableArea непосредственно.
    
    Определенный:
    
    getCategory в интерфейсе Attribute
    
    Возвраты:
    
    Печатая атрибут class (категория), экземпляр class java.lang.Class.
  - getName
```
public final String getName()
```
    Получите имя категории, которой это значение атрибута является экземпляром.
    Для class 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 в class Object
    
    Возвраты:
    
    строковое представление объекта.
  - хэш-код
```
public int hashCode()
```
    Возвращает значение хэш-кода для этого атрибута.
    
    Переопределения:
    
    hashCode в class Object
    
    Возвраты:
    
    значение хэш-кода для этого объекта.
    
    См. Также:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

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

Класс MediaPrintableArea

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

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

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

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

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

ДЮЙМ

MM

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

MediaPrintableArea

MediaPrintableArea

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

getPrintableArea

getX

getY

getWidth

getHeight

равняется

getCategory

getName

toString

toString

хэш-код