Método THPDFWindowsFormDataTransaction.RemoveAnnotations

procedure RemoveAnnotations(
  const Identities: array of THPDFHeadlessAnnotationIdentity;
  const Options: THPDFHeadlessAnnotationRemovalOptions;
  const Password: AnsiString);

Prepara um candidate de remoção através do engine nativo autenticado sem mutar o documento THotPDF emprestado da transação

A transação precisa ter sido construída com a origem original real correspondente ao documento carregado e com a senha necessária para autenticar entrada criptografada

ChangedAnnotations reporta o número removido, incluindo dependências em cascata; o contador usa o armazenamento existente de mudanças preparadas da transação

Após a preparação, WritePreparedPDF copia o candidate delimitado para um stream de destino; chame TakeCandidate só depois de todas as publicações exigidas de PDF e resultado terem sucesso

TakeCandidate transfere o novo THotPDF e seu THPDFWindowsFormDataSource proprietário; destrua o documento antes da origem dele

Falha ou cancelamento significa descartar a transação e reter o documento e a origem emprestados; uma transação que já tem um candidate preparado rejeita outra preparação

Com zero remoções a saída é a revisão preparada atual exata, incluindo estado pendente do documento carregado representado pela transação; não é necessariamente o arquivo original no disco se o caller tinha mudanças não salvas

Limites e identidade

Seleção por página e nome, cascatas de dependências, checks de ambiguidade e a fronteira de Widgets seguem remoção nativa de anotações

Um token de cancelamento fornecido explicitamente precisa ser o token da transação; a transação limita MaxWorkingBytes à metade da sua capacidade de trabalho e MaxAnnotations à sua capacidade de objetos

O método preserva checks de capacidade positiva, permissões de anotações criptografadas e admissão autenticada da política de assinatura; a senha não é um bypass de autorização

Veja remoção Windows comum e THPDFWindowsFormDataTransaction para detalhes de posse e ciclo de vida