procedure AddText(const Text, Font: WString; FontSize: Single; X, Y: Double; Color: TColor = clBlack; Alpha: Byte = $FF; Angle: Double = 0.0);
| FontSize | Single. Taille de police en points (par ex. 12.0 pour un texte 12 pt) |
| Color | TColor. Text fill color. Default is clBlack |
| Alpha | Byte. Opacité du texte, où $00 est totalement transparent et $FF totalement opaque. La valeur par défaut est $FF |
| Angle | Double. Angle de rotation en degrés, mesuré dans le sens antihoraire depuis l’axe X positif. La valeur par défaut est 0.0 (horizontal) |
AddText rend une chaîne de texte Unicode sur la page PDF courante à l’aide de la police et de la taille indiquées. La position (X, Y) est l’origine de la ligne de base du premier caractère, mesurée en unités utilisateur PDF depuis le coin inférieur gauche de la page (origine en bas à gauche, Y augmente vers le haut)
La police est identifiée par son nom PostScript ou de famille (par ex. 'Arial', 'Times New Roman'). La police doit être disponible sur le système ou intégrée au document ; si PDFium ne peut pas localiser la police demandée, il la remplacera par une police par défaut
Utilisez les paramètres Color et Alpha pour contrôler l’apparence du remplissage de texte. Définissez Alpha à une valeur inférieure à $FF pour rendre du texte semi-transparent. Le paramètre Angle fait pivoter toute la chaîne de texte dans le sens antihoraire autour de l’origine de la ligne de base
Cette méthode ajoute le texte en tant que nouvel objet de page. Pour modifier le contenu d’un objet texte existant après son ajout, utilisez SetText
Une police système est intégrée une fois par document comme police CID indexée par point de code : chaque caractère Unicode couvert par la police obtient son propre CID avec un CIDToGIDMap explicite et une entrée ToUnicode un à un, si bien que les caractères partageant un glyphe (espace et U+00A0, trait d’union et U+00AD, Oméga et symbole Ohm) s’extraient exactement comme les caractères écrits, aussi bien depuis le document en mémoire que depuis le fichier enregistré. Les polices sans sous-table cmap Unicode retombent sur l’intégration native indexée par glyphe
Les builds Free Pascal/LCL natifs résolvent les fichiers de police système avec fontconfig sous Linux et CoreText sous macOS, avec une limite de 64 MiB par fichier ; la famille sélectionnée peut être une substitution plateforme si la famille demandée manque ; trouver une police ne garantit pas tous les caractères 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);