Metoda THPDFHeadlessDocument.SaveAnnotationRemovalsToFile

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

Připraví odebrání anotací stránek z aktuálně načteného zdroje a atomicky publikuje samostatné PDF do FileName

Identities vybírá anotace podle platných indexů stránek od nuly a exaktních dekódovaných Unicode hodnot NM; Options dodává kladné limity zdrojů a volitelné sdílené zrušení

Návratová hodnota počítá každou odebranou anotaci jednou, včetně závislostí popup a replies; může překročit počet požadovaných identit

Prázdný požadavek či neodpovídající platné identity vrátí nulu a publikují exaktní aktuální bajty zdroje; duplicitní identity, dvojsmyslné vybrané názvy a sdílení vlastníci anotací selžou

Odebrání vlastníka rekurzivně odebere závislé popupy a replies, s konečnou obsluhou cyklů; odebrání jen popupu vymaže odkaz Popup zachovaného vlastníka

Vybraný či závislý Widget vyvolá hdFieldTypeUnsupported, protože mazání stromu polí je samostatná transakce

Stav a publikace

Načtený dokument zůstává beze změny po úspěchu i selhání; změněnou revizi osvojíte načtením publikovaného PDF

Změněný výstup je inkrementální revize zachovávající původní prefix souboru; nulové změny produkují exaktní kopii a tato operace bezpečně nemaže staré revize

Výstupní cesta nesmí být aliasem načteného zdroje; selhání alokace, neplatný vstup, odmítnutí politiky, vyčerpání rozpočtu i zrušení zachovávají existující cíl

Politika a diagnostika

Skutečné změny vyžadují oprávnění anotací šifrovaného dokumentu a autentizovanou admisi politiky podepsaného dokumentu; certifikace P1/P2 změny odmítá, zatímco povolené P3 změny zachovávají původní podepsané rozsahy bajtů

Neplatné identity a poškozené vlastnictví hlásí hdInvalidDocument; vyčerpání zdrojů hlásí hdLimitExceeded; výběr Widgetu hlásí hdFieldTypeUnsupported

Selhání zabezpečení, podpisu a zrušení si zachovávají své stávající nativní diagnostické kontrakty; požadavky důvěry a časových razítek konfigurujte přes volby certifikační politiky dokumentu

Viz THPDFHeadlessAnnotationIdentity, THPDFHeadlessAnnotationRemovalOptions a nativní odebrání anotací