AddPolyLineAnnotation

Adnotacje i łącza obszarów aktywnych

Opis

Dodaje do wybranej strony adnotację oznaczenia otwartej polilinii (PDF /Subtype /PolyLine) z podaną listą wierzchołków. Polilinia jest otwarta — czytniki nie łączą ostatniego wierzchołka z pierwszym — i może mieć różne style zakończenia linii w obu końcowych punktach. Dekoracje końców mające wnętrze (ClosedArrow, Square, Circle, Diamond) mogą być opcjonalnie wypełnione. Składowe kolorów i krycie są wyrażane w skali 0–1; Transparency podaje się w skali 0–100 (0 = pełne krycie, 100 = pełna przezroczystość). Biblioteka podnosi wersję dokumentu do PDF 1.5, gdy adnotacja PolyLine jest emitowana przy blokadzie niższej wersji minimalnej. Zdefiniowano w ISO 32000-1 §12.5.6.9.

Składnia

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 — współrzędne wierzchołków jako pojedynczy ciąg naprzemiennych wartości x/y rozdzielonych spacjami, przecinkami, średnikami lub tabulatorami. Przykład: "100 100 200 150 300 100" definiuje kształt litery V. Wymaga co najmniej dwóch par (czterech liczb) i parzystej łącznej liczby wartości; w przeciwnym razie wywołanie zwraca 0.

BorderWidth — szerokość obrysu polilinii i jej dekoracji końcowych, w bieżących jednostkach.

LineRed, LineGreen, LineBlue — składowe RGB (0–1) koloru linii, zapisywane we wpisie /C

StartStyle, EndStyle — style zakończenia linii odpowiednio dla pierwszego i ostatniego wierzchołka. Użyj jednej z wartości:

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

Wartości spoza zakresu są ograniczane do 0 (None)

Filled — 1, aby emitować kolor wypełnienia wnętrza (/IC) dekoracji końcowych, 0, aby pozostawić je bez wypełnienia.

FillRed, FillGreen, FillBlue — składowe RGB (0–1) koloru wypełnienia wnętrza dekoracji końcowych. Ignorowane, gdy Filled ma wartość 0.

Title — Nazwa autora zapisywana we wpisie adnotacji oznaczonym jako '/T. Aby pominąć tę wartość, przekaż pusty ciąg

Contents — Treść wyskakującego okna powiązanego z adnotacją. Aby pominąć tę wartość, przekaż pusty ciąg

Transparency — Krycie wyrażone jako procent przezroczystości (0–100). Biblioteka przelicza tę wartość na PDF /CA = 1 - Transparency/100 i ogranicza ją do prawidłowego zakresu

Wartość zwracana

1 po powodzeniu, 0, jeśli nie wybrano dokumentu, nie udało się przeanalizować ciągu wierzchołków albo nie można było utworzyć adnotacji.

Uwagi

Prostokąt /Rect adnotacji jest obliczany automatycznie na podstawie zasięgu wierzchołków oraz marginesu proporcjonalnego do szerokości obramowania, aby dekoracje końców pozostawały wewnątrz prostokąta ograniczającego adnotacji.

Opcjonalne pola zaawansowane opisane w specyfikacji PDF — /IT (przeznaczenie, w tym PolyLineDimension) i /Measure — nie są emitowane przez ten punkt wejścia. Można je dołączyć po utworzeniu, zapisując je bezpośrednio w słowniku adnotacji.

Aby po utworzeniu zastąpić kolor linii, obramowanie, zawartość lub prostokąt, użyj SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents i SetAnnotRect.