AddLineAnnotation

Anotacijos ir aktyviosios srities nuorodos

Aprašymas

Prideda linijos žymėjimo anotaciją (PDF /Subtype /Line) tarp dviejų galinių taškų pasirinktoje puslapio vietoje. Kiekvienas galas gali turėti skirtingą galinės linijos stilių (arrow, square, circle, diamond, …), o pačios linijos korpusas gali būti braižomas bet kuria RGB spalva su konfigūruojamu neskaidrumu. Galinės dekoracijos, kurių vidus yra uždaras (ClosedArrow, Square, Circle, Diamond), gali būti pasirenkamai užpildytos. Kadangi šis įėjimo taškas išveda PDF 1.4 anotacijos /CA neskaidrumo raktą, biblioteka prieš išsaugodama pakelia žemesnės versijos neužrakintus dokumentus iki PDF 1.4; užrakinti žemesni tikslai atmetami suderinamumo tikrintuve. Apibrėžta ISO 32000-1 §12.5.6.7.

Sintaksė

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;

Parametrai

StartLeft, StartTop — Linijos pradžios galinio taško (line's start endpoint) koordinatės dabartiniais vienetais

EndLeft, EndTop — Linijos galinio taško (line's end endpoint) koordinatės dabartiniais vienetais

BorderWidth — Linijos ir jos galinių dekoracijų storis, dabartiniais vienetais.

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

StartStyle, EndStyle — Pradžios ir pabaigos galinių taškų galinės linijos stiliai atitinkamai. Naudokite vieną iš š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ė

Sėkmės atveju 1, o jei nepasirinktas dokumentas arba nepavyko sukurti anotacijos – 0

Pastabos

Anotacijos /Rect automatiškai apskaičiuojamas iš dviejų galinių taškų kartu su paminkštinimu, proporcingu rėmelio pločiui, kad galinės dekoracijos liktų anotacijos ribojančiame stačiakampyje. PDF skaitytuvai reikalauja, kad ribojantis /Rect apimtų visą matomą piešinį, kitaip galinės dekoracijos gali būti apkarpytos.

PDF specifikacijoje aprašyti pasirenkami išplėstiniai laukai — /LL (leader length), /LLE, /LLO, /Cap, /CP, /CO ir /Measure — šiuo įėjimo tašku neišvedami. Juos galima pridėti po sukūrimo 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.