All Implemented Interfaces:
PrintJobAttribute, PrintRequestAttribute, DocAttribute
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 :
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.
|public static final int||INCH||Value to indicate units of inches (in). It is actually the conversion factor by which to multiply inches to yield µm (25400).|
|public static final int||MM||Value to indicate units of millimeters (mm). It is actually the conversion factor by which to multiply mm to yield µm (1000).|
public MediaPrintableArea(float x, float y, float w, float h, int units)
public MediaPrintableArea(int x, int y, int w, int h, int units)
|Method from javax.print.attribute.standard.MediaPrintableArea Summary:|
|equals, getCategory, getHeight, getName, getPrintableArea, getWidth, getX, getY, hashCode, toString, toString|
|Methods from java.lang.Object:|
|clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait|
|Method from javax.print.attribute.standard.MediaPrintableArea Detail:|
public boolean equals(Object object)
public final Class<Attribute> getCategory()
For class MediaPrintableArea, the category is class MediaPrintableArea itself.
public float getHeight(int units)
public final String getName()
For class MediaPrintableArea,
the category name is
This is not an IPP V1.1 attribute.
public float getPrintableArea(int units)
public float getWidth(int units)
public float getX(int units)
public float getY(int units)
public int hashCode()
public String toString()
public String toString(int units, String unitsName)