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 tem de ter sido construída com a fonte original real correspondente ao documento carregado e com a palavra-passe necessária para autenticar entrada cifrada

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

Depois da 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 o seu THPDFWindowsFormDataSource proprietário; destrua o documento antes da fonte dele

Falha ou cancelamento significa descartar a transação e reter o documento e a fonte 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 o estado pendente do documento carregado representado pela transação; não é necessariamente o ficheiro original no disco se o caller tinha alterações não guardadas

Limites e identidade

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

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

O método preserva verificações de capacidade positiva, permissões de anotações cifradas e admissão autenticada da política de assinatura; a palavra-passe não é um bypass de autorização

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