PrinterJob
クラスは、印刷を制御する主要なクラスです。 アプリケーションはこのクラスのメソッドを呼び出して、ジョブを設定し、必要に応じて印刷のダイアログを呼び出し、そのあとジョブのページを印刷します。 -
コンストラクタのサマリー
-
メソッドのサマリー
修飾子と型メソッド説明abstract void
cancel()
実行中の印刷ジョブを取り消します。新しいPageFormat
のインスタンスを生成し、デフォルトのサイズと印刷方向に設定します。abstract PageFormat
defaultPage(PageFormat page)
PageFormat
引数を複製し、その複製を変更してデフォルトのページ・サイズと印刷方向を記述します。abstract int
印刷する部数を返します。abstract String
印刷するドキュメントの名前を返します。getPageFormat(PrintRequestAttributeSet attributes)
このジョブの現在のPrintService
でサポートされる値と一致する値(つまり、getPrintService()
で返される値)、およびattributes
に格納されたメディア、印刷可能領域、印刷方向を使用して、PageFormat
を計算します。static PrinterJob
初期状態でデフォルト・プリンタに関連付けられたPrinterJob
を作成して返します。この印刷ジョブのサービス(プリンタ)を返します。abstract String
印刷を行うユーザーの名前を返します。abstract boolean
印刷ジョブが実行中であり、次の機会に取り消される予定の場合はtrue
、そうでない場合はfalse
を返します。static PrintService[]
2D印刷サービスを検索する簡易メソッドです。static StreamPrintServiceFactory[]
lookupStreamPrintServices(String mimeType)
2Dグラフィックスの描画が可能なストリーム印刷サービスのファクトリを検出する簡易メソッドです。abstract PageFormat
pageDialog(PageFormat page)
PageFormat
のインスタンスを変更するためのダイアログを表示します。pageDialog(PrintRequestAttributeSet attributes)
共通プラットフォームのページ設定ダイアログを表示する簡易メソッドです。abstract void
print()
ページのセットを印刷します。void
print(PrintRequestAttributeSet attributes)
属性セットの設定を使用してページのセットを印刷します。abstract boolean
ユーザーに対して、印刷ジョブのプロパティを変更するためのダイアログを表示します。boolean
printDialog(PrintRequestAttributeSet attributes)
共通プラットフォームのすべてのサービスに対する印刷ダイアログを表示する簡易メソッドです。Pageable
インタフェースを使用して2Dグラフィックスの印刷が可能です。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
の複製を返します。
-
コンストラクタの詳細
-
PrinterJob
public PrinterJob()PrinterJob
オブジェクトは、getPrinterJob
staticメソッドを使用して作成するようにしてください。
-
-
メソッドの詳細
-
getPrinterJob
public static PrinterJob getPrinterJob()初期状態でデフォルト・プリンタに関連付けられたPrinterJob
を作成して返します。 システムでプリンタが使用できない場合でも、PrinterJobがこのメソッドから返されます。ただし、getPrintService()
はnull
を返し、このPrinterJob
でprint
を呼び出すと、例外が生成される場合があります。PrinterJob
を作成する前に適切なプリンタがあるかどうかを判別する必要があるアプリケーションは、lookupPrintServices
から返された配列が空でないことを確認する必要があります。- 戻り値:
- 新しい
PrinterJob
。 - 例外:
SecurityException
- セキュリティ・マネージャが存在し、セキュリティ・マネージャのSecurityManager.checkPrintJobAccess()
メソッドにより、このスレッドでの出力ジョブ要求の作成が禁止されている場合
-
lookupPrintServices
public static PrintService[] lookupPrintServices()2D印刷サービスを検索する簡易メソッドです。 このメソッドから返されたサービスは、印刷サービスをサポートするPrinterJob
にインストールできます。 このメソッドの呼出しは、Pageable DocFlavorを指定してPrintServiceLookup.lookupPrintServices()
を呼出すことと同等です。- 戻り値:
- 2D印刷サービスの空の可能性がある配列
- 導入されたバージョン:
- 1.4
-
lookupStreamPrintServices
public static StreamPrintServiceFactory[] lookupStreamPrintServices(String mimeType)2Dグラフィックスの描画が可能なストリーム印刷サービスのファクトリを検出する簡易メソッドです。 使用例:
このメソッドから返されたサービスは、印刷サービスをサポートするFileOutputStream outstream; StreamPrintService psPrinter; String psMimeType = "application/postscript"; PrinterJob pj = PrinterJob.getPrinterJob(); StreamPrintServiceFactory[] factories = PrinterJob.lookupStreamPrintServices(psMimeType); if (factories.length > 0) { try { outstream = new File("out.ps"); psPrinter = factories[0].getPrintService(outstream); // psPrinter can now be set as the service on a PrinterJob pj.setPrintService(psPrinter) } catch (Exception e) { e.printStackTrace(); } }
PrinterJob
インスタンスにインストールできます。 このメソッドの呼出しは、Pageable DocFlavorを指定してStreamPrintServiceFactory.lookupStreamPrintServiceFactories()
を呼出すことと同等です。- パラメータ:
mimeType
- 要求された出力形式、またはnull (任意の形式を意味)。- 戻り値:
- 出荷時の2D印刷サービス・ストリームが空の可能性がある配列
- 導入されたバージョン:
- 1.4
-
getPrintService
public PrintService getPrintService()この印刷ジョブのサービス(プリンタ)を返します。 印刷サービスをサポートしないこのクラスの実装はnullを返します。プリンタを利用できない場合もnullが返されます。- 戻り値:
- この印刷ジョブのサービス。
- 導入されたバージョン:
- 1.4
- 関連項目:
setPrintService(PrintService)
,getPrinterJob()
-
setPrintService
public void setPrintService(PrintService service) throws PrinterExceptionこのPrinterJobを新しいPrintServiceに関連付けます。 このメソッドはPrint Serviceの指定をサポートするサブクラスにオーバーライドされます。 指定されたサービスが、2D印刷のサポートに必要なPageable
およびPrintable
インタフェースをサポートできない場合はPrinterException
をスローします。- パラメータ:
service
- 2D印刷をサポートする印刷サービス- 例外:
PrinterException
- 指定されたサービスが2D印刷をサポートしない場合、またはこのPrinterJobクラスが2D印刷サービスの設定をサポートしない場合、またはこれ以外の場合で指定されたサービスが有効な印刷サービスではない場合。- 導入されたバージョン:
- 1.4
- 関連項目:
getPrintService()
-
setPrintable
public abstract void setPrintable(Printable painter)ページを描画するためにpainter
を呼び出します。 このPrinterJob
によって印刷されるドキュメント内のページは、painter
で指定されたPrintable
オブジェクトによって描画されます。 各ページのPageFormat
は、デフォルトのページ書式になります。- パラメータ:
painter
- ドキュメントの各ページを描画するPrintable
。
-
setPrintable
public abstract void setPrintable(Printable painter, PageFormat format)指定されたformat
でページを描画するためにpainter
を呼び出します。 このPrinterJob
によって印刷されるドキュメント内のページは、painter
で指定されたPrintable
オブジェクトによって描画されます。 各ページのPageFormat
は、format
です。- パラメータ:
painter
- ドキュメントの各ページを描画するために呼び出すPrintable
format
- 印刷される各ページのサイズと印刷方向
-
setPageable
public abstract void setPageable(Pageable document) throws NullPointerExceptiondocument
に対して、ページ数や、Pageable
のインスタンス(document
)に保持されている各ページのPageFormat
およびPrintable
を問い合わせます。- パラメータ:
document
- 印刷されるページ。null
であってはならない。- 例外:
NullPointerException
- 渡されたPageable
がnull
だった。- 関連項目:
PageFormat
、Printable
-
printDialog
public abstract boolean printDialog() throws HeadlessExceptionユーザーに対して、印刷ジョブのプロパティを変更するためのダイアログを表示します。 このメソッドは、ネイティブな印刷サービスが選択されている場合はネイティブ・ダイアログを表示し、ユーザーのプリンタの選択はこれらのネイティブな印刷サービスに制限されます。 共通プラットフォームのネイティブ印刷サービスを含むすべてのサービスに対する印刷ダイアログを表示するには、代わりにprintDialog(PrintRequestAttributeSet)
を使用します。PrintServiceの印刷ダイアログを使用できるPrinterJobの実装により、このPrinterJobに対するPrintServiceが更新されユーザーが選択するサービスが反映されます。
- 戻り値:
- ユーザーがダイアログを取り消さない場合は
true
、そうでない場合はfalse
。 - 例外:
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返した場合。- 関連項目:
GraphicsEnvironment.isHeadless()
-
printDialog
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の場合。- 導入されたバージョン:
- 1.4
- 関連項目:
GraphicsEnvironment.isHeadless()
-
pageDialog
public abstract PageFormat pageDialog(PageFormat page) throws HeadlessExceptionPageFormat
のインスタンスを変更するためのダイアログを表示します。 引数page
は、ページ設定ダイアログのコントロールを初期化するために使用されます。 ユーザーがダイアログを取り消すと、このメソッドは元のpage
オブジェクトを変更しないで返します。 ユーザーがダイアログを了解すると、このメソッドは変更内容を示す新しいPageFormat
を返します。 どちらの場合にも、元のpage
オブジェクトは変更されません。- パラメータ:
page
- 変更のためにユーザーに対して表示されるデフォルトのPageFormat
- 戻り値:
- ダイアログがキャンセルされた場合は、元の
page
オブジェクト。ダイアログが受け入れられた場合は、ユーザーが指定した形式を含む新しいPageFormat
オブジェクト。 - 例外:
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返した場合。- 導入されたバージョン:
- 1.2
- 関連項目:
GraphicsEnvironment.isHeadless()
-
pageDialog
public PageFormat pageDialog(PrintRequestAttributeSet attributes) throws HeadlessException共通プラットフォームのページ設定ダイアログを表示する簡易メソッドです。 有効な選択は、このPrinterJobに現在設定されている印刷ジョブを反映します。属性パラメータon inputは、クライアントが要求するユーザー・ダイアログでの初期選択を反映します。 属性が指定されない場合は、印刷サービスのデフォルトの属性を使用して表示されます。 属性パラメータon returnは、ユーザーの選択を反映します。 選択は、現在選択されている印刷サービスがサポートする値と一致するように更新されます。
戻り値はPrintRequestAttributeSetでの選択と同等のPageFormatです。 ユーザーがダイアログを取り消した場合、属性はユーザーが行った変更を反映しません。戻り値はnullです。
- パラメータ:
attributes
- on inputは属性が提供するアプリケーションである。on outputはユーザーの選択によって内容が更新される。 このパラメータはnullにはならない。- 戻り値:
- ユーザーがダイアログを取り消さない場合はページ書式、そうでない場合は
null
。 - 例外:
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返した場合。NullPointerException
-attributes
パラメータがnullの場合。- 導入されたバージョン:
- 1.4
- 関連項目:
GraphicsEnvironment.isHeadless()
-
defaultPage
public abstract PageFormat defaultPage(PageFormat page)PageFormat
引数を複製し、その複製を変更してデフォルトのページ・サイズと印刷方向を記述します。- パラメータ:
page
- 複製および変更されるPageFormat
- 戻り値:
- デフォルトの
PageFormat
を記述するために変更されたpage
の複製。
-
defaultPage
public PageFormat defaultPage()新しいPageFormat
のインスタンスを生成し、デフォルトのサイズと印刷方向に設定します。- 戻り値:
- デフォルトのサイズと向きに設定された
PageFormat
。
-
getPageFormat
public PageFormat getPageFormat(PrintRequestAttributeSet attributes)このジョブの現在のPrintService
でサポートされる値と一致する値(つまり、getPrintService()
で返される値)、およびattributes
に格納されたメディア、印刷可能領域、印刷方向を使用して、PageFormat
を計算します。このメソッドを呼び出しても、ジョブは更新されません。 このメソッドは、クライアントが
printDialog(PrintRequestAttributeSet attributes)
から取得した属性のセットを持ち、Pageableオブジェクトを印刷するためにPageFormatが必要な場合に便利です。- パラメータ:
attributes
- 印刷属性のセット。たとえばprintDialogを呼び出すことで取得される。attributes
がnullの場合、デフォルトのPageFormatが返される。- 戻り値:
- 現在のサービスの設定および指定された属性と一致した設定を持つ
PageFormat
。 - 導入されたバージョン:
- 1.6
-
validatePage
public abstract PageFormat validatePage(PageFormat page)このPrinterJob
の現在のプリンタと互換性があるように調整された設定を持つ、page
の複製を返します。 たとえば、返されたPageFormat
は、現在のプリンタが使用している用紙の物理的領域内に収まるように調整されたイメージング可能領域を持つことができます。- パラメータ:
page
- 複製され、その設定が現在のプリンタと互換性を持つように変更されたPageFormat
- 戻り値:
page
から複製され、このPrinterJob
に合わせて設定が変更されたPageFormat
。
-
print
public abstract void print() throws PrinterExceptionページのセットを印刷します。- 例外:
PrinterException
- 印刷システムのエラーが原因でジョブが停止した。- 関連項目:
Book
、Pageable
、Printable
-
print
public void print(PrintRequestAttributeSet attributes) throws PrinterException属性セットの設定を使用してページのセットを印刷します。 デフォルトの実装は属性セットを無視します。いくつかの属性は、同等のメソッド呼び出し、(例えば)、copiesによって直接PrinterJobに設定されることに注意してください:
setCopies(int)
、ジョブ名:setJobName(String)
およびPageFormat
オブジェクトを使用してメディアのサイズと向きを指定します。サポートされる属性値がこの属性セットに指定されている場合は、このprint()オペレーションの場合だけAPI設定より優先されます。 次に述べる動作はPageFormatに対して指定されます。クライアントがPrintableインタフェースを使用している場合、このメソッドに対する
attributes
パラメータは、メディア・サイズ、印刷方向、およびイメージング可能領域を指定する属性が検査され、これらはPrintableオブジェクトのprint()メソッドに渡される新しいPageFormatを構築するために使用されます。 PrinterJobによる最適な印刷に必要なPrintableの動作については、Printable
を参照してください。 Pageableインタフェースを使用するクライアントの場合、PageFormatは常にこのインタフェースにより1ページごとに提供されます。これらの動作により、アプリケーションは
printDialog(PrintRequestAttributeSet attributes
から返されるユーザー設定を、直接このprint()メソッドに渡せるようになります。- パラメータ:
attributes
- ジョブの属性のセット- 例外:
PrinterException
- 印刷システムのエラーが原因でジョブが停止した。- 導入されたバージョン:
- 1.4
- 関連項目:
Book
、Pageable
、Printable
-
setCopies
public abstract void setCopies(int copies)印刷する部数を設定します。- パラメータ:
copies
- 印刷する部数- 関連項目:
getCopies()
-
getCopies
public abstract int getCopies()印刷する部数を返します。- 戻り値:
- 印刷する部数。
- 関連項目:
setCopies(int)
-
getUserName
public abstract String getUserName()印刷を行うユーザーの名前を返します。- 戻り値:
- 印刷を行うユーザーの名前
- 例外:
SecurityException
- セキュリティ・マネージャが存在し、PropertyPermission - user.nameはポリシー・ファイルで指定されていません
-
setJobName
public abstract void setJobName(String jobName)印刷するドキュメントの名前を設定します。 ドキュメントの名前にnull
を指定することはできません。- パラメータ:
jobName
- 印刷するドキュメントの名前- 関連項目:
getJobName()
-
getJobName
public abstract String getJobName()印刷するドキュメントの名前を返します。- 戻り値:
- 印刷するドキュメントの名前
- 関連項目:
setJobName(java.lang.String)
-
cancel
public abstract void cancel()実行中の印刷ジョブを取り消します。print
が呼び出されていても、まだ復帰していない状態のときは、このメソッドはジョブを次の機会に取り消すように通知します。 実行中の印刷ジョブがない場合には、何も行いません。 -
isCancelled
public abstract boolean isCancelled()印刷ジョブが実行中であり、次の機会に取り消される予定の場合はtrue
、そうでない場合はfalse
を返します。- 戻り値:
- 実行中のジョブが取り消される予定の場合は
true
、そうでない場合はfalse
。
-