Module java.desktop
Package java.awt.print

Class PageFormat

java.lang.Object
java.awt.print.PageFormat
所有已实现的接口:
Cloneable
public class PageFormat extends Object implements Cloneable
PageFormat类描述要打印的页面的大小和方向。

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final int
    LANDSCAPE
    原点位于纸张的左下角，x轴从底部到顶部，y轴从左到右。
    static final int
    PORTRAIT
    原点位于纸张的左上角，x轴从左到右，y轴从上到下。
    static final int
    REVERSE_LANDSCAPE
    原点位于纸张的右上角，x轴从顶部到底部，y轴从右到左。

  • Constructor Summary

    Constructors
    Constructor
    Description
    PageFormat()
    创建一个默认的纵向PageFormat。

  • Method Summary

    Modifier and Type
    Method
    Description
    Object
    clone()
    复制此PageFormat，内容与此PageFormat相同。
    double
    getHeight()
    返回页面的高度，以1/72英寸为单位。
    double
    getImageableHeight()
    返回页面可打印区域的高度，以1/72英寸为单位。
    double
    getImageableWidth()
    返回页面可打印区域的宽度，以1/72英寸为单位。
    double
    getImageableX()
    返回与此PageFormat关联的Paper对象的可打印区域的左上点的x坐标。
    double
    getImageableY()
    返回与此PageFormat关联的Paper对象的可打印区域的左上点的y坐标。
    double[]
    getMatrix()
    返回一个转换矩阵，将用户空间渲染转换为页面请求的方向。
    int
    getOrientation()
    返回此PageFormat的方向。
    Paper
    getPaper()
    返回与此PageFormat关联的Paper对象的副本。
    double
    getWidth()
    返回页面的宽度，以1/72英寸为单位。
    void
    setOrientation(int orientation)
    设置页面方向。
    void
    setPaper(Paper paper)
    为此PageFormat设置Paper对象。

    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
      原点位于纸张的左下角，x轴从底部到顶部，y轴从左到右。请注意，这不是Macintosh横向，而是Windows和PostScript横向。
      参见:

    • PORTRAIT

      @Native public static final int PORTRAIT
      原点位于纸张的左上角，x轴从左到右，y轴从上到下。
      参见:

    • REVERSE_LANDSCAPE

      @Native public static final int REVERSE_LANDSCAPE
      原点位于纸张的右上角，x轴从顶部到底部，y轴从右到左。请注意，这是Macintosh横向。
      参见:

  • Constructor Details

    • PageFormat

      public PageFormat()
      创建一个默认的纵向PageFormat。

  • Method Details

    • clone

      public Object clone()
      复制此PageFormat，内容与此PageFormat相同。
      覆盖:
      clone 在类 Object
      返回:
      此PageFormat的副本。
      参见:

    • getWidth

      public double getWidth()
      返回页面的宽度，以1/72英寸为单位。此方法考虑页面的方向来确定宽度。
      返回:
      页面的宽度。

    • getHeight

      public double getHeight()
      返回页面的高度，以1/72英寸为单位。此方法考虑页面的方向来确定高度。
      返回:
      页面的高度。

    • getImageableX

      public double getImageableX()
      返回与此PageFormat关联的Paper对象的可打印区域的左上点的x坐标。此方法考虑页面的方向。
      返回:
      与此PageFormat关联的Paper对象的可打印区域的左上点的x坐标。

    • getImageableY

      public double getImageableY()
      返回与此PageFormat关联的Paper对象的可打印区域的左上点的y坐标。此方法考虑页面的方向。
      返回:
      与此PageFormat关联的Paper对象的可打印区域的左上点的y坐标。

    • getImageableWidth

      public double getImageableWidth()
      返回页面的可打印区域的宽度，以1/72英寸为单位。此方法考虑页面的方向。
      返回:
      页面的宽度。

    • getImageableHeight

      public double getImageableHeight()
      返回页面的可打印区域的高度，以1/72英寸为单位。此方法考虑页面的方向。
      返回:
      页面的高度。

    • getPaper

      public Paper getPaper()
      返回与此PageFormat关联的Paper对象的副本。对从此方法返回的Paper对象所做的更改不会影响此PageFormat的Paper对象。要更新此PageFormat的Paper对象，请创建一个新的Paper对象，并使用setPaper(Paper)方法将其设置到此PageFormat中。
      返回:
      与此PageFormat关联的Paper对象的副本。
      参见:

    • setPaper

      public void setPaper(Paper paper)
      为此PageFormat设置Paper对象。
      参数:
      paper - 要设置为此PageFormat的Paper对象。
      抛出:
      NullPointerException - 作为参数传递了一个空的Paper实例。
      参见:

    • setOrientation

      public void setOrientation(int orientation) throws IllegalArgumentException
      设置页面方向。 orientation必须是常量之一：PORTRAIT、LANDSCAPE或REVERSE_LANDSCAPE。
      参数:
      orientation - 页面的新方向
      抛出:
      IllegalArgumentException - 如果请求了未知方向
      参见:

    • getOrientation

      public int getOrientation()
      返回此PageFormat的方向。
      返回:
      此PageFormat对象的方向。
      参见:

    • getMatrix

      public double[] getMatrix()
      返回一个转换矩阵，将用户空间渲染转换为页面的请求方向。这些值以{ m00, m10, m01, m11, m02, m12}的形式放入数组中，这是AffineTransform构造函数所需的形式。
      返回:
      用于将用户空间渲染转换为页面方向的矩阵。
      参见: