procedure AddText(const Text, Font: WString; FontSize: Single; X, Y: Double; Color: TColor = clBlack; Alpha: Byte = $FF; Angle: Double = 0.0);
| FontSize | Single. Rozmiar czcionki w punktach (np. 12.0 dla tekstu 12 pt) |
| Color | TColor. Kolor wypełnienia tekstu. Wartość domyślna to clBlack |
| Alpha | Byte. Nieprzezroczystość tekstu, gdzie $00 oznacza pełną przezroczystość, a $FF pełną nieprzezroczystość. Wartość domyślna to $FF |
| Angle | Double. Kąt obrotu w stopniach, mierzony przeciwnie do ruchu wskazówek zegara od dodatniej osi X. Wartość domyślna to 0.0 (poziomo) |
AddText renderuje ciąg tekstowy Unicode na bieżącej stronie PDF przy użyciu wskazanej czcionki i rozmiaru. Położenie (X, Y) to początek linii bazowej pierwszego znaku, mierzony w jednostkach użytkownika PDF od lewego dolnego rogu strony (początek układu w lewym dolnym rogu, Y rośnie w górę)
Czcionka jest identyfikowana po swojej nazwie PostScript lub rodzinie (np. 'Arial', 'Times New Roman'). Czcionka musi być dostępna w systemie lub osadzona w dokumencie; jeśli PDFium nie może odnaleźć żądanej czcionki, podstawiona zostanie czcionka domyślna
Parametrów Color i Alpha używaj do sterowania wyglądem wypełnienia tekstu. Ustaw Alpha na wartość mniejszą niż $FF, aby renderować półprzezroczysty tekst. Parametr Angle obraca cały ciąg tekstowy przeciwnie do ruchu wskazówek zegara wokół początku linii bazowej
Ta metoda dodaje tekst jako nowy obiekt strony. Aby zmodyfikować zawartość istniejącego obiektu tekstowego po jego dodaniu, użyj SetText
Czcionka systemowa jest osadzana raz na dokument jako czcionka CID kluczowana punktem kodowym: każdy znak Unicode pokrywany przez czcionkę dostaje własny CID z jawnym CIDToGIDMap i jednoznacznym wpisem ToUnicode, więc znaki dzielące glif (spacja i U+00A0, dywiz i U+00AD, Omega i znak oma) ekstrahują się dokładnie jako zapisane znaki — zarówno z żywego dokumentu, jak i z zapisanego pliku. Czcionki bez podtablicy cmap Unicode spadają do natywnego osadzania kluczowanego glifami
Natywne kompilacje Free Pascal/LCL rozwiązują pliki czcionek systemowych przez fontconfig na Linuksie i CoreText na macOS, z limitem pliku czcionki 64 MiB. Wybrana natywna rodzina może być podstawieniem platformy, gdy żądanej rodziny brakuje; udane wyszukanie czcionki nie dowodzi pokrycia każdego znaku 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);