Класс THPDFCancellationToken
Потокобезопасный одноразовый сигнал отмены, который длительные операции HotPDF проверяют в стабильных точках выполнения работы
Объявление
THPDFCancellationToken = class(TObject)
public
procedure Cancel;
procedure ThrowIfCancellationRequested(
const OperationName: AnsiString = 'operation');
property IsCancellationRequested: Boolean read GetIsCancellationRequested;
end;
Модуль
HPDFTypes
Члены
| Имя | Назначение |
|---|---|
Cancel | Атомарно и необратимо запрашивает отмену |
IsCancellationRequested | Потокобезопасно читает состояние отмены из любого потока |
ThrowIfCancellationRequested | При отмене выбрасывает EHPDFOperationCancelled с переданным именем операции |
Примечания по использованию
- Token принадлежит вызывающему коду, и он обязан держать его живым на протяжении всей операции или progressive render session
- После
Canceltoken нельзя сбросить; для следующей операции создайте новый экземпляр - Отмена cooperative: текущий content operator, шаг сжатия или обращение к приватному ключу средствами ОС могут завершиться до того, как запрос будет замечен
EHPDFOperationCancelled.OperationNameуказывает операцию, в которой запрос отмены был замечен