AddLineAnnotation

Annotazioni, collegamenti hotspot

Descrizione

Aggiunge un'annotazione di markup linea (PDF /Subtype /Line) tra due estremità nella pagina selezionata. Ogni estremità può avere uno stile terminale diverso (freccia, quadrato, cerchio, rombo, …) e il corpo della linea può essere disegnato in qualsiasi colore RGB con opacità configurabile. Le decorazioni terminali dotate di un interno (ClosedArrow, Square, Circle, Diamond) possono essere facoltativamente riempite. Poiché questo punto di ingresso emette la chiave di opacità /CA dell'annotazione PDF 1.4, prima del salvataggio la libreria porta i documenti precedenti non bloccati a PDF 1.4; le destinazioni precedenti bloccate vengono rifiutate dal controllo di compatibilità. Definita in ISO 32000-1 §12.5.6.7

Sintassi

Delphi

Function TPDFlib.AddLineAnnotation(StartLeft, StartTop, EndLeft, EndTop: Double; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parametri

StartLeft, StartTop — Coordinate del punto iniziale della linea', nelle unità correnti

EndLeft, EndTop — Coordinate del punto finale della linea', nelle unità correnti

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

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

StartStyle, EndStyle — Stili di fine linea per i punti iniziale e finale. 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 nessun documento è selezionato o non è stato possibile creare l'annotazione

Note

Il valore /Rect dell'annotazione viene calcolato automaticamente a partire dai due estremi, aggiungendo una spaziatura proporzionale alla larghezza del bordo affinché le decorazioni terminali restino nel riquadro di delimitazione dell'annotazione. I lettori PDF richiedono che /Rect contenga l'intero disegno visibile, altrimenti le decorazioni terminali potrebbero essere ritagliate

I campi avanzati facoltativi descritti dalla specifica PDF — /LL (lunghezza della linea guida), /LLE, /LLO, /Cap, /CP, /CO e /Measure — non vengono emessi da questo punto di ingresso. Possono essere aggiunti dopo la creazione scrivendoli 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