javax.print

Interface CancelablePrintJob

All Superinterfaces:

DocPrintJob

public interface CancelablePrintJob
extends DocPrintJob

此接口用于打印应用程序以取消打印作业。这 DocPrintJob接口扩展，实现 DocPrintJob返回打印服务实现此接口，如果打印作业将被取消。要想取消打印任务，客户需要测试，如果从打印服务返回的 DocPrintJob对象实际实现这个接口。客户不应该假设一个 DocPrintJob实现这个接口。打印服务可能支持取消只用于某些类型的打印数据和表示类名称。这意味着，只有部分的 DocPrintJob对象返回的服务将实现该接口。

服务的执行者，鼓励实施这个可选的接口，提供一个javax.print.event.printjobevent.job_cancelled事件任何听众如果工作成功地取消了与此接口的实现。服务还应该注意到，这种方法的实现可能是由一个单独的客户端线程，而不是由打印请求。因此，这个接口的实现必须是线程安全的。

方法摘要

Modifier and Type	Method and Description
void	cancel() 停止打印作业的进一步处理。

Methods inherited from interface javax.print.DocPrintJob

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

方法详细信息

cancel

void cancel()
     throws PrintException

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

如果一个服务支持这种方法，它不能得出结论，工作取消将永远成功。一个工作可能无法被取消，一旦达到，并通过了一些点在其处理。一个成功的取消意味着只有整个工作没有打印，一些部分可能已经打印时取消返回。

该服务将如果取消没有成功把一printexception。尚未提交打印的作业应该抛出这个异常。取消已成功取消的打印作业不被认为是一个错误，并将永远成功。

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

异常

PrintException如果工作不能成功取消。