Metoden THPDFHeadlessDocument.SaveAnnotationRemovalsToFile

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

Förbereder borttagning av sidannoteringar från den för närvarande inlästa källan och publicerar atomärt en separat PDF till FileName

Identities väljer annoteringar via giltiga nollbaserade sidindex och exakta avkodade Unicode-NM-värden; Options tillhandahåller positiva resursgränser och valfri delad avbrottsmöjlighet

Returvärdet räknar varje borttagen annotering en gång, inklusive popup- och svarsberoenden; det kan överstiga antalet begärda identiteter

En tom begäran eller giltiga omatchade identiteter returnerar noll och publicerar de exakta aktuella källbytena; duplicerade identiteter, tvetydiga valda namn och delade annoteringsägare misslyckas

Att ta bort en ägare tar bort beroende popups och svar transitivt, med ändlig cykelhantering; att bara ta bort dess popup rensar den behållna ägarens Popup-länk

En vald eller beroende Widget kastar hdFieldTypeUnsupported eftersom borttagning i fältträd är en separat transaktion

Tillstånd och publicering

Det inlästa dokumentet förblir oförändrat efter både framgång och misslyckande; läs in den publicerade PDF:en för att anta en ändrad revision

En ändrad utdata är en inkrementell revision som behåller det ursprungliga filprefixet; noll ändringar ger en exakt kopia, och denna operation raderar inte gamla revisioner på ett säkert sätt

Utdatasökvägen får inte aliasa den inlästa källan; allokeringsfel, ogiltig indata, policyavvisning, förbrukad budget och avbrott bevarar den befintliga destinationen

Policy och diagnostik

Faktiska ändringar kräver annoteringsbehörighet för krypterat dokument och autentiserat godkännande enligt signerad dokumentpolicy; certifiering P1/P2 avvisar ändringar, medan tillåtna P3-ändringar behåller de ursprungliga signerade byteintervallen

Ogiltiga identiteter och felformat ägarskap rapporterar hdInvalidDocument; förbrukade resurser rapporterar hdLimitExceeded; Widget-val rapporterar hdFieldTypeUnsupported

Säkerhets-, signatur- och avbrottsfel behåller sina befintliga nativa diagnostikkontrakt; konfigurera krav på förtroende och tidsstämplar via dokumentets alternativ för signaturpolicy

Se THPDFHeadlessAnnotationIdentity, THPDFHeadlessAnnotationRemovalOptions och borttagning av native-annoteringar