JavaTM 2 Platform
Standard Ed. 5.0

java.awt.print
类 PageFormat

java.lang.Object
  继承者 java.awt.print.PageFormat
所有已实现的接口:
Cloneable

public class PageFormat
extends Object
implements Cloneable

PageFormat 类描述要打印的页面大小和方向。


字段摘要
static int LANDSCAPE
          原点位于纸张的左下方,x 的方向从下到上,y 的方向从左到右。
static int PORTRAIT
          原点在纸张的左上方,x 指向右方,y 指向下方。
static int REVERSE_LANDSCAPE
          原点位于纸张的右上方,x 的方向从上到下,y 的方向从右到左。
 
构造方法摘要
PageFormat()
          创建默认的纵向 PageFormat
 
方法摘要
 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 对象。
 
从类 java.lang.Object 继承的方法
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

字段详细信息

LANDSCAPE

public static final int LANDSCAPE
原点位于纸张的左下方,x 的方向从下到上,y 的方向从左到右。注意,这不是 Macintosh landscape,而是 Windows 和 PostScript landscape。

另请参见:
常量字段值

PORTRAIT

public static final int PORTRAIT
原点在纸张的左上方,x 指向右方,y 指向下方。

另请参见:
常量字段值

REVERSE_LANDSCAPE

public static final int REVERSE_LANDSCAPE
原点位于纸张的右上方,x 的方向从上到下,y 的方向从右到左。注意,这是 Macintosh landscape。

另请参见:
常量字段值
构造方法详细信息

PageFormat

public PageFormat()
创建默认的纵向 PageFormat

方法详细信息

clone

public Object clone()
制作此 PageFormat 的副本,使它与此 PageFormat 具有相同的内容。

覆盖:
Object 中的 clone
返回:
PageFormat 的副本。
另请参见:
Cloneable

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 对象进行的更改不影响此 PageFormatPaper 对象。要更新此 PageFormatPaper 对象,请创建新的 Paper 对象,并使用 setPaper(Paper) 方法将它设置到此 PageFormat 中。

返回:
与此 PageFormat 相关的 Paper 对象的一个副本。
另请参见:
setPaper(java.awt.print.Paper)

setPaper

public void setPaper(Paper paper)
为此 PageFormat 设置 Paper 对象。

参数:
paper - 作为 PageFormatPaper 对象的设置目标的 Paper 对象。
抛出:
NullPointerException - 传递的页面实例参数为 null 。
另请参见:
getPaper()

setOrientation

public void setOrientation(int orientation)
                    throws IllegalArgumentException
设置页面方向。orientation 必须是以下常量之一:PORTRAIT、LANDSCAPE 或 REVERSE_LANDSCAPE。

参数:
orientation - 页面的新方向
抛出:
IllegalArgumentException - 如果请求了未知的方向
另请参见:
getOrientation()

getOrientation

public int getOrientation()
返回此 PageFormat 的方向。

返回:
PageFormat 对象的方向。
另请参见:
setOrientation(int)

getMatrix

public double[] getMatrix()
返回一个变换矩阵,该矩阵将呈现的用户空间向请求的方向平移。将值按 AffineTransform 构造方法所要求的形式 { m00, m10, m01, m11, m02, m12} 放入数组中。

返回:
用于将呈现的用户空间向页面的方向平移的矩阵。
另请参见:
AffineTransform

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策