THPDFHeadlessDocument.SaveAnnotationRemovalsToFile-Methode

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

Bereitet Seitenannotation-Entfernungen aus der aktuell geladenen Quelle vor und veröffentlicht atomar ein separates PDF nach FileName

Identities wählt Annotationen über gültige nullbasierte Seitenindizes und exakte dekodierte Unicode-NM-Werte; Options liefert positive Ressourcengrenzen und optionalen gemeinsamen Abbruch

Der Rückgabewert zählt jede entfernte Annotation einmal, einschließlich Popup- und Antwort-Abhängigkeiten; er kann die Anzahl der angeforderten Identitäten überschreiten

Eine leere Anfrage oder gültige unübertroffene Identitäten geben null zurück und veröffentlichen die exakten aktuellen Quellbytes; doppelte Identitäten, mehrdeutige gewählte Namen und geteilte Annotation-Besitzer scheitern

Das Entfernen eines Besitzers entfernt abhängige Popups und Antworten transitiv, mit endlicher Zyklusbehandlung; das Entfernen nur seines Popups leert den Popup-Link des erhaltenen Besitzers

Ein gewähltes oder abhängiges Widget löst hdFieldTypeUnsupported aus, weil Feldbaum-Löschung eine separate Transaktion ist

Zustand und Veröffentlichung

Das geladene Dokument bleibt nach Erfolg wie Fehlschlag unverändert; laden Sie das veröffentlichte PDF neu, um eine geänderte Revision zu übernehmen

Eine geänderte Ausgabe ist eine inkrementelle Revision, die den ursprünglichen Dateipräfix bewahrt; null Änderungen erzeugen eine exakte Kopie, und diese Operation löscht alte Revisionen nicht sicher

Der Ausgabepfad darf nicht mit der geladenen Quelle aliasiert sein; Allokationsfehler, ungültige Eingabe, Policy-Ablehnung, Budgeterschöpfung und Abbruch bewahren das vorhandene Ziel

Policy und Diagnose

Tatsächliche Änderungen erfordern die Annotation-Berechtigung des verschlüsselten Dokuments und authentifizierte signierte Dokument-Policy-Zulassung; Zertifizierung P1/P2 weist Änderungen zurück, während zugelassene P3-Änderungen die originalen signierten Bytebereiche bewahren

Ungültige Identitäten und fehlerhafte Eigentümerschaft melden hdInvalidDocument; Ressourcenerschöpfung meldet hdLimitExceeded; Widget-Auswahl meldet hdFieldTypeUnsupported

Sicherheits-, Signatur- und Abbruchfehler behalten ihre vorhandenen nativen Diagnoseverträge; konfigurieren Sie Trust- und Zeitstempelanforderungen über die Signatur-Policy-Optionen des Dokuments

Siehe THPDFHeadlessAnnotationIdentity, THPDFHeadlessAnnotationRemovalOptions und native Annotation-Entfernung