AddAnnotationState

Anmerkungen und Hotspot-Links

Beschreibung

Diese Seite beschreibt AddAnnotationState in PDFlibPas unter dem Thema "Anmerkungen und Hotspot-Links". API-Namen, Parameter, Klassennamen, Dateinamen und Literale werden exakt so beibehalten, wie sie in der Delphi-Bibliothek und den DLL-Einstiegspunkten erscheinen.

AddAnnotationState zeichnet eine Überprüfungsstatusänderung für eine vorhandene Anmerkung auf der ausgewählten Seite auf (ISO 32000-1 §12.5.6.3). Es hängt eine versteckte Textanmerkung an, deren /IRT-Eintrag auf die Zielanmerkung verweist und deren /State- und /StateModel-Einträge den Überprüfungsstatus tragen, passend zum Überprüfungsworkflow, der vom Acrobat-Kommentarbereich verwendet wird.

Syntax

Delphi

Function TPDFlib.AddAnnotationState(TargetAnnot: Integer; Const Author: WideString; State, StateModel: Integer): Integer;

Parameter

TargetAnnot ist der 1-basierte Index der Anmerkung auf der ausgewählten Seite, deren Status festgelegt wird. Author ist der im /T-Eintrag gespeicherte Name des Prüfers. StateModel wählt das Statusmodell: 0 = Review, 1 = Marked. State wählt den Status innerhalb des Modells. Für das Review-Modell: 0 = None, 1 = Accepted, 2 = Rejected, 3 = Cancelled, 4 = Completed. Für das Marked-Modell: 0 = Unmarked, 1 = Marked.

Rückgabewerte

Gibt den 1-basierten Index der neu angehängten Status-Anmerkung in der Anmerkungsliste der Seite zurück, oder 0, wenn der Status- oder Modellauswähler unbekannt ist, wenn TargetAnnot nicht existiert oder wenn die Zielanmerkung nicht als indirektes Objekt gespeichert ist

Hinweise

Die Statusanmerkung wird mit gesetztem Hidden-Flag geschrieben, sodass sie nicht auf der Seite gerendert wird; PDF-Viewer mit Überprüfungsunterstützung zeigen sie stattdessen im Kommentarbereich an. Verwenden Sie GetAnnotState und GetAnnotStateModel, um den aufgezeichneten Status zurückzulesen. Erfordert PDF 1.5; die Dokumentversion wird bei Bedarf automatisch angehoben.