CancelablePrintJob (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
javax.print
接口 CancelablePrintJob
- 所有超级接口：
- DocPrintJob
public interface CancelablePrintJob
- extends DocPrintJob
打印应用程序使用此接口来取消打印作业。此接口扩展了 DocPrintJob。如果打印作业是可取消的，则从 PrintService 所返回的 DocPrintJob 实现来实现此接口。尝试取消某个打印作业之前，客户端需要测试 PrintService 所返回的 DocPrintJob 对象是否实际上实现了此接口。客户端永远不应假定 DocPrintJob 实现了此接口。PrintService 可能仅支持取消某类打印数据和表示形式类名。这意味着只有 PrintService 返回的某些 DocPrintJob 对象才实现此接口。
如果使用此接口的实现成功地取消了某个作业，则鼓励服务实现程序实现此可选接口，并且向所有侦听器传递 javax.print.event.PrintJobEvent.JOB_CANCELLED 事件。服务还应注意，此方法的实现可能是通过单独的客户端线程完成的，而不是发出打印请求的线程完成的。因此，此接口的实现必须是线程安全的。
| 方法摘要 | |
|---|---|
void |
cancel()
停止对打印作业的进一步处理。 |
| 从接口 javax.print.DocPrintJob 继承的方法 |
|---|
addPrintJobAttributeListener, addPrintJobListener, getAttributes, getPrintService, print, removePrintJobAttributeListener, removePrintJobListener |
| 方法详细信息 |
|---|
cancel
void cancel()
throws PrintException
- 停止对打印作业的进一步处理。
即使某个服务支持此方法，也不能断定作业取消总是能够成功。一旦作业到达或经过其处理过程中的某个点，就无法再取消该作业了。成功的取消仅意味着未打印整个作业，但是在取消返回时可能已经打印完成部分作业。
如果取消不成功，则该服务抛出 PrintException。尚未提交进行打印的作业应该抛出此异常。对已经成功取消的打印作业再执行取消不视为错误，并且总是可以成功。
在某些服务中，取消可能是一个很长的过程，这涉及对服务器的请求和对其打印队列的处理。客户端可能希望在不影响应用程序执行的线程中执行取消。
- 抛出：
PrintException- 如果无法成功取消该作业。
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。