THPDFHeadlessDocument.SaveAnnotationRemovalsToFile method

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

Bereidt pagina-annotatieverwijderingen voor vanuit de huidige geladen bron en publiceert atomair een aparte PDF naar FileName

Identities selecteert annotaties op geldige zero-based pagina-indices en exacte decoded Unicode NM-waarden; Options levert positieve resourcelimieten en optionele gedeelde annulering

De returnwaarde telt elke verwijderde annotatie een keer, inclusief popup- en reply-afhankelijkheden; het aantal kan hoger liggen dan het aantal aangevraagde identiteiten

Een leeg verzoek of geldige niet-matchende identiteiten geven nul terug en publiceren de exacte huidige bronbytes; gedupliceerde identiteiten, ambigue geselecteerde namen en gedeelde annotation-owners falen

Het verwijderen van een owner verwijdert afhankelijke popups en replies transitief, met eindige cycle-afhandeling; alleen diens popup verwijderen wist de Popup-link van de behouden owner

Een geselecteerde of afhankelijke Widget raise-t hdFieldTypeUnsupported omdat field-tree-verwijdering een aparte transactie is

Status en publicatie

Het geladen document blijft na succes en falen ongewijzigd; laad de gepubliceerde PDF opnieuw om een gewijzigde revisie te adopteren

Een gewijzigde uitvoer is een incrementele revisie die het originele bestandsprefix behoudt; nul wijzigingen produceren een exacte kopie, en deze operatie wist oude revisies niet secure

Het uitvoerpad mag geen alias van de geladen bron zijn; allocatiefalen, ongeldige invoer, beleidsweigering, budgetuitputting en annulering behouden de bestaande destination

Beleid en diagnostiek

Echte wijzigingen vragen annotation-permission voor versleutelde documenten en geauthenticeerde signature-policy-toelating voor ondertekende documenten; certification P1/P2 verwerpen wijzigingen, terwijl toegelaten P3-wijzigingen de originele signed byte-ranges behouden

Ongeldige identiteiten en misvormd eigenaarschap rapporteren hdInvalidDocument; resource-uitputting rapporteert hdLimitExceeded; Widget-selectie rapporteert hdFieldTypeUnsupported

Security-, signature- en annuleringsfouten behouden diens bestaande native diagnostische contracten; configureer trust- en timestamp-eisen via de signature-policy-opties van het document

Zie THPDFHeadlessAnnotationIdentity, THPDFHeadlessAnnotationRemovalOptions en native annotatieverwijdering