JavaTM Platform
Standard Ed. 6

javax.print
インタフェース DocPrintJob

既知のサブインタフェースの一覧:
CancelablePrintJob, MultiDocPrintJob

public interface DocPrintJob

このインタフェースは、ジョブ属性セットを保持する指定されたドキュメントを印刷可能な印刷ジョブを表します。このインタフェースを実装するオブジェクトは、印刷サービスから取得できます。


メソッドの概要
 void addPrintJobAttributeListener(PrintJobAttributeListener listener, PrintJobAttributeSet attributes)
          指定された属性の変更用のリスナーを登録します。
 void addPrintJobListener(PrintJobListener listener)
          この印刷ジョブ時に発生するイベントのリスナーを登録します。
 PrintJobAttributeSet getAttributes()
          この Print Job の印刷属性セットを取得します。
 PrintService getPrintService()
          この印刷ジョブがバインドされている PrintService オブジェクトを判別します。
 void print(Doc doc, PrintRequestAttributeSet attributes)
          ドキュメントを指定されたジョブ属性で印刷します。
 void removePrintJobAttributeListener(PrintJobAttributeListener listener)
          この印刷ジョブから属性リスナーを削除します。
 void removePrintJobListener(PrintJobListener listener)
          この印刷ジョブからリスナーを削除します。
 

メソッドの詳細

getPrintService

PrintService getPrintService()
この印刷ジョブがバインドされている PrintService オブジェクトを判別します。

戻り値:
PrintService オブジェクト

getAttributes

PrintJobAttributeSet getAttributes()
この Print Job の印刷属性セットを取得します。返される属性セットオブジェクトは変更できません。返される属性セットオブジェクトは、この Print Job の属性セットの getAttributes() メソッド呼び出し時の「スナップショット」です。 つまり、この Print Job の属性セットの内容が将来変更されても、返される属性セットオブジェクトの内容は更新されません。属性値の変更を検出するには、getAttributes() を再度呼び出して、新規属性セットを以前の属性セットと比較します。 もう 1 つの方法として、印刷ジョブイベントのリスナーを登録することもできます。戻り値は、空のセットでもかまいませんが、null にすることはできません。

戻り値:
印刷ジョブ属性

addPrintJobListener

void addPrintJobListener(PrintJobListener listener)
この印刷ジョブ時に発生するイベントのリスナーを登録します。listener が null の場合は、例外はスローされず、何も処理はありません。リスナーが登録済みの場合、再度登録されます。

パラメータ:
listener - リスナーインタフェースを実装するオブジェクト
関連項目:
removePrintJobListener(javax.print.event.PrintJobListener)

removePrintJobListener

void removePrintJobListener(PrintJobListener listener)
この印刷ジョブからリスナーを削除します。引数で指定されたリスナーが以前にこのコンポーネントに追加されたことがない場合、このメソッドは何も実行せず、例外もスローしません。listener が null の場合は、例外はスローされず、何も処理はありません。リスナーが複数回登録されている場合、登録の 1 つだけが削除されます。

パラメータ:
listener - リスナーインタフェースを実装するオブジェクト
関連項目:
addPrintJobListener(javax.print.event.PrintJobListener)

addPrintJobAttributeListener

void addPrintJobAttributeListener(PrintJobAttributeListener listener,
                                  PrintJobAttributeSet attributes)
指定された属性の変更用のリスナーを登録します。listener が null の場合は、例外はスローされず、何も処理はありません。このジョブが報告する属性更新を判別するため、クライアントは getAttributes() を呼び出して、リスナーに報告するような関心のあるサブセットを識別できます。特定のジョブ属性の変更更新を期待しているクライアントは、該当するセットであることを確認する必要があります。 ただし、属性の更新は、実際に変更が行われ、ジョブがそれを検出した場合だけに実行されます。更新はまた、ジョブによるバッチ処理の対象になる場合があります。印刷ジョブの処理で発生するオーバーヘッドを最小限に抑えるため、変更が行われる可能性の高い属性のサブセットだけで待機を行うことをお勧めします。指定されたセットが空の場合、属性の更新はリスナーに報告されません。属性セットが null の場合、ジョブがサポートするすべての動的属性で待機することを意味します。このため、ジョブが属性更新を 1 つも報告できない場合、更新通知は一切行われません。 リスナーが登録済みの場合、再度登録されます。

パラメータ:
listener - リスナーインタフェースを実装するオブジェクト
attributes - ジョブによって決定された待機対象の属性、 または変更可能なすべての属性を意味する null
関連項目:
removePrintJobAttributeListener(javax.print.event.PrintJobAttributeListener)

removePrintJobAttributeListener

void removePrintJobAttributeListener(PrintJobAttributeListener listener)
この印刷ジョブから属性リスナーを削除します。引数で指定されたリスナーが以前にこのコンポーネントに追加されたことがない場合、このメソッドは何も実行せず、例外もスローしません。リスナーが null の場合、例外はスローされず、アクションは実行されません。リスナーが複数回登録されている場合 (それが異なる属性セットに対してであっても)、どのリスナーが削除されるかは保証されません。

パラメータ:
listener - リスナーインタフェースを実装するオブジェクト
関連項目:
addPrintJobAttributeListener(javax.print.event.PrintJobAttributeListener, javax.print.attribute.PrintJobAttributeSet)

print

void print(Doc doc,
           PrintRequestAttributeSet attributes)
           throws PrintException
ドキュメントを指定されたジョブ属性で印刷します。このメソッドは、指定された印刷ジョブで一度だけ呼び出す必要があります。このメソッドを再度呼び出しても、新規ジョブがプリンタにスプールされることはありません。サービス実装は、サービス割り込みおよび復元のポリシーを定義します。印刷メソッドの復帰時に、異なるスレッドで印刷が非同期に発生したなどの理由で、印刷が完了していない場合があります。成功または失敗を監視するアプリケーションクライアントは、PrintJobListener を登録する必要があります。

印刷サービスの実装者は、クライアント doc から取得したすべての印刷データストリーム (Reader または InputStream 実装) を閉じる必要があります。 堅牢なクライアントの中には、これを検証するものもあります。DocFlavor を出力できない場合、常に例外が生成されます。

パラメータ:
doc - 印刷するドキュメント。この PrintJob がサポートするフレーバでなければならない
attributes - この印刷ジョブに適用するジョブ属性。このパラメータが null の場合、デフォルト属性が使用される
例外:
PrintException - この例外によって、原因をより正確に記述するインタフェースが実装されることもある
  • FlavorException。ドキュメントにこの印刷ジョブでサポートされないフレーバが含まれている場合
  • AttributeException。この印刷ジョブに有効でない属性が 1 つ以上ある場合

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。