AddLineAnnotation

Merkinnät ja hotspot-linkit

Kuvaus

Lisää viivamarkkimerkinnän (PDF /Subtype /Line) kahden pisteen välille valitulle sivulle. Kummalla päällä voi olla erilainen päätteen tyyli (nuoli, neliö, ympyrä, vinoneliö, …), ja viivan runon voi piirtää millä tahansa RGB-värillä säädettävällä peittävyydellä. Sisäksen omaavat pääte (ClosedArrow, Square, Circle, Diamond) voi halutessaan täyttää. 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.7

Syntaksi

Delphi

Function TPDFlib.AddLineAnnotation(StartLeft, StartTop, EndLeft, EndTop: Double; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parametrit

StartLeft, StartTop — viivan alkupisteen koordinaatit nykyisessä yksikössä

EndLeft, EndTop — viivan loppupisteen koordinaatit nykyisessä yksikössä

BorderWidth — viivan ja sen päätteiden viivan leveys nykyisessä yksikössä

LineRed, LineGreen, LineBlue — viivan värin RGB-komponentit (0–1), kirjoitetaan /C-tietueeseen

StartStyle, EndStyle — alkupisteen ja loppupisteen päätetyylit. Käytä jotakin seuraavista:

0 = None, 1 = Square, 2 = Circle, 3 = Diamond, 4 = OpenArrow, 5 = ClosedArrow, 6 = Butt, 7 = ROpenArrow, 8 = RClosedArrow, 9 = Slash.

Alueen ulkopuoliset arvot rajataan arvoon 0 (None)

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

FillRed, FillGreen, FillBlue — päätekoristeiden 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

Merkinnän /Rect lasketaan automaattisesti kahdesta pisteestä plus reunuksen leveyteen suhteutettu täyte, jolloin päätteet pysyvät merkinnän rajaus­laatikon sisällä. PDF-katselimet edellyttävät, että rajaus­/Rect sisältää koko näkyvän piirroksen, muuten päätteet voivat katketa

Valinnaisia edistyneitä tietueita, joita PDF-määritys kuvaa — /LL (ohjaimen pituus), /LLE, /LLO, /Cap, /CP, /CO ja /Measure — ei tuoteta tässä pisteessä. Ne voi liittää luonnin jälkeen kirjoittamalla ne suoraan merkintäsanakirjaan

Luonnin jälkeen viivan värin, reunuksen, sisällön tai suorakulmion voi ylikirjoittaa funktioilla SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents ja SetAnnotRect