java.lang.Object
- javax.print.attribute.standard.MediaPrintableArea

实现的所有接口

Serializable ， Attribute ， DocAttribute ， PrintJobAttribute ， PrintRequestAttribute
```
public final class MediaPrintableArea
extends Object
implements DocAttribute, PrintRequestAttribute, PrintJobAttribute
```
类别MediaPrintableArea是用于区分媒体的可打印和不可打印区域的打印属性。
可打印区域在媒体的整体尺寸内指定为矩形。

由于打印机硬件限制，大多数打印机无法在介质的整个表面上打印。此类可用于查询假定的打印作业的可接受值，并请求在打印作业中使用的可打印区域的约束内的区域。

要查询可打印区域，客户端必须提供合适的上下文。在没有至少指定所使用的介质的尺寸的情况下，不能获得可打印区域的有意义的值。

该属性不是根据与纸张边缘的距离来描述的，部分是为了强调该属性不是独立于特定媒体，而是必须在选择其他属性的上下文中描述。另外，客户端使用可打印区域通常更方便。

硬件的最小边距不仅仅是打印机的属性，还可能是介质尺寸，方向，介质类型和任何指定的装饰的函数。 PrintService提供了在合适的上下文中查询属性的受支持值的方法：请参阅PrintService.getSupportedAttributeValues()

因此定义了矩形可打印区域：无论在请求上下文中指定的方向如何，（x，y）原点都以纵向模式位于纸张的左上角。例如，纵向或横向A4纸的可打印区域将具有高度>宽度。

可打印区域属性的值在内部存储为整数，单位为微米（μm），其中1微米= 10 ^-6米= 1/1000毫米= 1/25400英寸。这允许尺寸精确表示精度为1/1000 mm（=1μm）或1/100英寸（=254μm）。如果分数英寸以2的负幂表示，则允许尺寸精确表示精度为1/8英寸（= 3175微米）但不是1/16英寸（因为1/16英寸不等于整数Âμm）。

IPP兼容性： MediaPrintableArea不是IPP属性。

另请参见：

Serialized Form

字段汇总

字段

变量和类型字段描述

static int INCH
表示英寸（in）单位的值。

static int MM
表示毫米（mm）单位的值。

构造方法摘要

构造方法
构造器	描述
`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)`	返回此媒体边距属性是否等效于传入的对象。
`类<? extends Attribute>`	`getCategory()`	获取将用作此打印属性值的“类别”的打印属性类。
`float`	`getHeight(int units)`	获取指定单位的可打印区域的 `height` 。
`String`	`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()`	返回此属性的哈希码值。
`String`	`toString()`	以mm为单位返回此矩形大小属性的字符串版本。
`String`	`toString(int units, String unitsName)`	以给定单位返回此矩形大小属性的字符串版本。

声明方法的类 java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- 字段详细信息
  - INCH
```
public static final int INCH
```
    表示英寸（in）单位的值。它实际上是乘以英寸以产生Âμm（25400）的转换因子。
    
    另请参见：
    
    常数字段值
  - MM
```
public static final int MM
```
    表示毫米（mm）单位的值。它实际上是将mm乘以屈服μ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或 y < 0或 w <= 0或 h <= 0或 units < 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或 y < 0或 w <= 0或 h <= 0或 units < 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
  - equals
```
public boolean equals(Object object)
```
    返回此媒体边距属性是否等效于传入的对象。为了等效，所有以下条件必须为真：
    
    object不是null 。
    
    object是类MediaPrintableArea的实例。
    
    原点和尺寸是相同的。
    重写：
    
    equals类 Object
    
    参数
    
    object - Object来比较
    
    结果
    
    true如果 object等效于此媒体边距属性， false
    
    另请参见：
    
    Object.hashCode() ， HashMap
  - getCategory
```
public final 类<? extends Attribute> getCategory()
```
    获取将用作此打印属性值的“类别”的打印属性类。
    对于类MediaPrintableArea ，该类别是类MediaPrintableArea本身。
    
    Specified by:
    
    getCategory接口 Attribute
    
    结果
    
    打印属性类（类别），类java.lang.Class的实例
  - getName
```
public final String getName()
```
    获取此属性值为实例的类别的名称。
    对于类MediaPrintableArea ，类别名称为"media-printable-area" 。
    
    这不是IPP V1.1属性。
    
    Specified by:
    
    getName在界面 Attribute
    
    结果
    
    属性类别名称
  - toString
```
public String toString(int units,
                       String unitsName)
```
    以给定单位返回此矩形大小属性的字符串版本。
    
    参数
    
    units - 单位转换因子，例如 INCH或 MM
    
    unitsName - 单位名称字符串，例如"in"或"mm" 。如果是null ，则不会在结果中附加单位名称
    
    结果
    
    这个二维大小属性的字符串版本
    
    异常
    
    IllegalArgumentException - 如果 units < 1
  - toString
```
public String toString()
```
    以mm为单位返回此矩形大小属性的字符串版本。
    
    重写：
    
    toString类 Object
    
    结果
    
    对象的字符串表示形式。
  - hashCode
```
public int hashCode()
```
    返回此属性的哈希码值。
    
    重写：
    
    hashCode类 Object
    
    结果
    
    此对象的哈希码值。
    
    另请参见：
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

变量和类型	字段	描述
`static int`	`INCH`	表示英寸（in）单位的值。
`static int`	`MM`	表示毫米（mm）单位的值。

Class MediaPrintableArea

字段汇总

构造方法摘要

方法摘要

声明方法的类 java.lang.Object

字段详细信息

INCH

MM

构造方法详细信息

MediaPrintableArea

MediaPrintableArea

方法详细信息

getPrintableArea

getX

getY

getWidth

getHeight

equals

getCategory

getName

toString

toString

hashCode