AddAnnotationState

Annotationer og hotspot-links

Beskrivelse

Denne side beskriver AddAnnotationState i PDFlibPas under emnet "Annotationer og hotspot-links". API-navne, parametre, klassenavne, filnavne og strenge (literals) bevares nøjagtigt som de fremstår i Delphi-biblioteket og DLL-indgangspunkterne.

AddAnnotationState registrerer en statusændring for en gennemgang af en eksisterende annotation på den valgte side (ISO 32000-1 §12.5.6.3). Den tilføjer en skjult Text-annotation, hvis /IRT-indgang refererer til mål-annotationen, og hvis /State og /StateModel indgange bærer gennemgangsstatussen, hvilket matcher den gennemgangs-workflow, der bruges af Acrobats kommentar-panel.

Syntaks

Delphi

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

Parametre

TargetAnnot er det 1-baserede indeks for annotationen på den valgte side, hvis status angives. Author er anmelderens navn gemt i /T-indgangen. StateModel vælger tilstandsmodellen: 0 = Review, 1 = Marked. State vælger tilstanden inden for modellen. For Review-modellen: 0 = None, 1 = Accepted, 2 = Rejected, 3 = Cancelled, 4 = Completed. For Marked-modellen: 0 = Unmarked, 1 = Marked.

Returværdier

Returnerer det 1-baserede indeks for den nyligt tilføjede tilstands-annotation i sidens annotationsliste, eller 0 når tilstanden eller modelvælgeren er ukendt, når TargetAnnot ikke findes, eller når målannotationen ikke er gemt som et indirekte objekt.

Bemærkninger

Tilstands-annotationen er skrevet med Hidden-flaget sat, så den ikke renderes på siden; PDF-læsere med gennemgangs-support viser den i stedet i kommentar-panelet. Brug GetAnnotState og GetAnnotStateModel til at læse den registrerede status tilbage. Kræver PDF 1.5; dokumentets version hæves automatisk, når det er nødvendigt.