モジュール java.desktop

パッケージ 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の印刷属性セットを取得します。 返される属性セット・オブジェクトは変更できません。 返される属性セット・オブジェクトは、この印刷ジョブ'getAttributes()メソッド・コール時に設定されたs属性、つまり返される属性セット'のオブジェクト'この印刷ジョブの場合、コンテンツは更新されません'の属性セットの内容が将来変更される"スナップショット"です。 属性値の変更を検出するには、getAttributes()を再度呼び出して、新規属性セットを以前の属性セットと比較します。もう1つの方法として、印刷ジョブ・イベントのリスナーを登録することもできます。 返される値は空のセットですが、nullであってはなりません。

戻り値:

印刷ジョブ属性

addPrintJobListener

void addPrintJobListener(PrintJobListener listener)

この印刷ジョブ時に発生するイベントのリスナーを登録します。 リスナーがnullの場合、例外はスローされず、アクションは実行されません。 リスナーが登録済みの場合、再度登録されます。

パラメータ:

listener - リスナー・インタフェースを実装するオブジェクト

関連項目:

• removePrintJobListener(javax.print.event.PrintJobListener)

removePrintJobListener

void removePrintJobListener(PrintJobListener listener)

この印刷ジョブからリスナーを削除します。 引数で指定されたリスナーがこの印刷ジョブに以前に追加されていない場合、このメソッドは機能を実行せず、例外もスローしません。 リスナーがnullの場合、例外はスローされず、アクションは実行されません。 リスナーが複数回登録されている場合、登録の1つだけが削除されます。

パラメータ:

listener - リスナー・インタフェースを実装するオブジェクト

関連項目:

• addPrintJobListener(javax.print.event.PrintJobListener)

addPrintJobAttributeListener

void addPrintJobAttributeListener(PrintJobAttributeListener listener, PrintJobAttributeSet attributes)

指定された属性の変更用のリスナーを登録します。 リスナーが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を登録する必要があります。

印刷サービスの実装者は、クライアント文書から取得するすべての印刷データ・ストリームを閉じなければなりません。 堅牢なクライアントの中には、これを検証するものもあります。 DocFlavorを出力できない場合、常に例外が生成されます。

パラメータ:

doc - 印刷されるドキュメント。 このPrintJobでサポートされているフレーバでなければなりません。

attributes - この印刷ジョブに適用されるジョブ属性。 このパラメータがnullの場合、デフォルトの属性が使用されます。

例外:

PrintException - 例外はさらに、例外の原因をより正確に記述するインタフェースを実装することができる

• FlavorException. ドキュメントにこの印刷ジョブでサポートされないフレーバが含まれている場合
• AttributeException. この印刷ジョブに有効でない属性が1つ以上ある場合