MediaPrintableArea

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.print.attribute.standard
类 MediaPrintableArea

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

所有已实现的接口：: Serializable, Attribute, DocAttribute, PrintJobAttribute, PrintRequestAttribute

public final class MediaPrintableArea
extends Object
implements DocAttribute, PrintRequestAttribute, PrintJobAttribute

MediaPrintableArea 类是打印属性类，用于区分介质的可打印区域和不可打印区域。

可打印区域被指定为介质总维度之内的矩形。

大多数打印机不能在介质的整个表面上打印，这是由于打印机的硬件限制。此类可用于查询所假定的打印作业的可接受值，以及请求要在打印作业中使用的可打印区域的限制之内的某个区域。

要查询可打印区域，客户机必须提供适合的上下文。如果不至少指定要使用的介质尺寸，则不能获取有意义的可打印区域值。

此属性不是根据与纸边的距离描述的，部分是强调此属性不是与特定介质无关的，但必须在其他属性的选择上下文中进行描述。此外，客户机使用可打印区域更为方便。

硬件的最小页边距不仅是打印机的属性，而且是介质尺寸、方向、介质类型和任何指定的 finishing 的函数。PrintService 提供了在适合的上下文中查询支持的属性值的方法：参见 PrintService.getSupportedAttributeValues()

矩形可打印区域定义如下：在纵向模式中，(x,y) 原点位于纸张左上角，与在请求上下文中所指定的方向无关。例如，纵向或横向方向中 A4 纸的可打印区域中， height > width。

可打印区域属性的值以整数值形式进行内部存储，以 micrometers (µm) 为单位，其中 1 micrometer = 10^-6 meter = 1/1000 millimeter = 1/25400 inch。这使要表示的维度精确到 1/1000 毫米 (= 1 µm) 或 1/100 英寸 (= 254 µm)。如果小数 inch 以 2 的负数次幂表示，则这允许将维度精确表示为 1/8 inch (= 3175 µm) 而不是 1/16 inch 的精度（因为 1/16 inch 不等于整数的 µm）。

IPP Compatibility: MediaPrintableArea 不是 IPP 属性。

另请参见：: 序列化表格

字段摘要
`static int`	`INCH` 指示以 inch (in) 为单位的值。
`static int`	`MM` 指示以 millimeters (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)` 返回此介质页边距属性是否等效于传入的对象。
`Class<? extends Attribute>`	`getCategory()` 获取将被用作此打印属性值的“类别”的打印属性类。
`float`	`getHeight(int units)` 以指定单位获取可打印区域的 height。
`String`	`getName()` 获取类别名称，此属性值为该类别的实例。
`float[]`	`getPrintableArea(int units)` 以顺序为 x, y, w, h 的 4 个值的数组形式获取可打印区域。
`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

指示以 inch (in) 为单位的值。它实际上是转换因子，英寸乘以该转换因子得到微米 (25400)。

另请参见：: 常量字段值

MM

public static final int MM

指示以 millimeters (mm) 为单位的值。它实际上是转换因子，毫米乘以该转换因子得到微米 (1000)。

另请参见：: 常量字段值

构造方法详细信息

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 或 y < 0 或 w <= 0 或 h <= 0 或 units < 1，则抛出此异常。