THPDFHeadlessDocument.SaveAnnotationRemovalsToFile method

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

Forbereder sideannotationsfjernelser fra den aktuelt indlæste kilde og publicerer et separat PDF atomisk til FileName

Identities udvælger annotationer via gyldige nulbaserede sideindeks og eksakte dekodede Unicode-NM-værdier; Options leverer positive ressourcegrænser og valgfri delt cancellation

Returværdien tæller hver fjernet annotation én gang, inklusive popup- og svar-afhængigheder; den kan overstige antallet af anmodede identiteter

En tom anmodning eller umatchede gyldige identiteter returnerer nul og publicerer de eksakte aktuelle kildebytes; duplikerede identiteter, tvetydige valgte navne og delte annotations-ejere fejler

Fjernelse af en ejer fjerner afhængige popups og svar transaktivt med endelig cyklusshåndtering; fjernelse af kun dens popup rydder den bevarede ejers Popup-link

En valgt eller afhængig Widget udløser hdFieldTypeUnsupported, fordi field-tree-sletning er en separat transaktion

Tilstand og publicering

Det indlæste dokument forbliver uændret efter både succes og fejl; genindlæs det publicerede PDF for at adoptere en ændret revision

Et ændret output er en inkrementel revision, der bevarer filens originale prefix; nul ændringer giver en eksakt kopi, og denne operation sletter ikke sikkert gamle revisioner

Outputstien må ikke aliasere den indlæste kilde; allokeringsfejl, ugyldigt input, politikafvisning, budgettømning og cancellation bevarer den eksisterende destination

Politik og diagnostik

Faktiske ændringer kræver annotationstilladelse for krypteret dokument og autentificeret signeret dokumentpolitik-admission; certificering P1/P2 afviser ændringer, mens tilladte P3-ændringer bevarer de originale signerede byteintervaller

Ugyldige identiteter og misdannet ownership rapporterer hdInvalidDocument; ressourceudtømmelse rapporterer hdLimitExceeded; Widget-valg rapporterer hdFieldTypeUnsupported

Sikkerheds-, signatur- og cancellation-fejl bevarer deres eksisterende native diagnostikkontrakter; konfigurér trust- og tidsstempelkrav via dokumentets signaturpolitik-indstillinger

Se THPDFHeadlessAnnotationIdentity, THPDFHeadlessAnnotationRemovalOptions og native annotation-fjernelse