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 نقطة) |
| 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 مرتكز على نقاط الكود: فكل محرف Unicode يغطيه الخط يحصل على CID خاص به مع CIDToGIDMap صريح ومدخل ToUnicode بتعيين واحد لواحد، فتُستخرج المحارف التي تشترك في محرف رسم واحد (المسافة و U+00A0، والشرطة و U+00AD، والأوميغا ورمز Ohm) بالمحارف المكتوبة نفسها تمامًا، من المستند الحي ومن الملف المحفوظ على حد سواء. أما الخطوط بلا جدول cmap فرعي Unicode فتعود إلى التضمين المرتكز على محارف الرسم الأصلي
تحل Free Pascal/LCL الأصلية ملفات الخط عبر fontconfig على Linux و CoreText على macOS بحد 64 MiB؛ قد تختار المنصة بديلًا للعائلة الغائبة، ولا يعني العثور على خط تغطية كل 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);