PrinterJob (Java Platform SE 8)

java.lang.Object
- java.awt.print.PrinterJob

```
public abstract class PrinterJob
extends Object
```
PrinterJobクラスは、印刷を制御する主要なクラスです。アプリケーションはこのクラスのメソッドを呼び出して、ジョブを設定し、必要に応じて印刷のダイアログを呼び出し、そのあとジョブのページを印刷します。

コンストラクタのサマリー

コンストラクタ
コンストラクタ説明

PrinterJob()
PrinterJobオブジェクトは、getPrinterJob staticメソッドを使用して作成するようにしてください。

コンストラクタ
コンストラクタ	説明
`PrinterJob()`	`PrinterJob`オブジェクトは、`getPrinterJob` staticメソッドを使用して作成するようにしてください。

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド抽象メソッド具象メソッド
修飾子と型	メソッド	説明
`abstract void`	`cancel()`	実行中の印刷ジョブを取り消します。
`PageFormat`	`defaultPage()`	新しい`PageFormat`のインスタンスを生成し、デフォルトのサイズと印刷方向に設定します。
`abstract PageFormat`	`defaultPage(PageFormat page)`	`PageFormat`引数を複製し、その複製を変更してデフォルトのページ・サイズと印刷方向を記述します。
`abstract int`	`getCopies()`	印刷する部数を返します。
`abstract String`	`getJobName()`	印刷するドキュメントの名前を返します。
`PageFormat`	`getPageFormat(PrintRequestAttributeSet attributes)`	このジョブの現在の`PrintService`でサポートされる値と一致する値(つまり、`getPrintService()`で返される値)、および`attributes`に格納されたメディア、印刷可能領域、印刷方向を使用して、`PageFormat`を計算します。
`static PrinterJob`	`getPrinterJob()`	初期状態でデフォルト・プリンタに関連付けられた`PrinterJob`を作成して返します。
`PrintService`	`getPrintService()`	この印刷ジョブのサービス(プリンタ)を返します。
`abstract String`	`getUserName()`	印刷を行うユーザーの名前を返します。
`abstract boolean`	`isCancelled()`	印刷ジョブが実行中であり、次の機会に取り消される予定の場合は`true`、そうでない場合は`false`を返します。
`static PrintService[]`	`lookupPrintServices()`	2D印刷サービスを検索する簡易メソッドです。
`static StreamPrintServiceFactory[]`	`lookupStreamPrintServices(String mimeType)`	2Dグラフィックスの描画が可能なストリーム印刷サービスのファクトリを検出する簡易メソッドです。
`abstract PageFormat`	`pageDialog(PageFormat page)`	`PageFormat`のインスタンスを変更するためのダイアログを表示します。
`PageFormat`	`pageDialog(PrintRequestAttributeSet attributes)`	共通プラットフォームのページ設定ダイアログを表示する簡易メソッドです。
`abstract void`	`print()`	ページのセットを印刷します。
`void`	`print(PrintRequestAttributeSet attributes)`	属性セットの設定を使用してページのセットを印刷します。
`abstract boolean`	`printDialog()`	ユーザーに対して、印刷ジョブのプロパティを変更するためのダイアログを表示します。
`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`の複製を返します。

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - 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 NullPointerException
```
    documentに対して、ページ数や、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 HeadlessException
```
    PageFormatのインスタンスを変更するためのダイアログを表示します。引数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
```
    属性セットの設定を使用してページのセットを印刷します。デフォルトの実装は属性セットを無視します。
    一部の属性は、同じメソッドの呼出しによって直接PrinterJobに設定される場合があります。このメソッドの呼出しの例には、copies: 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()
```
    印刷を行うユーザーの名前を返します。
    
    戻り値:
    
    印刷を行うユーザーの名前
  - 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。

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスPrinterJob

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

コンストラクタの詳細

PrinterJob

メソッドの詳細

getPrinterJob

lookupPrintServices

lookupStreamPrintServices

getPrintService

setPrintService

setPrintable

setPrintable

setPageable

printDialog

printDialog

pageDialog

pageDialog

defaultPage

defaultPage

getPageFormat

validatePage

print

print

setCopies

getCopies

getUserName

setJobName

getJobName

cancel

isCancelled