AddLineAnnotation

Adnotacje i łącza obszarów aktywnych

Opis

Dodaje adnotację oznaczenia liniowego (PDF /Subtype /Line) pomiędzy dwoma punktami końcowymi na wybranej stronie. Każdy koniec może mieć inny styl zakończenia linii (strzałka, kwadrat, okrąg, romb, …), a główna część linii może być rysowana dowolnym kolorem RGB z konfigurowalnym kryciem. Dekoracje końców mające wnętrze (ClosedArrow, Square, Circle, Diamond) mogą być opcjonalnie wypełnione. Ponieważ ten punkt wejścia emituje klucz krycia adnotacji PDF 1.4 /CA, biblioteka przed zapisem podnosi wersję niższych, niezablokowanych dokumentów do PDF 1.4; zablokowane niższe wersje docelowe są odrzucane przez kontrolę zgodności. Zdefiniowano w ISO 32000-1 §12.5.6.7.

Składnia

Delphi

Function TPDFlib.AddLineAnnotation(StartLeft, StartTop, EndLeft, EndTop: Double; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parametry

StartLeft, StartTop — współrzędne początkowego punktu końcowego linii's, w bieżących jednostkach.

EndLeft, EndTop — współrzędne końcowego punktu końcowego linii's, w bieżących jednostkach.

BorderWidth — szerokość obrysu linii 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 początkowego i końcowego punktu. 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 w przypadku powodzenia albo 0, gdy nie wybrano dokumentu lub nie można było utworzyć adnotacji

Uwagi

Prostokąt /Rect adnotacji jest automatycznie obliczany na podstawie dwóch punktów końcowych oraz marginesu proporcjonalnego do szerokości obramowania, aby dekoracje końców pozostawały wewnątrz prostokąta ograniczającego adnotacji. Czytniki PDF wymagają, aby ograniczający /Rect obejmował cały widoczny rysunek; w przeciwnym razie dekoracje końców mogą zostać przycięte.

Opcjonalne pola zaawansowane opisane w specyfikacji PDF — /LL (długość linii pomocniczej), /LLE, /LLO, /Cap, /CP, /CO 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.