AddPolyLineAnnotation

Anotace a hotspotové odkazy

Popis

Přidá na vybranou stránku otevřenou lomenou markup anotaci (PDF /Subtype /PolyLine) se zadaným seznamem vrcholů. Lomená čára zůstává otevřená — čtenář nespojuje poslední vrchol s prvním — a na každém koncovém bodě může nést jiný styl zakončení. Zakončení s vnitřkem (ClosedArrow, Square, Circle, Diamond) lze volitelně vyplnit. Barevné složky a neprůhlednost se vyjadřují v měřítku 0–1; Transparency se udává v měřítku 0–100 (0 = zcela neprůhledné, 100 = zcela průhledné). Knihovna zvýší verzi dokumentu na PDF 1.5, pokud se anotace PolyLine vypíše při nižším uzamčeném minimu verze. Definováno v ISO 32000-1 §12.5.6.9

Syntaxe

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;

Parametry

VertexCoords — Souřadnice vrcholů jako jediný řetězec střídajících se hodnot x/y oddělených mezerami, čárkami, středníky, nebo tabulátory. Příklad: "100 100 200 150 300 100" definuje tvar V. Vyžaduje aspoň dva páry (čtyři čísla) a sudý celkový počet čísel, jinak volání vrátí 0

BorderWidth — Šířka tahu lomené čáry a jejích zakončení, v aktuálních jednotkách

LineRed, LineGreen, LineBlue — RGB složky (0–1) barvy čáry, zapsané do /C

StartStyle, EndStyle — Styly zakončení pro první a poslední vrchol. Použijte jedno z:

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

Out-of-range values clamp to 0 (None).

Filled — 1 vypíše barvu vnitřní výplně (/IC) pro koncovou výzdobu, 0 ji nechá nevyplněnou

FillRed, FillGreen, FillBlue — RGB složky (0–1) barvy vnitřní výplně koncové výzdoby. Při Filled = 0 se ignorují

Title — Jméno autora zapsané do položky /T anotace. Chcete-li ho přeskočit, předejte prázdný řetězec

Contents — Tělo vyskakovacího okna přiřazeného k anotaci. Chcete-li ho přeskočit, předejte prázdný řetězec

Transparency — Průhlednost vyjádřená jako procento průhlednosti (0–100). Knihovna ji převede na PDF /CA = 1 - Transparency/100 a omezí na povolený rozsah

Návratová hodnota

1 při úspěchu, 0 není-li vybrán žádný dokument, nepodaří-li se parsovat řetězec vrcholů, nebo nebude-li možné anotaci vytvořit

Poznámky

Obdélník anotace /Rect se spočítá automaticky z rozsahu vrcholů plus odsazení úměrného šířce okraje, takže zakončení zůstanou uvnitř ohraničujícího boxu anotace

Pokročilé volitelné pole popsané specifikací PDF — /IT (intent, včetně PolyLineDimension) a /Measure — tento vstupní bod nevypisuje. Po vytvoření je lze doplnit přímým zápisem do slovníku anotace

Barvu čáry, rámeček, obsah nebo obdélník lze po vytvoření přepsat funkcemi SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents a SetAnnotRect