|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object javax.print.attribute.standard.MediaPrintableArea
public final class MediaPrintableArea
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 |
字段详细信息 |
---|
public static final int INCH
public static final int MM
构造方法详细信息 |
---|
public MediaPrintableArea(float x, float y, float w, float h, int units)
x
- 可打印的 xy
- 可打印的 yw
- 可打印的 widthh
- 可打印的 heightunits
- 用于表示值的单位。
IllegalArgumentException
- 如果 x
< 0 或 y
< 0 或 w
<= 0 或 h
<= 0 或 units
< 1,则抛出此异常。public MediaPrintableArea(int x, int y, int w, int h, int units)
x
- 可打印的 xy
- 可打印的 yw
- 可打印的 widthh
- 可打印的 heightunits
- 用于表示值的单位。
IllegalArgumentException
- 如果 x
< 0 或 y
< 0 或 w
<= 0 或 h
<= 0 或 units
< 1,则抛出此异常。方法详细信息 |
---|
public float[] getPrintableArea(int units)
units
- 单位转换因子,例如,INCH
或 MM
。
IllegalArgumentException
- (未经检查的异常)如果 units
< 1,则抛出该异常。public float getX(int units)
units
- 单位转换因子,例如,INCH
或 MM
。
IllegalArgumentException
- (未经检查的异常)如果 units
< 1,则抛出该异常。public float getY(int units)
units
- 单位转换因子,例如,INCH
或 MM
。
IllegalArgumentException
- (未经检查的异常)如果 units
< 1,则抛出该异常。public float getWidth(int units)
units
- 单位转换因子,例如,INCH
或 MM
。
IllegalArgumentException
- (未经检查的异常)如果 units
< 1,则抛出该异常。public float getHeight(int units)
units
- 单位转换因子,例如 INCH
或 MM
。
IllegalArgumentException
- (未经检查的异常)如果 units
< 1,则抛出该异常。public boolean equals(Object object)
object
不为 null。
object
为 MediaPrintableArea 类的实例。
Object
中的 equals
object
- 要比较的 Object。
object
等效于此介质页边距属性,则返回 true,否则返回 false。Object.hashCode()
,
Hashtable
public final Class<? extends Attribute> getCategory()
对于 MediaPrintableArea 类,类别为 MediaPrintableArea 类本身。
Attribute
中的 getCategory
java.lang.Class
类的实例。public final String getName()
对于 MediaPrintableArea 类,类别名称为 "media-printable-area"
。
这不是 IPP V1.1 属性。
Attribute
中的 getName
public String toString(int units, String unitsName)
units
- 单位转换因子,例如 INCH
或 MM
。unitsName
- 单位名称字符串,例如 "in"
或 "mm"
。如果为 null,则没有任何单位名称附加到该结果。
IllegalArgumentException
- (未经检查的异常)如果 units
< 1,则抛出该异常。public String toString()
Object
中的 toString
public int hashCode()
Object
中的 hashCode
Object.equals(java.lang.Object)
,
Hashtable
|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。