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 のコピーを同じ内容で作成します。
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 で使用される横長ではなく、Windows および PostScript で使用される横長です。

関連項目:

定数フィールド値

PORTRAIT

public static final int PORTRAIT

用紙の左上を原点として、左端から右端を x、上端から下端を y で表します。

関連項目:

定数フィールド値

REVERSE_LANDSCAPE

public static final int REVERSE_LANDSCAPE

用紙の右上を原点として、上端から下端を x、右端から左端を y で表します。これは、Macintosh で使用される横長です。

関連項目:

定数フィールド値

コンストラクタの詳細

PageFormat

public PageFormat()

縦長のデフォルト PageFormat を作成します。

メソッドの詳細

clone

public Object clone()

この 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 オブジェクトに行われた変更は、この PageFormat の Paper オブジェクトには影響しません。この PageFormat の Paper オブジェクトを更新するには、新しい Paper オブジェクトを生成し、setPaper(Paper) メソッドを使ってそのオブジェクトをこの PageFormat に設定します。

戻り値:

この PageFormat に関連した Paper オブジェクトのコピー

関連項目:

setPaper(java.awt.print.Paper)

setPaper

public void setPaper(Paper paper)

この PageFormat に対応する Paper オブジェクトを設定します。

パラメータ:

paper - この PageFormat に対応する Paper オブジェクトを設定する 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