Module java.desktop
Package java.awt.print

Class PageFormat

java.lang.Object
java.awt.print.PageFormat
All Implemented Interfaces:
Cloneable
public class PageFormat extends Object implements Cloneable
The PageFormat class describes the size and orientation of a page to be printed.

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static int
    LANDSCAPE
    The origin is at the bottom left of the paper with x running bottom to top and y running left to right.
    static int
    PORTRAIT
    The origin is at the top left of the paper with x running to the right and y running down the paper.
    static int
    REVERSE_LANDSCAPE
    The origin is at the top right of the paper with x running top to bottom and y running right to left.

  • Constructor Summary

    Constructors
    Constructor
    Description
    PageFormat()
    Creates a default, portrait-oriented PageFormat.

  • Method Summary

    Modifier and Type
    Method
    Description
    Object
    clone()
    Makes a copy of this PageFormat with the same contents as this PageFormat.
    double
    getHeight()
    Returns the height, in 1/72nds of an inch, of the page.
    double
    getImageableHeight()
    Return the height, in 1/72nds of an inch, of the imageable area of the page.
    double
    getImageableWidth()
    Returns the width, in 1/72nds of an inch, of the imageable area of the page.
    double
    getImageableX()
    Returns the x coordinate of the upper left point of the imageable area of the Paper object associated with this PageFormat.
    double
    getImageableY()
    Returns the y coordinate of the upper left point of the imageable area of the Paper object associated with this PageFormat.
    double[]
    getMatrix()
    Returns a transformation matrix that translates user space rendering to the requested orientation of the page.
    int
    getOrientation()
    Returns the orientation of this PageFormat.
    Paper
    getPaper()
    Returns a copy of the Paper object associated with this PageFormat.
    double
    getWidth()
    Returns the width, in 1/72nds of an inch, of the page.
    void
    setOrientation​(int orientation)
    Sets the page orientation.
    void
    setPaper​(Paper paper)
    Sets the Paper object for this PageFormat.

    Methods declared in class java.lang.Object

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

  • Field Details

    • LANDSCAPE

      @Native public static final int LANDSCAPE
      The origin is at the bottom left of the paper with x running bottom to top and y running left to right. Note that this is not the Macintosh landscape but is the Window's and PostScript landscape.
      See Also:
      Constant Field Values

    • PORTRAIT

      @Native public static final int PORTRAIT
      The origin is at the top left of the paper with x running to the right and y running down the paper.
      See Also:
      Constant Field Values

    • REVERSE_LANDSCAPE

      @Native public static final int REVERSE_LANDSCAPE
      The origin is at the top right of the paper with x running top to bottom and y running right to left. Note that this is the Macintosh landscape.
      See Also:
      Constant Field Values

  • Constructor Details

    • PageFormat

      public PageFormat()
      Creates a default, portrait-oriented PageFormat.

  • Method Details

    • clone

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

    • getWidth

      public double getWidth()
      Returns the width, in 1/72nds of an inch, of the page. This method takes into account the orientation of the page when determining the width.
      Returns:
      the width of the page.

    • getHeight

      public double getHeight()
      Returns the height, in 1/72nds of an inch, of the page. This method takes into account the orientation of the page when determining the height.
      Returns:
      the height of the page.

    • getImageableX

      public double getImageableX()
      Returns the x coordinate of the upper left point of the imageable area of the Paper object associated with this PageFormat. This method takes into account the orientation of the page.
      Returns:
      the x coordinate of the upper left point of the imageable area of the Paper object associated with this PageFormat.

    • getImageableY

      public double getImageableY()
      Returns the y coordinate of the upper left point of the imageable area of the Paper object associated with this PageFormat. This method takes into account the orientation of the page.
      Returns:
      the y coordinate of the upper left point of the imageable area of the Paper object associated with this PageFormat.

    • getImageableWidth

      public double getImageableWidth()
      Returns the width, in 1/72nds of an inch, of the imageable area of the page. This method takes into account the orientation of the page.
      Returns:
      the width of the page.

    • getImageableHeight

      public double getImageableHeight()
      Return the height, in 1/72nds of an inch, of the imageable area of the page. This method takes into account the orientation of the page.
      Returns:
      the height of the page.

    • getPaper

      public Paper getPaper()
      Returns a copy of the Paper object associated with this PageFormat. Changes made to the Paper object returned from this method do not affect the Paper object of this PageFormat. To update the Paper object of this PageFormat, create a new Paper object and set it into this PageFormat by using the setPaper(Paper) method.
      Returns:
      a copy of the Paper object associated with this PageFormat.
      See Also:
      setPaper(java.awt.print.Paper)

    • setPaper

      public void setPaper​(Paper paper)
      Sets the Paper object for this PageFormat.
      Parameters:
      paper - the Paper object to which to set the Paper object for this PageFormat.
      Throws:
      NullPointerException - a null paper instance was passed as a parameter.
      See Also:
      getPaper()

    • setOrientation

      public void setOrientation​(int orientation) throws IllegalArgumentException
      Sets the page orientation. orientation must be one of the constants: PORTRAIT, LANDSCAPE, or REVERSE_LANDSCAPE.
      Parameters:
      orientation - the new orientation for the page
      Throws:
      IllegalArgumentException - if an unknown orientation was requested
      See Also:
      getOrientation()

    • getOrientation

      public int getOrientation()
      Returns the orientation of this PageFormat.
      Returns:
      this PageFormat object's orientation.
      See Also:
      setOrientation(int)

    • getMatrix

      public double[] getMatrix()
      Returns a transformation matrix that translates user space rendering to the requested orientation of the page. The values are placed into the array as { m00, m10, m01, m11, m02, m12} in the form required by the AffineTransform constructor.
      Returns:
      the matrix used to translate user space rendering to the orientation of the page.
      See Also:
      AffineTransform