AddSquareAnnotation

Annotazioni, collegamenti hotspot

Descrizione

Aggiunge un'annotazione di markup rettangolare (PDF /Subtype /Square) alla pagina selezionata. L'annotazione disegna un rettangolo con tratto inscritto nel rettangolo di delimitazione specificato e può essere riempita facoltativamente con un colore interno uniforme. I componenti di colore e l'opacità sono espressi su una scala 0–1; Transparency è espressa su una scala 0–100 (0 = completamente opaco, 100 = completamente trasparente). Poiché questo punto di ingresso emette la chiave di opacità /CA dell'annotazione PDF 1.4, prima del salvataggio la libreria eleva a PDF 1.4 i documenti non bloccati di versione inferiore; le destinazioni bloccate su una versione inferiore vengono rifiutate dal controllo di compatibilità. Definito in ISO 32000-1 §12.5.6.8

Sintassi

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;

Parametri

Left — Coordinata orizzontale dell'angolo inferiore sinistro del rettangolo dell'apposita annotazione, nelle unità correnti

Top — Coordinata verticale dell'angolo inferiore sinistro del rettangolo dell'apposita annotazione

Larghezza — larghezza del rettangolo dell'annotazione

Altezza — altezza del rettangolo dell'annotazione

BorderWidth — larghezza del tratto del bordo del rettangolo 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 il rettangolo 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 usa i campi standard /Type /Annot, /Subtype /Square, /Rect, /C, /IC, /BS, /Border, /CA, /F = 4, /M, /CreationDate, /NM, /T, /Contents, /Subj = "Rectangle", /P, come gli strumenti rettangolo di Adobe Acrobat e Foxit

Per sovrascrivere il rettangolo, il colore, il contenuto o il bordo dell'annotazione dopo la creazione, usare SetAnnotRect, SetAnnotBorderColor, SetAnnotContents e SetAnnotBorderStyle