procedure AddText(const Text, Font: WString; FontSize: Single; X, Y: Double; Color: TColor = clBlack; Alpha: Byte = $FF; Angle: Double = 0.0);
| FontSize | Single. Размер шрифта в пунктах (например, 12.0 для текста 12 pt) |
| Color | TColor. Цвет заливки текста. По умолчанию clBlack |
| Alpha | Byte. Непрозрачность текста: $00 — полностью прозрачный, $FF — полностью непрозрачный. По умолчанию $FF |
| Angle | Double. Угол поворота в градусах против часовой стрелки от положительной оси X. По умолчанию 0.0 (горизонтальный текст) |
AddText рисует строку Unicode-текста на текущей странице PDF указанным шрифтом и размером. Позиция (X, Y) — базовая точка первого символа на базовой линии в пользовательских единицах PDF от левого нижнего угла страницы (начало координата внизу слева, ось Y направлена вверх)
Шрифт задаётся PostScript-именем или именем семейства (например, 'Arial', 'Times New Roman'). Шрифт должен быть доступен в системе или уже встроен в документ; если PDFium не находит запрошенный шрифт, он подставляет шрифт по умолчанию
Параметры Color и Alpha управляют видом заливки текста. Задайте Alpha меньше $FF, чтобы получить полупрозрачный текст. Angle поворачивает всю строку против часовой стрелки вокруг базовой точки
Метод добавляет текст как новый объект страницы. Чтобы изменить содержимое уже добавленного текстового объекта, используйте SetText
Системный шрифт встраивается в документ однократно как CID-шрифт с ключом по code point: каждый символ Unicode, который покрывает шрифт, получает собственный CID с явным CIDToGIDMap и взаимно однозначной записью ToUnicode, поэтому символы, делящие один глиф (пробел и U+00A0, дефис и U+00AD, Омега и знак Ома), извлекаются ровно теми символами, какими были записаны, — и из живого документа, и из сохранённого файла. Шрифты без subtable Unicode cmap откатываются к нативному встраиванию с ключом по глифу
Нативные сборки Free Pascal/LCL разрешают системные файлы шрифтов через fontconfig в Linux и CoreText в macOS с лимитом файла шрифта 64 МиБ. Выбранное нативное семейство может оказаться подстановкой платформы, если запрошенное семейство отсутствует; успешный поиск шрифта не доказывает покрытие каждого символа 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);