procedure AddText(const Text, Font: WString; FontSize: Single; X, Y: Double; Color: TColor = clBlack; Alpha: Byte = $FF; Angle: Double = 0.0);
| FontSize | Single. Lettergrootte in punten (bijv. 12.0 voor 12 pt tekst). |
| Color | TColor. Tekstvulkleur. Standaard is clBlack. |
| Alpha | Byte. Dekking van de tekst, waarbij $00 volledig transparant is en $FF volledig dekkend. Standaard is $FF. |
| Angle | Double. Rotatiehoek in graden, tegengesteld aan de klok gemeten vanaf de positieve X-as. Standaard is 0.0 (horizontaal). |
AddText rendert een Unicode-tekstreeks op de huidige PDF-pagina met het opgegeven lettertype en formaat. De positie (X, Y) is de basislijnoorsprong van het eerste teken, gemeten in PDF-gebruikerseenheden vanuit de linkerbenedenhoek van de pagina (oorsprong linksonder, Y neemt naar boven toe).
Het lettertype wordt geïdentificeerd aan de hand van zijn PostScript- of familienaam (bijv. 'Arial', 'Times New Roman'). Het lettertype moet op het systeem beschikbaar zijn of in het document zijn ingesloten; als PDFium het gevraagde lettertype niet kan vinden, wordt een standaardlettertype vervangen.
Gebruik de parameters Color en Alpha om de weergave van de tekstvulling te regelen. Stel Alpha in op een waarde kleiner dan $FF om semitransparante tekst te renderen. De parameter Angle roteert de volledige tekstreeks tegengesteld aan de klok rond de basislijnoorsprong.
Deze methode voegt de tekst toe als een nieuw paginaobject. Om de inhoud van een bestaand tekstobject te wijzigen nadat het is toegevoegd, gebruikt u SetText.
Een systeemfont wordt één keer per document ingesloten als CID-font, gekeyd op code point: elk Unicode-teken dat het font dekt krijgt zijn eigen CID met een expliciete CIDToGIDMap en een een-op-een ToUnicode-entry, zodat tekens die een glyph delen (spatie en U+00A0, koppelteken en U+00AD, Omega en het Ohm-teken) exact als de geschreven tekens extracten, zowel uit het live document als uit het opgeslagen bestand. Fonts zonder een Unicode-cmap-subtabel vallen terug op de native embedding via glyph-key
Native Free Pascal/LCL-builds resolven systeemfontbestanden via fontconfig op Linux en CoreText op macOS, met een limiet van 64 MiB per fontbestand. De geselecteerde native familie kan een platformsubstitutie zijn wanneer de gevraagde familie ontbreekt; een geslaagde fontopzoeking bewijst geen dekking voor elk Unicode-teken
// 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);