THPDFCancellationToken Class
Fornece um sinal de cancelamento de uso único seguro para threads que operações de longa duração do HotPDF observam em limites de trabalho estáveis
Declaração
THPDFCancellationToken = class(TObject)
public
procedure Cancel;
procedure ThrowIfCancellationRequested(
const OperationName: AnsiString = 'operation');
property IsCancellationRequested: Boolean read GetIsCancellationRequested;
end;
Unidade
HPDFTypes
Membros
| Nome | Finalidade |
|---|---|
Cancel | Solicita cancelamento de forma atômica e permanente |
IsCancellationRequested | Lê o estado de cancelamento com segurança de qualquer thread |
ThrowIfCancellationRequested | Gera EHPDFOperationCancelled com o nome de operação fornecido quando cancelado |
Notas de uso
- O chamador possui o token e deve mantê-lo vivo durante toda a operação ou sessão de renderização progressiva
- Um token não pode ser redefinido após
Cancel; crie uma nova instância para a próxima operação - O cancelamento é cooperativo, então o operador de conteúdo atual, a etapa de compactação ou a chamada de chave privada do sistema operacional pode terminar antes que a solicitação seja observada
EHPDFOperationCancelled.OperationNameidentifica a operação que observou a solicitação