AddPolygonAnnotation

Annotazioni, collegamenti hotspot

Descrizione

Aggiunge alla pagina selezionata un'annotazione di markup a poligono chiuso (PDF /Subtype /Polygon) con l'elenco di vertici fornito. Il poligono viene chiuso implicitamente — durante il rendering, i lettori collegano l'ultimo vertice al primo. La forma può essere facoltativamente riempita con un colore interno uniforme. I componenti del colore e l'opacità sono espressi su una scala 0–1; Transparency è indicata su una scala 0–100 (0 = completamente opaco, 100 = completamente trasparente). La libreria porta la versione del documento a PDF 1.5 quando viene emessa un'annotazione Polygon con un blocco della versione minima precedente. Definita in ISO 32000-1 §12.5.6.9

Sintassi

Delphi

Function TPDFlib.AddPolygonAnnotation(Const VertexCoords: WideString; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parametri

VertexCoords — Coordinate dei vertici in una stringa di valori x/y alternati separati da spazi, virgole, punti e virgola o tabulazioni. "100 100 200 100 200 200 100 200" definisce un quadrato. Richiede almeno due coppie e un numero pari di valori; altrimenti restituisce 0

BorderWidth — Spessore del tratto del contorno del poligono, nelle unità correnti

BorderRed, BorderGreen, BorderBlue — Componenti RGB (0–1) del contorno, scritti in /C

Filled — 1 emette /IC per il corpo del poligono, 0 lo lascia 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 non è selezionato alcun documento, se non è possibile analizzare la stringa dei vertici o se non è stato possibile creare l'annotazione.

Note

Il /Rect viene calcolato dall'estensione dei vertici più una spaziatura proporzionale al bordo, mantenendo il contorno nel riquadro

I campi avanzati facoltativi descritti dalla specifica PDF — /BE (effetto del bordo, incluso lo stile con contorno a nuvola), /IT (intento, inclusi PolygonCloud e PolygonDimension) e /Measure — non vengono emessi da questo punto di ingresso. Possono essere aggiunti dopo la creazione scrivendoli direttamente nel dizionario dell'annotazione

Per sovrascrivere colore del contorno, bordo, contenuto o rettangolo, usare SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents e SetAnnotRect