procedure AddText(const Text, Font: WString; FontSize: Single; X, Y: Double; Color: TColor = clBlack; Alpha: Byte = $FF; Angle: Double = 0.0);
| FontSize | Single. Tamaño de la fuente en puntos (p. ej. 12.0 para texto de 12 pt) |
| Color | TColor. Color de relleno del texto. El valor predeterminado es clBlack |
| Alpha | Byte. Opacidad del texto, donde $00 es completamente transparente y $FF es completamente opaco. El valor predeterminado es $FF |
| Angle | Double. Ángulo de rotación en grados, medido en sentido antihorario desde el eje X positivo. El valor predeterminado es 0.0 (horizontal) |
AddText dibuja una cadena de texto Unicode en la página PDF actual usando la fuente y el tamaño especificados. La posición (X, Y) es el origen de la línea base del primer carácter, medido en unidades de usuario PDF desde la esquina inferior izquierda de la página (origen en la esquina inferior izquierda, Y aumenta hacia arriba)
La fuente se identifica por su nombre PostScript o de familia (p. ej. 'Arial', 'Times New Roman'). La fuente debe estar disponible en el sistema o incrustada en el documento; si PDFium no puede localizar la fuente solicitada, sustituirá una fuente predeterminada
Use los parámetros Color y Alpha para controlar la apariencia del relleno del texto. Establezca Alpha en un valor menor que $FF para dibujar texto semitransparente. El parámetro Angle rota toda la cadena de texto en sentido antihorario alrededor del origen de la línea base
Este método agrega el texto como un nuevo objeto de página. Para modificar el contenido de un objeto de texto existente después de agregarlo, use SetText
Una fuente del sistema se incrusta una vez por documento como una fuente CID con el punto de código como clave: cada carácter Unicode que la fuente cubre recibe su propio CID con un CIDToGIDMap explícito y una entrada ToUnicode uno a uno, de modo que los caracteres que comparten glifo (el espacio y U+00A0, el guion y U+00AD, Omega y el signo de ohm) se extraen exactamente como los caracteres que se escribieron, tanto del documento vivo como del archivo guardado. Las fuentes sin una subtabla cmap Unicode recurren a la incrustación nativa con el glifo como clave
Las compilaciones nativas Free Pascal/LCL resuelven los archivos de fuentes del sistema mediante fontconfig en Linux y CoreText en macOS, con un límite de 64 MiB por archivo de fuente; si falta la familia solicitada, la plataforma puede sustituirla por otra; encontrar una fuente no garantiza que cubra todos los caracteres 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);