AddPolyLineAnnotation

Anotacijos ir aktyviosios srities nuorodos

Aprašymas

Prideda pasirinktame puslapyje atvirą daugiakampės linijos žymėjimo anotaciją (PDF /Subtype /PolyLine) su pateiktu viršūnių sąrašu. Daugiakampė linija yra atvira — atvaizduodami skaitytuvai nesujungia paskutinės viršūnės su pirmąja — ir kiekviename galiniame taške gali turėti skirtingą linijos galo stilių. Galo dekoracijas, turinčias vidinę sritį (ClosedArrow, Square, Circle, Diamond), galima pasirinktinai užpildyti. Spalvų komponentai ir nepermatomumas nurodomi 0–1 skalėje; Transparency nurodomas 0–100 skalėje (0 = visiškai nepermatoma, 100 = visiškai skaidri). Kai dokumentui nustatyta mažesnė minimali versija ir išvedama PolyLine anotacija, biblioteka padidina dokumento versiją iki PDF 1.5. Apibrėžta ISO 32000-1 §12.5.6.9

Sintaksė

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;

Parametrai

VertexCoords — viršūnių koordinatės kaip viena eilutė su pakaitomis pateikiamomis x/y reikšmėmis, atskirtomis tarpais, kableliais, kabliataškiais arba tabuliacijos simboliais. Pavyzdžiui, "100 100 200 150 300 100" apibrėžia V formą. Reikalingos bent dvi poros (keturi skaičiai) ir lyginis bendras skaičių kiekis, priešingu atveju iškvietimas grąžina 0

BorderWidth — daugiakampės linijos ir jos galo dekoracijų kontūro linijos storis dabartiniais vienetais

LineRed, LineGreen, LineBlue — RGB komponentai (0–1) linijos spalvai, įrašomi į /C.

StartStyle, EndStyle — pirmosios ir paskutinės viršūnės linijos galo stiliai. Naudokite vieną iš:

Galimos reikšmės: 0 = None, 1 = Square, 2 = Circle, 3 = Diamond, 4 = OpenArrow, 5 = ClosedArrow, 6 = Butt, 7 = ROpenArrow, 8 = RClosedArrow, 9 = Slash

Už intervalo ribų esančios reikšmės nukerpamos iki 0 (None).

Filled — 1, kad galinėms dekoracijoms būtų išvedama vidinė užpildo spalva (/IC), 0, kad jos liktų neužpildytos.

FillRed, FillGreen, FillBlue — RGB komponentai (0–1) galinių dekoracijų vidinei užpildo spalvai. Ignoruojama, kai Filled yra 0.

Title — Autoriaus vardas, įrašomas į annotation's /T įrašą. Perduokite tuščią eilutę, kad praleistumėte

Contents — Su anotacija susieto iškylančiojo lango turinys. Perduokite tuščią eilutę, kad praleistumėte

Transparency — Nepermatomumas, išreikštas procentais kaip skaidrumas (0–100). Biblioteka paverčia jį į PDF /CA = 1 - Transparency/100 ir apriboja iki intervalo

Grąžinama reikšmė

1 sėkmės atveju, 0, jei nepasirinktas dokumentas, nepavyksta išanalizuoti viršūnių eilutės arba nepavyksta sukurti anotacijos

Pastabos

Anotacijos /Rect automatiškai apskaičiuojamas pagal viršūnių aprėptį ir kontūro pločiui proporcingą užlaidą, kad galo dekoracijos liktų anotacijos ribojančiojo langelio viduje

PDF specifikacijoje aprašyti papildomi išplėstiniai laukai — /IT (paskirtis, įskaitant PolyLineDimension) ir /Measure — šiuo įėjimo tašku nesukuriami. Sukūrus anotaciją juos galima pridėti tiesiogiai įrašant į anotacijos žodyną

Norėdami po sukūrimo perrašyti linijos spalvą, rėmelį, turinį ar stačiakampį, naudokite SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents ir SetAnnotRect.