AddPolyLineAnnotation

Anotácie a odkazy na hotspoty

Opis

Pridá otvorenú značkovaciu anotáciu lomenou čiarou (PDF /Subtype /PolyLine) na vybranú stranu so zadaným zoznamom vrcholov. Lomená čiara je otvorená — čitatelia nespájajú posledný vrchol späť s prvým — a môže mať pri každom koncovom bode odlišný štýl koncovej čiary. Koncové ozdoby, ktoré majú vnútro (ClosedArrow, Square, Circle, Diamond), možno voliteľne vyplniť. Zložky farby a priehľadnosť sa vyjadrujú na stupnici 0–1; Transparency sa uvádza na stupnici 0–100 (0 = úplne nepriehľadné, 100 = úplne priehľadné). Knižnica zvýši verziu dokumentu na PDF 1.5, keď sa anotácia PolyLine vygeneruje pri nižšom uzamknutom minimálnom type verzie. Definované v ISO 32000-1 §12.5.6.9.

Syntax

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;

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 150 300 100" definuje tvar V. Vyžaduje sa aspoň dvojica párov (štyri čísla) a párny celkový počet čísel, inak volanie vráti 0.

BorderWidth — Šírka ťahu lomenice a jej koncových ozdôb v aktuálnych jednotkách.

LineRed, LineGreen, LineBlue — Zložky RGB (0–1) farby čiary, zapísané do /C.

StartStyle, EndStyle — Štýly koncovej čiary pre prvý a posledný vrchol. Použite jeden z:

0 = Žiadny, 1 = Štvorec, 2 = Kruh, 3 = Diamant, 4 = Otvorená šípka, 5 = Uzavretá šípka, 6 = Tupý koniec, 7 = Pravá otvorená šípka, 8 = Pravá uzavretá šípka, 9 = Lomka.

Hodnoty mimo rozsahu sa ohraničia na 0 (Žiadny).

Filled — 1 na zapísanie vnútornej farby výplne (/IC) pre koncové ozdoby, 0 na ich ponechanie bez výplne.

FillRed, FillGreen, FillBlue — Zložky RGB (0–1) vnútornej farby výplne koncových ozdôb. Ignoruje sa, keď je Filled 0.

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

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

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

Návratová hodnota

1 pri úspechu, 0 ak nie je vybraný žiadny dokument, reťazec vrcholov sa nepodarí analyzovať alebo sa anotáciu nepodarí vytvoriť.

Poznámky

Obdĺžnik /Rect anotácie sa vypočíta automaticky z rozsahu vrcholov plus odsadenie úmerné šírke okraja, aby koncové ozdoby zostali vo vnútri ohraničujúceho rámca anotácie.

Voliteľné pokročilé polia opísané v špecifikácii PDF — /IT (zámer, vrátane PolyLineDimension) a /Measure — tento vstupný bod nevytvára. Po vytvorení ich možno doplniť zápisom priamo do slovníka anotácie.

Ak chcete po vytvorení prepísať farbu čiary, okraj, obsah alebo obdĺžnik, použite SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents a SetAnnotRect.