AddPolyLineAnnotation

Adnotări și legături hotspot

Descriere

Adaugă o adnotare markup de tip polilinie deschisă (PDF /Subtype /PolyLine) pe pagina selectată, cu lista de vârfuri furnizată. Polilinia este deschisă — reader-ele nu leagă ultimul vârf înapoi la primul — și poate purta stiluri diferite de capăt de linie la fiecare capăt terminal. Decorațiunile terminale care au interior (ClosedArrow, Square, Circle, Diamond) pot fi opțional umplute. Componentele de culoare și opacitatea sunt exprimate pe o scală 0–1; Transparency este dat pe o scală 0–100 (0 = complet opac, 100 = complet transparent). Biblioteca ridică versiunea documentului la PDF 1.5 când o adnotare PolyLine este emisă sub o blocare de versiune minimă mai mică. Definit în ISO 32000-1 §12.5.6.9

Sintaxă

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;

Parametri

VertexCoords — Coordonatele vârfurilor ca un singur șir de valori x/y alternante, separate prin spații, virgule, punct și virgulă sau tab-uri. Exemplu: "100 100 200 150 300 100" definește un V. Necesită cel puțin două perechi (patru numere) și un număr total par de numere, altfel apelul returnează 0

BorderWidth — lățimea conturului poliliniei ș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 primul și ultimul vârf, 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, dacă șirul de vârfuri nu poate fi parsat sau dacă adnotarea nu a putut fi creată

Observații

Adnotarea /Rect este calculată automat din întinderea vârfurilor 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

Câmpurile avansate opționale descrise de specificația PDF — /IT (intenție, inclusiv PolyLineDimension) ș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