Metodo THPDFHeadlessDocument.SaveAnnotationRemovalsToFile

function SaveAnnotationRemovalsToFile(const FileName: string;
  const Identities: array of THPDFHeadlessAnnotationIdentity;
  const Options: THPDFHeadlessAnnotationRemovalOptions): Integer;

Prepara le rimozioni di annotazioni di pagina dalla sorgente attualmente caricata e pubblica atomicamente un PDF separato in FileName

Identities seleziona le annotazioni per indici di pagina validi a base zero e valori NM Unicode decodificati esatti; Options fornisce limiti di risorse positivi e cancellazione condivisa opzionale

Il valore restituito conta ogni annotazione rimossa una volta, incluse le dipendenze di popup e risposte; può superare il numero di identità richieste

Una richiesta vuota o identità valide senza corrispondenza restituiscono zero e pubblicano i byte sorgente correnti esatti; identità duplicate, nomi selezionati ambigui e proprietari di annotazioni condivisi falliscono

Rimuovere un proprietario rimuove transitivamente i popup e le risposte dipendenti, con gestione finita dei cicli; rimuovere solo il suo popup azzera il collegamento Popup del proprietario conservato

Un Widget selezionato o dipendente solleva hdFieldTypeUnsupported perché la cancellazione dell'albero dei campi è una transazione separata

Stato e pubblicazione

Il documento caricato resta invariato sia dopo il successo sia dopo il fallimento; ricaricare il PDF pubblicato per adottare una revisione cambiata

Un output cambiato è una revisione incrementale che conserva il prefisso del file originale; zero cambiamenti produce una copia esatta, e questa operazione non cancella in sicurezza le revisioni precedenti

Il percorso di output non deve essere un alias della sorgente caricata; fallimento di allocazione, input non valido, rifiuto della politica, esaurimento del budget e cancellazione preservano la destinazione esistente

Politica e diagnostica

Le modifiche effettive richiedono il permesso di annotazione del documento cifrato e l'ammissione autenticata della politica dei documenti firmati; la certificazione P1/P2 rifiuta le modifiche, mentre le modifiche P3 ammesse conservano gli intervalli di byte firmati originali

Identità non valide e proprietà malformed riportano hdInvalidDocument; l'esaurimento delle risorse riporta hdLimitExceeded; la selezione di Widget riporta hdFieldTypeUnsupported

Gli errori di sicurezza, firma e cancellazione conservano i loro contratti diagnostici nativi esistenti; configurare i requisiti di trust e timestamp tramite le opzioni della politica delle firme del documento

Vedere THPDFHeadlessAnnotationIdentity, THPDFHeadlessAnnotationRemovalOptions e la rimozione nativa delle annotazioni