procedure AddText(const Text, Font: WString; FontSize: Single; X, Y: Double; Color: TColor = clBlack; Alpha: Byte = $FF; Angle: Double = 0.0);
| FontSize | Single. Schriftgröße in Punkten (z. B. 12.0 für 12 pt Text) |
| Color | TColor. Textfüllfarbe. Standard ist clBlack |
| Alpha | Byte. Deckkraft des Texts, wobei $00 vollständig transparent und $FF vollständig deckend ist. Standard ist $FF |
| Angle | Double. Drehwinkel in Grad, gemessen gegen den Uhrzeigersinn ab der positiven X-Achse. Standard ist 0.0 (horizontal) |
AddText rendert eine Unicode-Textzeichenkette mit der angegebenen Schriftart und Größe auf die aktuelle PDF-Seite. Die Position (X, Y) ist der Grundlinien-Ursprung des ersten Zeichens, gemessen in PDF-Benutzereinheiten ab der unteren linken Ecke der Seite (Ursprung unten links, Y nimmt nach oben zu)
Die Schriftart wird über ihren PostScript- oder Familiennamen identifiziert (z. B. 'Arial', 'Times New Roman'). Die Schriftart muss auf dem System verfügbar oder im Dokument eingebettet sein; kann PDFium die angeforderte Schriftart nicht finden, wird eine Standardschriftart als Ersatz verwendet
Verwenden Sie die Parameter Color und Alpha, um das Erscheinungsbild der Textfüllung zu steuern. Setzen Sie Alpha auf einen Wert kleiner als $FF, um halbtransparenten Text zu rendern. Der Parameter Angle dreht die gesamte Textzeichenkette gegen den Uhrzeigersinn um den Grundlinien-Ursprung
Diese Methode fügt den Text als neues Seitenobjekt hinzu. Um den Inhalt eines bestehenden Textobjekts nach dem Hinzufügen zu ändern, verwenden Sie SetText
Eine Systemfont wird einmal pro Dokument als CID-Font eingebettet, schlüsselt über den Code Point auf: Jedes Unicode-Zeichen, das die Font abdeckt, bekommt seine eigene CID mit expliziter CIDToGIDMap und einem 1:1-ToUnicode-Eintrag, sodass Zeichen, die sich ein Glyph teilen (Leerzeichen und U+00A0, Bindestrich und U+00AD, Omega und das Ohm-Zeichen), sowohl aus dem live Dokument als auch aus der gespeicherten Datei exakt die Zeichen extrahieren, die geschrieben wurden. Fonts ohne Unicode-cmap-Subtable fallen auf die native, glyph-basierte Einbettung zurück
Native Free-Pascal/LCL-Builds lösen Systemschriftdateien über fontconfig unter Linux und CoreText unter macOS auf, begrenzt auf 64 MiB; bei fehlender angeforderter Familie kann die Plattform eine Ersatzfamilie wählen; erfolgreicher Lookup beweist nicht Abdeckung jedes Unicode-Zeichens
// 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);