模块 java.desktop

软件包 javax.print

Interface CancelablePrintJob

All Superinterfaces:

DocPrintJob

public interface CancelablePrintJobextends DocPrintJob

打印应用程序使用此接口取消打印作业。 此接口扩展名为DocPrintJob 。 如果可以取消打印作业，则从打印服务返回的DocPrintJob实现实现此接口。 在尝试取消打印作业之前，客户端需要测试从打印服务返回的DocPrintJob对象是否实际实现了此接口。 客户端永远不应该假设DocPrintJob实现了此接口。 打印服务可能仅支持取消某些类型的打印数据和表示类名称。 这意味着只有部分从服务返回的DocPrintJob对象才会实现此接口。

如果使用此接口的实现成功取消作业，则鼓励服务实现者实现此可选接口并向任何侦听器传递PrintJobEvent.JOB_CANCELED事件。 服务还应注意，此方法的实现可以从单独的客户端线程进行，而不是发出打印请求的客户端线程。 因此，必须使此接口的实现成为线程安全的。

方法摘要

变量和类型	方法	描述
void	cancel()	停止进一步处理打印作业。

声明方法的接口 javax.print.DocPrintJob

addPrintJobAttributeListener, addPrintJobListener, getAttributes, getPrintService, print, removePrintJobAttributeListener, removePrintJobListener

方法详细信息

cancel

void cancel()     throws PrintException

停止进一步处理打印作业。

如果服务支持此方法，则无法断定取消作业将始终成功。 一旦工作达到并通过处理中的某个点，工作可能无法取消。 成功取消仅表示未打印整个作业，取消返回时某些部分可能已经打印。

如果取消没有成功，该服务将抛出PrintException 。 尚未提交打印的作业应抛出此异常。 取消已成功取消的打印作业不会被视为错误，并且始终会成功。

某些服务中的取消可能是一个漫长的过程，涉及对服务器的请求和其打印队列的处理。 客户端可能希望在不影响应用程序执行的线程中执行cancel。

异常

PrintException - 如果作业无法成功取消