AddPolyLineAnnotation

Annotazioni, collegamenti hotspot

Descrizione

Aggiunge una PolyLine aperta (PDF /Subtype /PolyLine) con i vertici forniti. La polilinea resta aperta — i lettori non collegano ultimo e primo vertice — e ogni estremità può avere uno stile diverso. Le decorazioni chiuse possono essere riempite. Colore e opacità usano 0–1; Transparency usa 0–100. L'annotazione richiede PDF 1.5. Definita in ISO 32000-1 §12.5.6.9

Sintassi

Delphi

Function TPDFlib.AddPolyLineAnnotation(Const VertexCoords: WideString; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parametri

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

BorderWidth — Spessore del tratto della polilinea e delle relative decorazioni finali, nelle unità correnti

LineRed, LineGreen, LineBlue — Componenti RGB (0–1) del colore linea, scritti in /C

StartStyle, EndStyle — Stili finali per il primo e l'ultimo vertice. Usare uno di:

0 = Nessuno, 1 = Quadrato, 2 = Cerchio, 3 = Rombo, 4 = Freccia aperta, 5 = Freccia chiusa, 6 = Estremità piatta, 7 = Freccia aperta inversa, 8 = Freccia chiusa inversa, 9 = Barra.

I valori fuori intervallo vengono limitati a 0 (Nessuno)

Filled — 1 emette /IC per le decorazioni finali, 0 le lascia vuote

FillRed, FillGreen, FillBlue — componenti RGB (0–1) del colore di riempimento interno della decorazione finale. 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 dell'annotazione è calcolato dall'estensione dei vertici più una spaziatura proporzionale al bordo, mantenendo le decorazioni nel riquadro.

I campi avanzati facoltativi della specifica PDF — /IT (intento, incluso PolyLineDimension) e /Measure — non vengono emessi. Possono essere aggiunti dopo la creazione scrivendo direttamente nel dizionario dell'annotazione

Per sovrascrivere il colore della linea, il bordo, il contenuto o il rettangolo dopo la creazione, usare SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents e SetAnnotRect