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 fuente en puntos (por ejemplo, 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 totalmente transparente y $FF es totalmente 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 renderiza 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 de PDF desde la esquina inferior izquierda de la página (origen en la parte 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 renderizar 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 fuente CID indexada por code point: cada carácter Unicode que la fuente cubre obtiene su propio CID con un CIDToGIDMap explícito y una entrada ToUnicode uno a uno, de modo que los caracteres que comparten glifo (espacio y U+00A0, guion y U+00AD, Omega y el símbolo Ohm) se extraen exactamente como los caracteres escritos, tanto del documento en vivo como del archivo guardado. Las fuentes sin subtabla cmap Unicode recurren a la incrustación nativa indexada por glifo
Las compilaciones nativas Free Pascal/LCL resuelven los ficheros de fuentes del sistema mediante fontconfig en Linux y CoreText en macOS, con un límite de 64 MiB por fichero. La familia nativa seleccionada puede ser una sustitución de plataforma si falta la solicitada; encontrar una fuente no demuestra 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);