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 - 如果無法成功取消該作業。