AddPolyLineAnnotation
Merkinnät ja hotspot-linkit
Kuvaus
Lisää avoimen monijanan markkimerkinnän (PDF /Subtype /PolyLine) valitulle sivulle annetulla kärkiluettelolla. Monijana on avoin — katselimet eivät yhdistä viimeistä kärkeä ensimmäiseen — ja sen molemmissa päätepisteissä voi olla erilaiset päätetyylit. Sisäksen omaavat päätteet (ClosedArrow, Square, Circle, Diamond) voi halutessaan täyttää. 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ä). Kirjasto korottaa asiakirjan version PDF 1.5:een, kun PolyLine-merkintä tuotetaan alemman vähimmäisversion lukon alla. Määritelty standardissa ISO 32000-1 §12.5.6.9
Syntaksi
Delphi
Function TPDFlib.AddPolyLineAnnotation(Const VertexCoords: WideString; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;Parametrit
VertexCoords — kärkikoordinaatit yhtenä merkkijonona vuorottelevia x/y-arvoja, jotka erotellaan välilyönneillä, pilkuilla, puolipisteillä tai sarkaimilla. Esimerkki: "100 100 200 150 300 100" määrittää V-muodon. Vaatii vähintään kaksi paria (neljä lukua) ja parillisen kokonaismäärän lukuja, muuten kutsu palauttaa arvon 0
BorderWidth — monijanan ja sen päätteiden viivan leveys nykyisessä yksikössä
LineRed, LineGreen, LineBlue — viivan värin RGB-komponentit (0–1), kirjoitetaan /C-tietueeseen
StartStyle, EndStyle — ensimmäisen ja viimeisen kärjen 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, kärkimerkkijonoa ei voi jäsentää tai merkinnän luonti epäonnistui
Huomautukset
Merkinnän /Rect lasketaan automaattisesti kärkien laajuudesta plus reunuksen leveyteen suhteutettu täyte, jolloin päätteet pysyvät merkinnän rajauslaatikon sisällä
Valinnaisia edistyneitä tietueita, joita PDF-määritys kuvaa — /IT (tarkoitus, mukaan lukien PolyLineDimension) 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