procedure AddText(const Text, Font: WString; FontSize: Single; X, Y: Double; Color: TColor = clBlack; Alpha: Byte = $FF; Angle: Double = 0.0);
| FontSize | Single. Dimensione del font in punti, ad esempio 12.0 per testo da 12 pt |
| Color | TColor. Colore di riempimento del testo; il valore predefinito è clBlack |
| Alpha | Byte. Opacità del testo: $00 è completamente trasparente e $FF completamente opaco; il valore predefinito è $FF |
| Angle | Double. Angolo di rotazione in gradi, in senso antiorario dall'asse X positivo; il valore predefinito è 0.0, orizzontale |
AddText disegna una stringa Unicode nella pagina PDF corrente con font e dimensione specificati. La posizione (X, Y) è l'origine della baseline del primo carattere, in unità utente PDF dall'angolo inferiore sinistro della pagina; Y cresce verso l'alto
Il font è identificato dal nome PostScript o di famiglia, ad esempio 'Arial' o 'Times New Roman'. Deve essere disponibile sul sistema o incorporato nel documento; se PDFium non trova quello richiesto, lo sostituisce con un font predefinito
Usare Color e Alpha per controllare il riempimento del testo. Un Alpha inferiore a $FF produce testo semitrasparente. Angle ruota tutta la stringa in senso antiorario intorno all'origine della baseline
Il metodo aggiunge il testo come nuovo oggetto pagina. Per cambiare il contenuto di un oggetto di testo già aggiunto usare SetText
Un font di sistema viene incorporato una sola volta per documento come font CID con chiave sul code point: ogni carattere Unicode coperto dal font ottiene un proprio CID con un CIDToGIDMap esplicito e una voce ToUnicode uno-a-uno, così i caratteri che condividono lo stesso glifo (spazio e U+00A0, trattino e U+00AD, Omega e il simbolo Ohm) vengono estratti esattamente come i caratteri scritti, sia dal documento attivo sia dal file salvato. I font senza una subtable cmap Unicode ricadono sull'incorporamento nativo con chiave sul glifo
Le build native Free Pascal/LCL risolvono i file dei font di sistema tramite fontconfig su Linux e CoreText su macOS, con limite di 64 MiB per file. Se la famiglia richiesta manca, quella nativa scelta può essere una sostituzione di piattaforma; trovare il font non dimostra copertura di ogni carattere Unicode
// Add a title string near the top of an A4 page
// A4 page height = 841.89 pt; place text 50 pt from the top
Pdf1.NewPage(595, 842);
Pdf1.AddText('Hello, PDFium Delphi Component!', 'Arial', 24, 72, 768);
// Red text at 45 degrees with 50% opacity
Pdf1.AddText('Rotated', 'Arial', 18, 200, 400, clRed, $80, 45);