AddLineAnnotation

Adnotări și legături hotspot

Descriere

Adaugă o adnotare markup de tip linie (PDF /Subtype /Line) între două capete pe pagina selectată. Fiecare capăt poate purta un stil diferit de capăt de linie (săgeată, pătrat, cerc, romb, …), iar corpul liniei poate fi desenat în orice culoare RGB cu opacitate configurabilă. Decorațiunile terminale care au interior (ClosedArrow, Square, Circle, Diamond) pot fi opțional umplute. Deoarece acest entry point emite cheia de opacitate a adnotării /CA din PDF 1.4, biblioteca ridică documentele mai mici neblocate la PDF 1.4 înainte de salvare; țintele mai mici blocate sunt respinse de poarta de compatibilitate. Definit în ISO 32000-1 §12.5.6.7

Sintaxă

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;

Parametri

StartLeft, StartTop — coordonatele capătului de start al liniei, în unitățile curente

EndLeft, EndTop — coordonatele capătului final al liniei, în unitățile curente

BorderWidth — lățimea conturului liniei și a decorațiunilor ei terminale, în unitățile curente

LineRed, LineGreen, LineBlue — componentele RGB (0–1) ale culorii liniei, scrise în /C

StartStyle, EndStyle — stilurile de capăt de linie pentru capetele de start și final, respectiv. Folosiți una dintre:

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

Valorile în afara intervalului sunt limitate la 0 (Niciunul)

Filled — 1 pentru a emite o culoare de umplere interioară (/IC) pentru decorațiunile terminale, 0 pentru a le lăsa neumplute

FillRed, FillGreen, FillBlue — componentele RGB (0–1) ale culorii de umplere interioare a decorațiunilor terminale. Ignorate când Filled este 0

Title — numele autorului scris în intrarea /T a adnotării. Treceți un șir gol pentru a omite

Contents — conținutul popup-ului asociat adnotării. Treceți un șir gol pentru a omite

Transparency — opacitate exprimată ca procent de transparență (0–100). Biblioteca îl convertește în PDF /CA = 1 - Transparency/100 și îl limitează la interval

Valoare returnată

1 în caz de succes, 0 dacă niciun document nu este selectat sau adnotarea nu a putut fi creată

Observații

Adnotarea /Rect este calculată automat din cele două capete plus un padding proporțional cu lățimea chenarului, astfel încât decorațiunile terminale rămân în interiorul bounding box-ului adnotării. Reader-ele PDF cer ca /Rect de încadrare să conțină întregul desen vizibil, altfel decorațiunile terminale pot fi tăiate

Câmpurile avansate opționale descrise de specificația PDF — /LL (lungimea liniei conductoare), /LLE, /LLO, /Cap, /CP, /CO și /Measure — nu sunt emise de acest entry point. Ele pot fi adăugate după creare scriindu-le direct în dicționarul adnotării

Pentru a suprascrie culoarea liniei, chenarul, conținutul sau dreptunghiul după creare, folosiți SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents și SetAnnotRect