| java.lang.Object javax.print.attribute.standard.MediaPrintableArea
MediaPrintableArea | final public class MediaPrintableArea implements DocAttribute,PrintRequestAttribute,PrintJobAttribute(Code) | | Class MediaPrintableArea is a printing attribute used to distinguish
the printable and non-printable areas of media.
The printable area is specified to be a rectangle, within the overall
dimensions of a media.
Most printers cannot print on the entire surface of the media, due
to printer hardware limitations. This class can be used to query
the acceptable values for a supposed print job, and to request an area
within the constraints of the printable area to be used in a print job.
To query for the printable area, a client must supply a suitable context.
Without specifying at the very least the size of the media being used
no meaningful value for printable area can be obtained.
The attribute is not described in terms of the distance from the edge
of the paper, in part to emphasise that this attribute is not independent
of a particular media, but must be described within the context of a
choice of other attributes. Additionally it is usually more convenient
for a client to use the printable area.
The hardware's minimum margins is not just a property of the printer,
but may be a function of the media size, orientation, media type, and
any specified finishings.
PrintService provides the method to query the supported
values of an attribute in a suitable context :
See
javax.print.PrintService.getSupportedAttributeValues(ClassDocFlavorAttributeSet) PrintService.getSupportedAttributeValues()
The rectangular printable area is defined thus:
The (x,y) origin is positioned at the top-left of the paper in portrait
mode regardless of the orientation specified in the requesting context.
For example a printable area for A4 paper in portrait or landscape
orientation will have height > width.
A printable area attribute's values are stored
internally as integers in units of micrometers (µm), where 1 micrometer
= 10-6 meter = 1/1000 millimeter = 1/25400 inch. This permits
dimensions to be represented exactly to a precision of 1/1000 mm (= 1
µm) or 1/100 inch (= 254 µm). If fractional inches are expressed in
negative powers of two, this permits dimensions to be represented exactly to
a precision of 1/8 inch (= 3175 µm) but not 1/16 inch (because 1/16 inch
does not equal an integral number of µm).
IPP Compatibility: MediaPrintableArea is not an IPP attribute.
|
Field Summary | |
final public static int | INCH Value to indicate units of inches (in). | final public static int | MM Value to indicate units of millimeters (mm). |
Constructor Summary | |
public | MediaPrintableArea(float x, float y, float w, float h, int units) Constructs a MediaPrintableArea object from floating point values. | public | MediaPrintableArea(int x, int y, int w, int h, int units) Constructs a MediaPrintableArea object from integer values. |
Method Summary | |
public boolean | equals(Object object) Returns whether this media margins attribute is equivalent to the passed
in object.
To be equivalent, all of the following conditions must be true:
-
object is not null.
-
object is an instance of class MediaPrintableArea.
-
The origin and dimensions are the same.
Parameters: object - Object to compare to. | final public Class<? extends Attribute> | getCategory() Get the printing attribute class which is to be used as the "category"
for this printing attribute value. | public float | getHeight(int units) Get the height of the printable area in the specified units.
Parameters: units - Unit conversion factor, e.g. | final public String | getName() Get the name of the category of which this attribute value is an
instance. | public float[] | getPrintableArea(int units) Get the printable area as an array of 4 values in the order
x, y, w, h. | public float | getWidth(int units) Get the width of the printable area in the specified units.
Parameters: units - Unit conversion factor, e.g. | public float | getX(int units) Get the x location of the origin of the printable area in the
specified units.
Parameters: units - Unit conversion factor, e.g. | public float | getY(int units) Get the y location of the origin of the printable area in the
specified units.
Parameters: units - Unit conversion factor, e.g. | public int | hashCode() Returns a hash code value for this attribute. | public String | toString(int units, String unitsName) Returns a string version of this rectangular size attribute in the
given units.
Parameters: units - Unit conversion factor, e.g. | public String | toString() Returns a string version of this rectangular size attribute in mm. |
INCH | final public static int INCH(Code) | | Value to indicate units of inches (in). It is actually the conversion
factor by which to multiply inches to yield µm (25400).
|
MM | final public static int MM(Code) | | Value to indicate units of millimeters (mm). It is actually the
conversion factor by which to multiply mm to yield µm (1000).
|
MediaPrintableArea | public MediaPrintableArea(float x, float y, float w, float h, int units)(Code) | | Constructs a MediaPrintableArea object from floating point values.
Parameters: x - printable x Parameters: y - printable y Parameters: w - printable width Parameters: h - printable height Parameters: units - in which the values are expressed. exception: IllegalArgumentException - Thrown if x < 0 or y < 0or w <= 0 or h <= 0 or units < 1. |
MediaPrintableArea | public MediaPrintableArea(int x, int y, int w, int h, int units)(Code) | | Constructs a MediaPrintableArea object from integer values.
Parameters: x - printable x Parameters: y - printable y Parameters: w - printable width Parameters: h - printable height Parameters: units - in which the values are expressed. exception: IllegalArgumentException - Thrown if x < 0 or y < 0or w <= 0 or h <= 0 or units < 1. |
equals | public boolean equals(Object object)(Code) | | Returns whether this media margins attribute is equivalent to the passed
in object.
To be equivalent, all of the following conditions must be true:
-
object is not null.
-
object is an instance of class MediaPrintableArea.
-
The origin and dimensions are the same.
Parameters: object - Object to compare to. True if object is equivalent to this media marginsattribute, false otherwise. |
getCategory | final public Class<? extends Attribute> getCategory()(Code) | | Get the printing attribute class which is to be used as the "category"
for this printing attribute value.
For class MediaPrintableArea, the category is
class MediaPrintableArea itself.
Printing attribute class (category), an instance of classjava.lang.Class java.lang.Class. |
getName | final public String getName()(Code) | | Get the name of the category of which this attribute value is an
instance.
For class MediaPrintableArea,
the category name is "media-printable-area" .
This is not an IPP V1.1 attribute.
Attribute category name. |
getPrintableArea | public float[] getPrintableArea(int units)(Code) | | Get the printable area as an array of 4 values in the order
x, y, w, h. The values returned are in the given units.
Parameters: units - Unit conversion factor, e.g. MediaPrintableArea.INCH INCH orMediaPrintableArea.MM MM . printable area as array of x, y, w, h in the specified units. exception: IllegalArgumentException - (unchecked exception) Thrown if units < 1. |
getX | public float getX(int units)(Code) | | Get the x location of the origin of the printable area in the
specified units.
Parameters: units - Unit conversion factor, e.g. MediaPrintableArea.INCH INCH orMediaPrintableArea.MM MM . x location of the origin of the printable area in thespecified units. exception: IllegalArgumentException - (unchecked exception) Thrown if units < 1. |
getY | public float getY(int units)(Code) | | Get the y location of the origin of the printable area in the
specified units.
Parameters: units - Unit conversion factor, e.g. MediaPrintableArea.INCH INCH orMediaPrintableArea.MM MM . y location of the origin of the printable area in thespecified units. exception: IllegalArgumentException - (unchecked exception) Thrown if units < 1. |
hashCode | public int hashCode()(Code) | | Returns a hash code value for this attribute.
|
toString | public String toString(int units, String unitsName)(Code) | | Returns a string version of this rectangular size attribute in the
given units.
Parameters: units - Unit conversion factor, e.g. MediaPrintableArea.INCH INCH orMediaPrintableArea.MM MM . Parameters: unitsName - Units name string, e.g. "in" or "mm" . Ifnull, no units name is appended to the result. String version of this two-dimensional size attribute. exception: IllegalArgumentException - (unchecked exception) Thrown if units < 1. |
toString | public String toString()(Code) | | Returns a string version of this rectangular size attribute in mm.
|
|
|