|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
public interface Printable
Printable インタフェースは、ページを描画する印刷システムによって呼び出される、現在のページペインタの print メソッドによって実装されます。Pageable を作成する場合は、PageFormat のインスタンスと、このインタフェースを実装するインスタンスのペアを使用して各ページを記述します。Printable を実装するインスタンスは、ページのグラフィックを印刷するために呼び出されます。
PrinterJob に Printable(..) を設定できます。その後、クライアントが PrinterJob.print(..) を呼び出して印刷をトリガーすると、
すべてのページが印刷されるまで、制御が印刷システムに渡されます。これはドキュメントのすべてのページが印刷されるまで、Printable.print(..) を呼び出すことによって実行します。Printable インタフェースを使用すると、印刷システムによって要求されればいつでも、ページの内容が描画されます。
Printable.print(..) のパラメータには、ページに収める内容の計算に必要な、ページの印刷可能領域を示す PageFormat、および要求されたページの 0 を基準にした印刷ストリームインデックスを指定するページインデックスがあります。
正しく印刷するため、次の点に注意する必要があります。
Printable.print(..) を呼び出します。 ただし、上記のように Printable は、ページ範囲がクライアント、または印刷ダイアログを通じてユーザーによって指定されている場合に、ページインデックスの複数の呼び出しを予想し、ページインデックスがスキップされている可能性があることを予想する必要があります。
Printable は指定された PageFormat パラメータとページインデックスを検査し、受け取る必要があります。描画されるページの書式は、pageFormat で指定します。そのため、ページのサイズ、印刷方向、イメージング可能領域はすでに決定していて、描画はこのイメージング可能領域内で行われる必要があります。これは、正しく印刷するために重要であり、クライアントが指定されたページに属する内容を追跡する役割を持つことを暗黙的に示しています。
Pageable から Printable を取得した場合、クライアントはページインデックスごとに異なる PageFormats を指定することができます。ページ区切りの計算ではこれを考慮する必要があります。
Pageable,
PageFormat,
PrinterJob| フィールドの概要 | |
|---|---|
static int |
NO_SUCH_PAGE
pageIndex が大き過ぎるため要求されたページが存在しないことを通知するために print メソッドによって返されます。 |
static int |
PAGE_EXISTS
描画された要求ページを通知するために print(Graphics, PageFormat, int) メソッドによって返されます。 |
| メソッドの概要 | |
|---|---|
int |
print(Graphics graphics,
PageFormat pageFormat,
int pageIndex)
指定されたインデックスにあるページを、指定された書式で、指定された Graphics コンテキストに印刷します。 |
| フィールドの詳細 |
|---|
static final int PAGE_EXISTS
print(Graphics, PageFormat, int) メソッドによって返されます。
static final int NO_SUCH_PAGE
pageIndex が大き過ぎるため要求されたページが存在しないことを通知するために print メソッドによって返されます。
| メソッドの詳細 |
|---|
int print(Graphics graphics,
PageFormat pageFormat,
int pageIndex)
throws PrinterException
Graphics コンテキストに印刷します。PrinterJob は Printable インタフェースを呼び出して、graphics で指定されたコンテキストにページが描画されるように要求します。描画されるページの書式は、pageFormat で指定します。pageIndex では、描画されるページのゼロから始まるインデックスを指定します。指定されたページが存在しない場合、このメソッドは NO_SUCH_PAGE を返します。 存在する場合は、PAGE_EXISTS が返されます。Graphics クラスまたはサブクラスは、PrinterGraphics インタフェースを実装して追加情報を提供します。Printable オブジェクトが印刷を中断した場合は、PrinterException がスローされます。
graphics - ページが描画されるコンテキストpageFormat - 描画されるページのサイズと印刷方向pageIndex - 描画されるページのゼロから始まるインデックス
pageIndex で指定されたページが存在しない場合は
NO_SUCH_PAGE
PrinterException - 印刷が中断された場合
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。