Module java.desktop
Package java.awt.print

Class Paper

java.lang.Object
java.awt.print.Paper
All Implemented Interfaces:
Cloneable
public class Paper
extends Object
implements Cloneable
The Paper class describes the physical characteristics of a piece of paper.

When creating a Paper object, it is the application's responsibility to ensure that the paper size and the imageable area are compatible. For example, if the paper size is changed from 11 x 17 to 8.5 x 11, the application might need to reduce the imageable area so that whatever is printed fits on the page.

See Also:
setSize(double, double), setImageableArea(double, double, double, double)

  • Constructor Summary

    Constructors 
    Constructor Description
    Paper()
    Creates a letter sized piece of paper with one inch margins.

  • Method Summary

    Modifier and Type Method Description
    Object clone()
    Creates a copy of this Paper with the same contents as this Paper.
    double getHeight()
    Returns the height of the page in 1/72nds of an inch.
    double getImageableHeight()
    Returns the height of this Paper object's imageable area.
    double getImageableWidth()
    Returns the width of this Paper object's imageable area.
    double getImageableX()
    Returns the x coordinate of the upper-left corner of this Paper object's imageable area.
    double getImageableY()
    Returns the y coordinate of the upper-left corner of this Paper object's imageable area.
    double getWidth()
    Returns the width of the page in 1/72nds of an inch.
    void setImageableArea​(double x, double y, double width, double height)
    Sets the imageable area of this Paper.
    void setSize​(double width, double height)
    Sets the width and height of this Paper object, which represents the properties of the page onto which printing occurs.

    Methods declared in class java.lang.Object

    equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Constructor Details

    • Paper

      public Paper()
      Creates a letter sized piece of paper with one inch margins.

  • Method Details

    • clone

      public Object clone()
      Creates a copy of this Paper with the same contents as this Paper.
      Overrides:
      clone in class Object
      Returns:
      a copy of this Paper.
      See Also:
      Cloneable

    • getHeight

      public double getHeight()
      Returns the height of the page in 1/72nds of an inch.
      Returns:
      the height of the page described by this Paper.

    • setSize

      public void setSize​(double width, double height)
      Sets the width and height of this Paper object, which represents the properties of the page onto which printing occurs. The dimensions are supplied in 1/72nds of an inch.
      Parameters:
      width - the value to which to set this Paper object's width
      height - the value to which to set this Paper object's height

    • getWidth

      public double getWidth()
      Returns the width of the page in 1/72nds of an inch.
      Returns:
      the width of the page described by this Paper.

    • setImageableArea

      public void setImageableArea​(double x, double y, double width, double height)
      Sets the imageable area of this Paper. The imageable area is the area on the page in which printing occurs.
      Parameters:
      x - the X coordinate to which to set the upper-left corner of the imageable area of this Paper
      y - the Y coordinate to which to set the upper-left corner of the imageable area of this Paper
      width - the value to which to set the width of the imageable area of this Paper
      height - the value to which to set the height of the imageable area of this Paper

    • getImageableX

      public double getImageableX()
      Returns the x coordinate of the upper-left corner of this Paper object's imageable area.
      Returns:
      the x coordinate of the imageable area.

    • getImageableY

      public double getImageableY()
      Returns the y coordinate of the upper-left corner of this Paper object's imageable area.
      Returns:
      the y coordinate of the imageable area.

    • getImageableWidth

      public double getImageableWidth()
      Returns the width of this Paper object's imageable area.
      Returns:
      the width of the imageable area.

    • getImageableHeight

      public double getImageableHeight()
      Returns the height of this Paper object's imageable area.
      Returns:
      the height of the imageable area.