THPDFCancellationToken Class
提供執行緒安全的一次性取消訊號,長時間執行的 HotPDF 操作會在穩定的工作邊界檢查它
宣告
THPDFCancellationToken = class(TObject)
public
procedure Cancel;
procedure ThrowIfCancellationRequested(
const OperationName: AnsiString = 'operation');
property IsCancellationRequested: Boolean read GetIsCancellationRequested;
end;
單元
HPDFTypes
成員
| 名稱 | 用途 |
|---|---|
Cancel | 以原子且永久的方式請求取消 |
IsCancellationRequested | 從任何執行緒安全地讀取取消狀態 |
ThrowIfCancellationRequested | 取消時以傳入的操作名稱引發 EHPDFOperationCancelled |
使用說明
- 權杖由呼叫端擁有,在整個操作或漸進式轉譯 session 期間都必須保持有效
- 權杖在
Cancel之後無法重設;下一次操作請建立新的實體 - 取消是合作式的,當前的內容運算子、壓縮步驟或作業系統私密金鑰呼叫可能會跑完才回應取消請求
EHPDFOperationCancelled.OperationName會指出是哪個操作觀察到取消請求