AddCircleAnnotation
Annotazioni, collegamenti hotspot
Descrizione
Aggiunge un'annotazione ellisse (PDF /Subtype /Circle) inscritta nel rettangolo. È un'ellisse completa e diventa un cerchio solo quando Width equivale a Height. Può avere un riempimento uniforme. Colore e opacità usano la scala 0–1; Transparency usa 0–100. Poiché viene emessa la chiave /CA PDF 1.4, i documenti precedenti non bloccati vengono portati a PDF 1.4; le destinazioni bloccate vengono rifiutate. Definita in ISO 32000-1 §12.5.6.8
Sintassi
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;
Parametri
Left — Coordinata orizzontale dell'angolo inferiore sinistro del riquadro', nelle unità correnti
Top — Coordinata verticale dell'angolo inferiore sinistro del riquadro', nelle unità correnti
Larghezza — larghezza del rettangolo di delimitazione
Altezza — altezza del rettangolo di delimitazione
BorderWidth — larghezza del tratto del bordo dell'ellisse nelle unità correnti. Scritta nel campo legacy /Border e nel dizionario /BS.
BorderRed, BorderGreen, BorderBlue — Componenti RGB (0–1) del tratto, scritti in /C
Filled — 1 per emettere un colore di riempimento interno (/IC), 0 per lasciare l'ellisse senza riempimento
FillRed, FillGreen, FillBlue — componenti RGB (0–1) del colore di riempimento interno. Ignorati quando Filled è 0.
Title — Nome autore scritto nella voce /T dell'apposita annotazione. Passare stringa vuota per ignorarlo
Contents — Corpo del popup associato all'annotazione. Passare stringa vuota per ignorarlo
Transparency — opacità espressa come percentuale trasparente (0–100). Convertita in PDF /CA = 1 - Transparency/100 e limitata all'intervallo.
Valore restituito
1 in caso di successo, 0 se nessun documento è selezionato o non è stato possibile creare l'annotazione
Note
L'annotazione viene emessa con i campi standard: /Type /Annot, /Subtype /Circle, /Rect, /C, /IC (se Filled), /BS, /Border, /CA, /F = 4 (stampabile), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Ellipse", /P. Corrisponde agli strumenti ellisse di Adobe Acrobat e Foxit, consentendo ai flussi di revisione esterni di trovare, modificare, commentare e rispondere all'annotazione
Per sovrascrivere rettangolo, colore, contenuto o bordo usare SetAnnotRect, SetAnnotBorderColor, SetAnnotContents e SetAnnotBorderStyle