property TextPage: FPDF_TEXTPAGE; // read only
يكشف TextPage مقبض FPDF_TEXTPAGE الخام من PDFium المرتبط بـ
الصفحة المحمَّلة حاليًا. ويُخلق المقبض بكسل عندما تصبح الصفحة نشطة
ويُبقى حيًا على مدى عمر ذلك الربط بالصفحة؛ وهو يتيح وصولًا مباشرًا إلى
واجهة استخراج النص في PDFium (FPDFText_*) للمستدعين المحتاجين
عمليات لم تكشفها خصائص TPdf رفيعة المستوى — مثل
مسارات نص على مستوى الحرف الرمزي، وبيانات تباعد الأحرف، ودلالات بحث مخصصة، أو تعيينات خام من
فهرس أحرف إلى
صندوق محيط
لا يصح المقبض إلا بينما Active بقيمة True وصفحة
صالحة مختارة. وتبديل الصفحات (إسناد PageNumber جديد أو استدعاء
ReloadPage) يدمّر المقبض السابق ويخلق مقبضًا جديدًا، فلا تخزّن
المقبض عبر تغييرات الصفحات. والمكوّن يملك المقبض ويحرره
أثناء تفكيك الصفحة — لا تستدعِ
FPDFText_ClosePage عليه بنفسك
هذه خاصية متقدمة. وينبغي لأغلب المستدعين تفضيل الغلافات رفيعة المستوى
CharacterCount و Character[I] و CharacterRectangle[I]
و Find / FindNext — فهي تدير دورة حياة
FPDF_TEXTPAGE داخليًا أصلًا. وانزل إلى المقبض الخام فقط عندما
تحتاج واجهات PDFium التي لم يكشفها PDFium Delphi Component بعد
nil عندما لا تكون هناك صفحة نشطة. وتحقق دائمًا من المقبض قبل
تمريره إلى PDFiumFPDFText_FindStart؛ فسياق
البحث ذاك مملوك بشكل مستقل عبر خاصية Find
var TP: FPDF_TEXTPAGE;
TP := Pdf1.TextPage;
if Assigned(TP) then
ShowMessage(Format('PDFium reports %d chars',
[FPDFText_CountChars(TP)]));