|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.print.PrinterJob
PrinterJob
クラスは、印刷を制御する主要なクラスです。アプリケーションはこのクラスのメソッドを呼び出して、ジョブを設定し、必要に応じて印刷のダイアログを呼び出し、そのあとジョブのページを印刷します。
コンストラクタの概要 | |
PrinterJob()
PrinterJob オブジェクトの作成には、static メソッドの を使用してください。 |
メソッドの概要 | |
abstract void |
cancel()
実行中の印刷ジョブを取り消します。 |
PageFormat |
defaultPage()
新しい PageFormat のインスタンスを生成し、デフォルトのサイズと印刷方向に設定します。 |
abstract PageFormat |
defaultPage(PageFormat page)
PageFormat 引数を複製し、その複製を変更してデフォルトのページサイズと印刷方向を記述します。 |
abstract int |
getCopies()
印刷する部数を返します。 |
abstract String |
getJobName()
印刷するドキュメントの名前を返します。 |
static PrinterJob |
getPrinterJob()
初期状態でデフォルトプリンタに関連付けられた PrinterJob を作成して返します。 |
PrintService |
getPrintService()
この印刷ジョブのサービス (プリンタ) を返します。 |
abstract String |
getUserName()
印刷を行うユーザの名前を返します。 |
abstract boolean |
isCancelled()
印刷ジョブが実行中であり、次の機会に取り消される予定の場合は true 、そうでない場合は false を返します。 |
static PrintService[] |
lookupPrintServices()
2D 印刷サービスを検索する簡易メソッドです。 |
static StreamPrintServiceFactory[] |
lookupStreamPrintServices(String mimeType)
出荷時に配備される印刷サービスストリーム用の簡易メソッドです。 |
abstract PageFormat |
pageDialog(PageFormat page)
PageFormat のインスタンスを変更するためのダイアログを表示します。 |
PageFormat |
pageDialog(PrintRequestAttributeSet attributes)
共通プラットフォームのページ設定ダイアログを表示する簡易メソッドです。 |
abstract void |
print()
ページのセットを印刷します。 |
void |
print(PrintRequestAttributeSet attributes)
属性セットの設定を使用してページのセットを印刷します。 |
abstract boolean |
printDialog()
ユーザに対して、印刷ジョブのプロパティ変更ダイアログを表示します。 |
boolean |
printDialog(PrintRequestAttributeSet attributes)
共通プラットフォームのすべてのサービスに対する印刷ダイアログを表示する簡易メソッドです。 |
abstract void |
setCopies(int copies)
印刷する部数を設定します。 |
abstract void |
setJobName(String jobName)
印刷するドキュメントの名前を設定します。 |
abstract void |
setPageable(Pageable document)
document に対して、ページ数や、Pageable のインスタンス (document ) に保持されている各ページの PageFormat および Printable を問い合わせます。 |
abstract void |
setPrintable(Printable painter)
ページを描画するために painter を呼び出します。 |
abstract void |
setPrintable(Printable painter,
PageFormat format)
指定された format でページを描画するために painter を呼び出します。 |
void |
setPrintService(PrintService service)
この PrinterJob を新しい PrintService に関連付けます。 |
abstract PageFormat |
validatePage(PageFormat page)
この PrinterJob の現在のプリンタと互換性があるように調整された設定を持つ、page の複製を返します。 |
クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
コンストラクタの詳細 |
public PrinterJob()
PrinterJob
オブジェクトの作成には、static メソッドの getPrinterJob
を使用してください。
メソッドの詳細 |
public static PrinterJob getPrinterJob()
PrinterJob
を作成して返します。システムでプリンタが使用できない場合でも、PrinterJob がこのメソッドから返されます。ただし、 getPrintService()
は null
を返し、この PrinterJob
を持つ print
の呼び出しが例外を生成する場合があります。PrinterJob
を作成する前に適切なプリンタがあるかどうかを判別する必要があるアプリケーションは、lookupPrintServices
から返された配列が空ではないことを確認する必要があります。
PrinterJob
public static PrintService[] lookupPrintServices()
PrinterJob
にインストールできます。このメソッドの呼び出しは、PrintServiceLookup.lookupPrintServices()
の呼び出し、および Pageable DocFlavor の指定と同等です。
public static StreamPrintServiceFactory[] lookupStreamPrintServices(String mimeType)
FileOutputStream outstream; StreamPrintService psPrinter; String psMimeType = "application/postscript"; StreamPrintServiceFactory[] factories = PrinterJob.lookupStreamPrintServices(psMimeType); if (factories.length > 0) { try { outstream = new File("out.ps"); psPrinter = factories[0].getPrintService(fos); // psPrinter can now be set as the service on a PrinterJob } catch (FileNotFoundException e) { } }このメソッドから返されたサービスは、印刷サービスをサポートする
PrinterJob
にインストールできます。このメソッドの呼び出しは StreamPrintServiceFactory.lookupStreamPrintServiceFactories()
の呼び出しおよび Pageable DocFlavor の指定と同等です。
mimeType
- 要求された出力形式、または null (任意の形式を意味)
public PrintService getPrintService()
setPrintService(PrintService)
public void setPrintService(PrintService service) throws PrinterException
Pageable
および Printable
インタフェースをサポートできない場合は PrinterException
をスローします。
service
- 2D 印刷をサポートする印刷サービス
PrinterException
- 指定されたサービスが 2D 印刷をサポートしない場合、またはこの PrinterJob クラスが 2D 印刷サービスの設定をサポートしない場合、この両者以外の場合で指定されたサービスが有効な印刷サービスではない場合getPrintService()
public abstract void setPrintable(Printable painter)
painter
を呼び出します。この PrinterJob
によって印刷されるドキュメント内のページは、painter
で指定された Printable
オブジェクトによって描画されます。各ページの PageFormat
は、デフォルトのページ書式になります。
painter
- ドキュメントの各ページを描画する Printable
public abstract void setPrintable(Printable painter, PageFormat format)
format
でページを描画するために painter
を呼び出します。この PrinterJob
によって印刷されるドキュメント内のページは、painter
で指定された Printable
オブジェクトによって描画されます。各ページの PageFormat
は、format
で指定されたページ書式になります。
painter
- ドキュメントの各ページを描画するために呼び出す Printable
format
- 印刷される各ページのサイズと印刷方向public abstract void setPageable(Pageable document) throws NullPointerException
document
に対して、ページ数や、Pageable
のインスタンス (document
) に保持されている各ページの PageFormat
および Printable
を問い合わせます。
document
- 印刷されるページ。null
を渡すことはできない
NullPointerException
- 渡された Pageable
が null
である場合PageFormat
,
Printable
public abstract boolean printDialog() throws HeadlessException
printDialog(PrintRequestAttributeSet)
を使用します。
PrintService の印刷ダイアログを使用できる PrinterJob の実装により、この PrinterJob に対する PrintService が更新されユーザが選択するサービスが反映されます。
true
、そうでない場合は false
HeadlessException
- GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless()
public boolean printDialog(PrintRequestAttributeSet attributes) throws HeadlessException
Pageable
インタフェースを使用して 2D グラフィックスの印刷が可能です。印刷ダイアログが初期状態で表示されたときに選択したプリンタは、この印刷ジョブに現在接続されている印刷サービスを反映します。ユーザが印刷サービスを変更する場合、ユーザが印刷ダイアログを取り消さないかぎり、PrinterJob が更新されて変更を反映します。ユーザは出力先プリンタの選択とともに、さまざまな印刷要求属性の値を選択することもできます。
属性パラメータ on input は、アプリケーションが要求するユーザダイアログでの初期選択を反映します。属性が指定されない場合は、印刷サービスのデフォルトの属性を使用して表示されます。属性パラメータ on return は、ユーザの選択を反映します。選択は、現在選択されている印刷サービスがサポートする値と一致するように更新されます。
ユーザがスクロールして新しい印刷サービスを選択すると、値のコピーは、ユーザの任意の変更とともに直前のサービスの設定に基づいて行われます。この値のコピーは、クライアントが指定した元の設定に基づいて行われるわけではありません。
プリンタの選択の例外として、PrinterJob の状態がユーザの変更を反映して更新されない場合があります。プリンタの選択によって印刷ジョブを更新できるようにするには、print(PrintRequestAttributeSet)
メソッドの呼び出しで属性を指定する必要があります。Pageable インタフェースを使用している場合、ユーザが選択したメディアを使用する予定のクライアントはユーザの選択から派生する PageFormat を作成する必要があります。ユーザが印刷ダイアログを取り消した場合は、属性はユーザが行った変更を反映しません。
attributes
- on input は属性が提供するアプリケーションである。on output はユーザの選択によって内容が更新される。このパラメータは null にはならない
true
、そうでない場合は false
HeadlessException
- GraphicsEnvironment.isHeadless() が true を返す場合
NullPointerException
- attributes
パラメータが null の場合GraphicsEnvironment.isHeadless()
public abstract PageFormat pageDialog(PageFormat page) throws HeadlessException
PageFormat
のインスタンスを変更するためのダイアログを表示します。引数 page
は、ページ設定ダイアログのコントロールを初期化するために使用されます。ユーザがダイアログを取り消すと、このメソッドは元の page
オブジェクトを変更しないで返します。ユーザがダイアログを了解すると、このメソッドは変更内容を示す新しい PageFormat
を返します。どちらの場合にも、元の page
オブジェクトは変更されません。
page
- 変更のためにユーザに対して表示されるデフォルトの PageFormat
page
オブジェクト。ダイアログが了解された場合は、ユーザが示した書式を持つ新しい PageFormat
オブジェクト
HeadlessException
- GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless()
public PageFormat pageDialog(PrintRequestAttributeSet attributes) throws HeadlessException
属性パラメータ on input は、クライアントが要求するユーザダイアログでの初期選択を反映します。属性が指定されない場合は、印刷サービスのデフォルトの属性を使用して表示されます。属性パラメータ on return は、ユーザの選択を反映します。選択は、現在選択されている印刷サービスがサポートする値と一致するように更新されます。
戻り値は PrintRequestAttributeSet での選択と同等の PageFormat です。ユーザがダイアログを取り消した場合、属性はユーザが行った変更を反映しません。戻り値は null です。
attributes
- on input は属性が提供するアプリケーションである。on output はユーザの選択によって内容が更新される。このパラメータは null にはならない
null
HeadlessException
- GraphicsEnvironment.isHeadless() が true を返す場合
NullPointerException
- attributes
パラメータが null の場合GraphicsEnvironment.isHeadless()
public abstract PageFormat defaultPage(PageFormat page)
PageFormat
引数を複製し、その複製を変更してデフォルトのページサイズと印刷方向を記述します。
page
- 複製および変更される PageFormat
PageFormat
を記述するために変更された page
の複製public PageFormat defaultPage()
PageFormat
のインスタンスを生成し、デフォルトのサイズと印刷方向に設定します。
PageFormat
public abstract PageFormat validatePage(PageFormat page)
PrinterJob
の現在のプリンタと互換性があるように調整された設定を持つ、page
の複製を返します。たとえば、返された PageFormat
は、現在のプリンタが使用している用紙の物理的領域内に収まるように調整されたイメージング可能領域を持つことができます。
page
- 複製され、その設定が現在のプリンタと互換性を持つように変更される PageFormat
Page
から複製され、この PrinterJob
に合わせて設定が変更される PageFormat
public abstract void print() throws PrinterException
PrinterException
- 印刷システムのエラーが原因でジョブが停止した場合Book
,
Pageable
,
Printable
public void print(PrintRequestAttributeSet attributes) throws PrinterException
一部の属性は、同じメソッドの呼び出しによって直接 PrinterJob に設定される場合があります。このメソッドの呼び出しの例には、copies: setcopies(int)
、job name: setJobName(String)
、および PageFormat
オブジェクトの指定にかかわらずメディアのサイズと印刷方向を指定する場合があります。
サポートされる属性値がこの属性セットに指定されている場合は、この print() オペレーションの場合だけ API 設定より優先されます。次に述べる動作は PageFormat に対して指定されます。クライアントが Printable インタフェースを使用している場合、このメソッドに対する attributes
パラメータは、メディアサイズ、印刷方向、およびイメージング可能領域を指定する属性が検査され、これらは Printable オブジェクトの print() メソッドに渡される新しい PageFormat を構築するために使用されます。Pageable インタフェースを使用するクライアントの場合、PageFormat は常にこのインタフェースにより 1 ページごとに提供されます。
これらの動作により、アプリケーションは printDialog(PrintRequestAttributeSet attributes
から返されるユーザ設定を、直接この print() メソッドに渡せるようになります。
attributes
- ジョブの属性のセット
PrinterException
- 印刷システムのエラーが原因でジョブが停止した場合Book
,
Pageable
,
Printable
public abstract void setCopies(int copies)
copies
- 印刷する部数getCopies()
public abstract int getCopies()
setCopies(int)
public abstract String getUserName()
public abstract void setJobName(String jobName)
null
を指定することはできません。
jobName
- 印刷するドキュメントの名前getJobName()
public abstract String getJobName()
setJobName(java.lang.String)
public abstract void cancel()
print
が呼び出されている場合に、まだ復帰していない状態のときは、このメソッドはジョブを次の機会に取り消すように通知します。実行中の印刷ジョブがない場合には、何も行いません。
public abstract boolean isCancelled()
true
、そうでない場合は false
を返します。
true
、そうでない場合は false
|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.