AddCircleAnnotation

Adnotacje i łącza obszarów aktywnych

Opis

Dodaje adnotację znacznikową elipsy (PDF /Subtype /Circle) wpisaną w podany prostokąt. Mimo nazwy adnotacja jest pełną elipsą i ma postać rzeczywistego okręgu tylko wtedy, gdy Width równa się Height. Adnotację można opcjonalnie wypełnić jednolitym kolorem wnętrza. Składowe koloru i krycie są wyrażane w skali 0–1; Transparency podaje się w skali 0–100 (0 = całkowicie nieprzezroczyste, 100 = całkowicie przezroczyste). Ponieważ ten punkt wejścia emituje klucz krycia adnotacji PDF 1.4 /CA, biblioteka podnosi niższe, niezablokowane dokumenty do PDF 1.4 przed zapisem; zablokowane niższe cele są odrzucane przez kontrolę zgodności. Definicję zawiera ISO 32000-1 §12.5.6.8

Składnia

Delphi

Function TPDFlib.AddCircleAnnotation(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 ograniczającego ('prostokąt ograniczający') w bieżących jednostkach

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

Width — szerokość prostokąta ograniczającego

Height — wysokość prostokąta ograniczającego

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

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

Filled — 1, aby wyemitować kolor wypełnienia wnętrza (/IC), albo 0, aby pozostawić elipsę 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 znacznikowych: /Type /Annot, /Subtype /Circle, /Rect, /C, /IC (gdy Filled), /BS, /Border, /CA, /F = 4 (drukowalna), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Ellipse", /P. Odpowiada to danym tworzonym przez narzędzia recenzowania elips programu Adobe Acrobat i Foxit, dzięki czemu zewnętrzne przepływy recenzji mogą znaleźć, edytować, komentować i odpowiadać na wynikową adnotację

Aby po utworzeniu zastąpić prostokąt ograniczający, kolor, treść lub krawędź, użyj SetAnnotRect, SetAnnotBorderColor, SetAnnotContents i SetAnnotBorderStyle