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

    All Methods Instance Methods Concrete Methods
    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 inherited from class java.lang.Object

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

- - ### Constructor Detail

    - #### Paper

          public Paper()

      Creates a letter sized piece of paper with one inch margins.

  - ### Method Detail

    - #### 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.

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 © 1993, 2026, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.