AddLineAnnotation

Anotacijos ir interaktyvios nuorodos

Aprašas

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 — Coordinates of the line's start endpoint, in current units.

EndLeft, EndTop — Coordinates of the line's end endpoint, in current units.

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ų:

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 — Author name written into the annotation's /T entry. Pass an empty string to skip.

Contents — Su anotacija susieto iššokančio lango turinys. Palikite tuščią eilutę, jei norite praleisti.

Transparency — Skaidrumo procentas (0–100). Biblioteka tai paverčia į PDF /CA = 1 - Transparency/100 ir apriboja iki intervalo.

Grąžinamos reikšmės

1 sėkmės atveju, 0 jei nepasirinktas dokumentas arba anotacijos nepavyko sukurti.

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.