AddCircleAnnotation

Merkinnät ja hotspot-linkit

Kuvaus

Lisää ellipsimarkkimerkinnän (PDF /Subtype /Circle), joka on piirretty annettuun suorakulmioon. Nimestään huolimatta merkintä on täysi ellipsi ja näkyy varsinaisena ympyränä vain, kun Width on yhtä suuri kuin Height. Merkinnän voi halutessaan täyttää tasaisella sisäisellä värillä. Värikomponentit ja peittävyys ilmoitetaan skaalalla 0–1; Transparency ilmoitetaan skaalalla 0–100 (0 = täysin peittävä, 100 = täysin läpinäkyvä). Koska tämä piste tuottaa PDF 1.4:n merkintäavaimen /CA, kirjasto korottaa vanhemmat lukitsemattomat asiakirjat PDF 1.4:ään ennen tallennusta; lukitut alemmat kohteet hylätään yhteensopivuusportissa. Määritelty standardissa ISO 32000-1 §12.5.6.8

Syntaksi

Delphi

Function TPDFlib.AddCircleAnnotation(Left, Top, Width, Height: Double; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parametrit

Left — rajaus­suorakulmion vasemman alakulman vaakakoordinaatti nykyisessä yksikössä

Top — rajaus­suorakulmion vasemman alakulman pystykoordinaatti nykyisessä yksikössä

Width — rajaus­suorakulmion leveys

Height — rajaus­suorakulmion korkeus

BorderWidth — ellipsin reunuksen viivan leveys nykyisessä yksikössä. Kirjoitetaan sekä vanhaan /Border-kenttään että /BS-reunustyyli­sanakirjaan

BorderRed, BorderGreen, BorderBlue — viivan värin RGB-komponentit (0–1), kirjoitetaan /C-tietueeseen

Filled — 1 tuottaa sisäisen täyttövärin (/IC), 0 jättää ellipsin täyttämättä

FillRed, FillGreen, FillBlue — sisäisen täyttövärin RGB-komponentit (0–1). Ohitetaan, kun Filled on 0

Title — merkinnän /T-tietueeseen kirjoitettava tekijän nimi. Ohita antamalla tyhjä merkkijono

Contents — merkintään liittyvän ponnahduksen sisältö. Ohita antamalla tyhjä merkkijono

Transparency — läpinäkyvyys prosentteina (0–100). Kirjasto muuntaa arvon muotoon PDF /CA = 1 - Transparency/100 ja rajaa sen sallitulle alueelle

Paluuarvo

1 onnistuessaan, 0 jos asiakirjaa ei ole valittuna tai merkinnän luonti epäonnistui

Huomautukset

Merkintä tuotetaan vakiomarkkikenttien joukolla: /Type /Annot, /Subtype /Circle, /Rect, /C, /IC (kun Filled), /BS, /Border, /CA, /F = 4 (tulostettava), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Ellipse", /P. Tämä vastaa sitä, mitä Adobe Acrobat ja Foxit tuottavat ellipsitarkistustyökaluissaan, joten ulkoiset tarkistustyönkulut voivat paikallistaa, muokata, kommentoida ja vastata syntyvään merkintään

Rajaus­suorakulmion, värin, sisällön tai reunuksen ylikirjoittamiseen luonnin jälkeen käytä funktioita SetAnnotRect, SetAnnotBorderColor, SetAnnotContents ja SetAnnotBorderStyle