AddAnnotationState

Anotace a odkazy na aktivní body

Popis

Tato stránka popisuje AddAnnotationState v PDFlibPas v rámci tématu "Anotace a odkazy na aktivní body". Názvy rozhraní API, parametry, názvy tříd, názvy souborů a literály jsou zachovány přesně tak, jak se objevují v knihovně Delphi a ve vstupních bodech DLL.

AddAnnotationState zaznamená změnu stavu revize u existující anotace na vybrané stránce (ISO 32000-1 §12.5.6.3). Připojí skrytou textovou anotaci, jejíž položka /IRT odkazuje na cílovou anotaci a jejíž položky /State a /StateModel nesou stav revize, což odpovídá pracovnímu postupu revize používanému panelem komentářů programu Acrobat.

Syntaxe

Delphi

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

Parametry

TargetAnnot je index (počítáno od 1) anotace na vybrané stránce, jejíž stav se nastavuje. Author je jméno recenzenta uložené v položce /T. StateModel vybírá model stavu: 0 = Review, 1 = Marked. State vybírá stav v rámci modelu. Pro model Review: 0 = None, 1 = Accepted, 2 = Rejected, 3 = Cancelled, 4 = Completed. Pro model Marked: 0 = Unmarked, 1 = Marked.

Návratové hodnoty

Vrací index (počítáno od 1) nově připojené stavové anotace v seznamu anotací stránky, nebo 0, pokud je volič stavu nebo modelu neznámý, pokud TargetAnnot neexistuje, nebo pokud cílová anotace není uložena jako nepřímý objekt.

Poznámky

Stavová anotace se zapisuje s nastaveným příznakem Hidden, takže se na stránce nevykresluje; prohlížeče PDF s podporou revizí ji místo toho zobrazují v panelu komentářů. Pomocí funkcí GetAnnotState a GetAnnotStateModel načtěte zaznamenaný stav zpět. Vyžaduje PDF 1.5; verze dokumentu se v případě potřeby automaticky zvýší.