AddInkAnnotation

Annotazioni, collegamenti hotspot

Descrizione

Aggiunge un'annotazione di markup a inchiostro (PDF /Subtype /Ink) che rappresenta uno o più tratti manoscritti, segni a mano libera o schizzi disegnati sulla pagina. La voce di dizionario /InkList contiene una matrice di tratti; ogni tratto è una matrice di coordinate x/y alternate che rappresentano il percorso tracciato da un dispositivo di puntamento tra gli eventi di pressione e rilascio della penna. 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.13

Sintassi

Delphi

Function TPDFlib.AddInkAnnotation(Const InkPaths: WideString; BorderWidth: Double; InkRed, InkGreen, InkBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parametri

InkPaths — Uno o più tratti codificati come un'unica stringa. I tratti sono separati da '|' o da un carattere di nuova riga (CR / LF / CRLF). All'interno di ogni tratto, le coppie di coordinate usano la stessa convenzione dei delimitatori di AddPolygonAnnotation: valori x/y alternati e separati da spazi, virgole, punti e virgola o tabulazioni. Esempio: "100 100 110 105 120 110 | 200 200 210 205" descrive due tratti separati. Ogni tratto deve contenere almeno due coppie di coordinate (quattro numeri) e un numero totale pari di valori; in caso contrario, la chiamata restituisce 0

BorderWidth — larghezza del tratto dell'inchiostro nelle unità correnti

InkRed, InkGreen, InkBlue — Componenti RGB (0–1) del colore dell'inchiostro, scritti in /C

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, la stringa ink non produce un elenco di tratti valido o non è stato possibile creare l'annotazione.

Note

Il /Rect dell'annotazione deriva dall'estensione combinata dei tratti più una spaziatura proporzionale al bordo, mantenendo i tratti nel riquadro

Adatto a scrittura digitalizzata e forme a mano libera programmatiche. Per sovrascrivere colore, bordo, contenuto o rettangolo usare SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents e SetAnnotRect