public final class PageLayout extends Object
Printers usually have hardware margins where they cannot print. A PageLayout instance obtained from a PrinterJob in the context of a specific printer will be correctly set up to print over the whole of that area. If an application adjusts the printable area outside of this bounds, rendering to those areas will be clipped by the device.
Within those hardware margins, the application may define any printable area it needs. The resulting printable area will define the effective dimensions of the page available to the application at printing time.
Applying a PageLayout configured based on one printer, to a job on a different printer may not work correctly, as the second printer may not support the same margins, and may not even support the same Paper. In such a case, the PageLayout must be validated against the new printer.
A PageLayout is immutable.
Modifier and Type | Method and Description |
---|---|
boolean |
equals(Object o) |
double |
getBottomMargin()
Returns the bottom margin of the page layout in points.
|
double |
getLeftMargin()
Returns the left margin of the page layout in points.
|
PageOrientation |
getPageOrientation() |
Paper |
getPaper()
The paper used.
|
double |
getPrintableHeight()
Returns the height dimension of the printable area of the page,
in 1/72 of an inch, taking into account the orientation.
|
double |
getPrintableWidth()
Returns the width dimension of the printable area of the page,
in 1/72 of an inch points, taking into account the orientation.
|
double |
getRightMargin()
Returns the right margin of the page layout in points.
|
double |
getTopMargin()
Returns the top margin of the page layout in points.
|
int |
hashCode() |
String |
toString() |
public PageOrientation getPageOrientation()
public Paper getPaper()
PageLayout
.public double getPrintableWidth()
The printable area is width or height reduced by the requested margins on each side. If the requested margins are smaller than the the hardware margins, rendering may be clipped by the device.
Since the returned value accounts for orientation, this means if if the orientation is LANDSCAPE or REVERSE_LANDSCAPE, then the left and right margins are subtracted from the height of the underlying paper, since it is rotated 90 degrees.
public double getPrintableHeight()
The printable area is width or height reduced by the requested margins on each side. If the requested margins are smaller than the the hardware margins, rendering may be clipped by the device.
Since the returned value accounts for orientation, this means if if the orientation is LANDSCAPE or REVERSE_LANDSCAPE, then the top and bottom margins are subtracted from the height of the underlying paper, since it is rotated 90 degrees.
public double getLeftMargin()
public double getRightMargin()
public double getTopMargin()
public double getBottomMargin()
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 2008, 2017, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.