AddPolygonAnnotation

Anotácie a aktívne odkazy

Opis

Pridá uzavretú polygonálnu značkovaciu anotáciu (PDF /Subtype /Polygon) na vybranú stránku so zadaným zoznamom vrcholov. Polygon sa implicitne uzatvára — čítačky pri vykresľovaní spoja posledný vrchol s prvým. Tvar možno voliteľne vyplniť plnou vnútornou farbou. Zložky farieb a priehľadnosť sa vyjadrujú na škále 0–1; Transparency sa udáva na škále 0–100 (0 = úplne nepriehľadné, 100 = úplne priehľadné). Knižnica zvýši verziu dokumentu na PDF 1.5, keď sa anotácia Polygon vydá pri nižšom uzamknutí minimálnej verzie. Definované v ISO 32000-1 §12.5.6.9

Syntax

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;

Parametre

VertexCoords — Súradnice vrcholov ako jeden reťazec striedajúcich sa hodnôt x/y oddelených medzerami, čiarkami, bodkočiarkami alebo tabulátormi. Príklad: "100 100 200 100 200 200 100 200" definuje štvorec. Vyžaduje aspoň dva páry (štyri čísla) a párny celkový počet čísel, inak volanie vráti 0

BorderWidth — Šírka ťahu obrysu polygonu v aktuálnych jednotkách

BorderRed, BorderGreen, BorderBlue — Zložky RGB (0–1) farby obrysu, zapísané do /C

Filled — 1 na emitovanie vnútornej farby výplne (/IC) pre telo polygonu, 0 na ponechanie bez výplne

FillRed, FillGreen, FillBlue — Zložky RGB (0–1) vnútornej farby výplne. Ignorované, keď Filled je 0

Title — Meno autora zapísané do položky /T anotácie. Ak chcete preskočiť, odovzdajte prázdny reťazec

Contents — Telo vyskakovacieho okna priradeného k anotácii. Ak chcete preskočiť, odovzdajte prázdny reťazec

Transparency — Nepriehľadnosť vyjadrená ako percento priehľadnosti (0–100). Knižnica to prevedie na PDF /CA = 1 - Transparency/100 a ohraničí na rozsah

Návratová hodnota

1 pri úspechu, 0 ak nie je vybraný žiadny dokument, reťazec vrcholov sa nedá analyzovať alebo anotáciu nebolo možné vytvoriť

Poznámky

Anotácia /Rect sa vypočíta automaticky z rozsahu vrcholov spolu s malým odsadením úmerným šírke obrysu, aby ťah obrysu zostal vo vnútri ohraničujúceho boxu anotácie

Voliteľné pokročilé polia popísané v špecifikácii PDF — /BE (efekt okraja vrátane štýlu oblačného obrysu), /IT (zámer, vrátane PolygonCloud a PolygonDimension), a /Measure — tento vstupný bod neemitujú. Po vytvorení ich možno pridať priamym zápisom do slovníka anotácie

Na prepísanie farby obrysu, okraja, obsahu alebo obdĺžnika po vytvorení použite SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents a SetAnnotRect