AddAnnotationState

Anotácie a hotspot odkazy

Popis

Táto stránka popisuje AddAnnotationState v PDFlibPas v rámci témy "Anotácie a hotspot odkazy". Názvy API, parametre, názvy tried, názvy súborov a literály sú zachované presne tak, ako sa objavujú v knižnici Delphi a vstupných bodoch DLL.

AddAnnotationState zaznamenáva zmenu stavu kontroly pre existujúcu anotáciu na vybranej stránke (ISO 32000-1 §12.5.6.3). Pripojí skrytú anotáciu typu Text, ktorej položka /IRT odkazuje na cieľovú anotáciu a ktorej položky /State a /StateModel nesú stav kontroly, čo zodpovedá pracovnému postupu kontroly používanému na paneli komentárov aplikácie Acrobat.

Syntax

Delphi

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

Parametre

TargetAnnot je index anotácie na vybranej stránke s indexom od 1, ktorej stav sa nastavuje. Author je meno recenzenta uložené v položke /T. StateModel vyberá model stavu: 0 = Review, 1 = Marked. State vyberá stav v rámci modelu. Pre model Review: 0 = None, 1 = Accepted, 2 = Rejected, 3 = Cancelled, 4 = Completed. Pre model Marked: 0 = Unmarked, 1 = Marked.

Návratové hodnoty

Vracia index novopripojenej anotácie stavu s indexom od 1 v zozname anotácií na stránke, alebo 0, keď je volič stavu alebo modelu neznámy, keď TargetAnnot neexistuje, alebo keď cieľová anotácia nie je uložená ako nepriamy objekt.

Poznámky

Anotácia stavu je zapísaná s nastaveným príznakom Hidden, takže sa na stránke nevykreslí; prehliadače PDF s podporou kontroly ju namiesto toho zobrazia na paneli komentárov. Na spätné načítanie zaznamenaného stavu použite GetAnnotState a GetAnnotStateModel. Vyžaduje sa PDF 1.5; verzia dokumentu sa v prípade potreby automaticky zvýši.