AddPolygonAnnotation

Adnotări și legături hotspot

Descriere

Adaugă o adnotare markup de tip poligon închis (PDF /Subtype /Polygon) pe pagina selectată, cu lista de vârfuri furnizată. Poligonul este implicit închis — reader-ele leagă ultimul vârf înapoi la primul la randare. Forma poate fi opțional umplută cu o culoare interioară uniformă. 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 Polygon este emisă sub o blocare de versiune minimă mai mică. Definit în ISO 32000-1 §12.5.6.9

Sintaxă

Delphi

Function TPDFlib.AddPolygonAnnotation(Const VertexCoords: WideString; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; 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 100 200 200 100 200" definește un pătrat. Necesită cel puțin două perechi (patru numere) și un număr total par de numere, altfel apelul returnează 0

BorderWidth — lățimea conturului poligonului, în unitățile curente

BorderRed, BorderGreen, BorderBlue — componentele RGB (0–1) ale culorii de contur, scrise în /C

Filled — 1 pentru a emite o culoare de umplere interioară (/IC) pentru corpul poligonului, 0 pentru a-l lăsa neumplut

FillRed, FillGreen, FillBlue — componentele RGB (0–1) ale culorii de umplere interioare. 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 mic proporțional cu lățimea chenarului, astfel încât trasarea conturului rămâne în interiorul bounding box-ului adnotării

Câmpurile avansate opționale descrise de specificația PDF — /BE (efect de chenar, inclusiv stilul de contur înnorat), /IT (intenție, inclusiv PolygonCloud și PolygonDimension) ș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 conturului, chenarul, conținutul sau dreptunghiul după creare, folosiți SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents și SetAnnotRect