javax.print.event

インタフェースPrintJobListener

既知のすべての実装クラス:

PrintJobAdapter

public interface PrintJobListener

このリスナー・インタフェースの実装は、DocPrintJobに接続され、印刷ジョブの状態を監視します。これらのコールバック・メソッドは、印刷ジョブを処理するスレッドまたはサービスを作成する通知スレッドで呼び出されます。いずれの場合でも、クライアントはこれらのコールバックで冗長な処理を実行する必要はありません。

メソッドのサマリー

修飾子と型	メソッドと説明
void	printDataTransferCompleted(PrintJobEvent pje) データが正常に印刷サービスに転送され、クライアントがそのデータに割り当てたローカル・リソースを解放できることをクライアントに通知するために呼び出されます。
void	printJobCanceled(PrintJobEvent pje) ジョブがユーザーまたはプログラムによって取り消されたことをクライアントに通知するために呼び出されます。
void	printJobCompleted(PrintJobEvent pje) ジョブが正常に完了したことをクライアントに通知するために呼び出されます。
void	printJobFailed(PrintJobEvent pje) ジョブが正常に完了しなかったこと、および再送信が必要であることをクライアントに通知するために呼び出されます。
void	printJobNoMoreEvents(PrintJobEvent pje) イベントの送信がこれ以上ないことをクライアントに通知するために呼び出されます。
void	printJobRequiresAttention(PrintJobEvent pje) ユーザーが修復できるエラーが発生したことをクライアントに通知するために呼び出されます。

メソッドの詳細

printDataTransferCompleted

void printDataTransferCompleted(PrintJobEvent pje)

データが正常に印刷サービスに転送され、クライアントがそのデータに割り当てたローカル・リソースを解放できることをクライアントに通知するために呼び出されます。クライアントは、このイベントを受け取ったあと、データが完全に印刷されたものと見なしてはいけません。このイベントを受け取らない場合、クライアントはリソースを解放する前に終端イベント(完了/取り消し/失敗)を待機しなければいけません。

パラメータ:

pje - このイベントを生成するジョブ

printJobCompleted

void printJobCompleted(PrintJobEvent pje)

ジョブが正常に完了したことをクライアントに通知するために呼び出されます。

パラメータ:

pje - このイベントを生成するジョブ

printJobFailed

void printJobFailed(PrintJobEvent pje)

ジョブが正常に完了しなかったこと、および再送信が必要であることをクライアントに通知するために呼び出されます。

パラメータ:

pje - このイベントを生成するジョブ

printJobCanceled

void printJobCanceled(PrintJobEvent pje)

ジョブがユーザーまたはプログラムによって取り消されたことをクライアントに通知するために呼び出されます。

パラメータ:

pje - このイベントを生成するジョブ

printJobNoMoreEvents

void printJobNoMoreEvents(PrintJobEvent pje)

イベントの送信がこれ以上ないことをクライアントに通知するために呼び出されます。このイベントが生成される原因の1つは、ジョブは正常に完了したが、印刷システムの機能に制限があり、これを検証できないことがあります。このイベントは、完了/失敗/取り消しなどの終端イベントが送信されない場合に送信が必要になります。

パラメータ:

pje - このイベントを生成するジョブ

printJobRequiresAttention

void printJobRequiresAttention(PrintJobEvent pje)

ユーザーが修復できるエラーが発生したことをクライアントに通知するために呼び出されます。このイベントを生成するエラーの例の1つにプリンタの用紙切れがあります。

パラメータ:

pje - このイベントを生成するジョブ