AddAnnotationState

Annotaatiot ja linkit

Kuvaus

Tämä sivu kuvaa PDFlibPas-kirjaston AddAnnotationState-toimintoa "Annotaatiot ja linkit" -aihealueella. API-nimet, parametrit, luokkien nimet, tiedostonimet ja vakiot pidetään täsmälleen sellaisina kuin ne esiintyvät Delphi-kirjastossa ja DLL-aloituspisteissä.

AddAnnotationState tallentaa tarkistustilan muutoksen olemassa olevalle annotaatiolle valitulla sivulla (ISO 32000-1 §12.5.6.3). Se lisää piilotetun Text-annotaation, jonka /IRT-merkintä viittaa kohdeannotaatioon ja jonka /State- sekä /StateModel-merkinnät sisältävät tarkistustilan vastaten Acrobatin kommenttipaneelin käyttämää tarkistuksen työnkulkua.

Syntaksi

Delphi

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

Parametrit

TargetAnnot on sen valitulla sivulla olevan annotaation 1-pohjainen indeksi, jonka tilaa asetetaan. Author on /T-kenttään tallennettu tarkistajan nimi. StateModel valitsee tilamallin: 0 = Review, 1 = Marked. State valitsee tilan mallin sisällä. Review-mallille: 0 = None, 1 = Accepted, 2 = Rejected, 3 = Cancelled, 4 = Completed. Marked-mallille: 0 = Unmarked, 1 = Marked.

Paluuarvot

Palauttaa juuri lisätyn tila-annotaation 1-pohjaisen indeksin sivun annotaatioluettelossa, tai 0, kun tila- tai mallivalitsin on tuntematon, TargetAnnot-kohdetta ei ole olemassa, tai kun kohdeannotaatiota ei ole tallennettu epäsuorana objektina.

Huomautuksia

Tila-annotaatio kirjoitetaan Hidden-lipun ollessa asetettuna, joten se ei piirry sivulle; sen sijaan tarkistusta tukevat PDF-katseluohjelmat näyttävät sen kommenttipaneelissa. Käytä funktioita GetAnnotState ja GetAnnotStateModel tallennetun tilan lukemiseen. Vaatii PDF 1.5 -version; asiakirjan versiota nostetaan tarvittaessa automaattisesti.