JavaTM 2 Platform
Standard Ed. 5.0

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)
调用此方法来通知客户端,不需要再提供事件。生成此事件的原因之一是:作业已成功完成,但打印系统功能有限,无法验证此事件。如果未提供其他的终端事件(完成/失败/取消),则必须提供此事件。

参数:
pje - 生成此事件的作业

printJobRequiresAttention

void printJobRequiresAttention(PrintJobEvent pje)
调用此方法来通知客户端,发生了一个用户也许能够修复的错误,可以生成此事件的一个错误示例是打印机用完了纸张。

参数:
pje - 生成此事件的作业

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策