AddSquareAnnotation

Adnotacje i łącza obszarów aktywnych

Opis

Dodaje do wybranej strony adnotację oznaczenia prostokątnego (PDF /Subtype /Square). Adnotacja rysuje obrysowany prostokąt wpisany w podany prostokąt ograniczający i może być opcjonalnie wypełniona jednolitym kolorem wnętrza. 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ść). 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.8.

Składnia

Delphi

Function TPDFlib.AddSquareAnnotation(Left, Top, Width, Height: Double; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parametry

Left — współrzędna pozioma lewego dolnego narożnika prostokąta adnotacji ('prostokąt adnotacji') w bieżących jednostkach

Top — współrzędna pionowa lewego dolnego narożnika prostokąta adnotacji ('prostokąt adnotacji') w bieżących jednostkach

Width — szerokość prostokąta adnotacji

Height — wysokość prostokąta adnotacji

BorderWidth — szerokość obrysu obramowania prostokąta, w bieżących jednostkach. Zapisywana zarówno w starszym polu /Border, jak i w słowniku stylu obramowania /BS.

BorderRed, BorderGreen, BorderBlue — składowe RGB (0–1) koloru obrysu, zapisywane w /C

Filled — 1, aby emitować kolor wypełnienia wnętrza (/IC), 0, aby pozostawić prostokąt bez wypełnienia.

FillRed, FillGreen, FillBlue — składowe RGB (0–1) koloru wypełnienia wnętrza. 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

Adnotacja jest emitowana ze standardowym zestawem pól oznaczeń: /Type /Annot, /Subtype /Square, /Rect, /C, /IC (gdy Filled), /BS, /Border, /CA, /F = 4 (drukowalna), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Rectangle", /P. Odpowiada to wynikowi narzędzi recenzowania prostokątów w Adobe Acrobat i Foxit, dzięki czemu zewnętrzne przepływy recenzowania mogą odnajdywać, edytować, komentować i odpowiadać na powstałą adnotację.

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