property TextPage: FPDF_TEXTPAGE; // read only
TextPage هندل خام FPDF_TEXTPAGE PDFium را که به صفحهٔ
بارگذاریشدهٔ فعلی متصل است در دسترس قرار میدهد. این هندل بهصورت تنبل هنگام فعال شدن
صفحه ایجاد میشود و در طول عمر آن پیوند صفحه زنده نگه داشته میشود؛ به فراخوانهایی که
به عملیاتی نیاز دارند که خواص سطح بالاتر TPdf ارائه نکرده است، دسترسی مستقیم به
API استخراج متن PDFium (FPDFText_*) میدهد — برای نمونه اجراهای
متنی در سطح نویسهنگاره، دادههای کرنینگ، معناشناسی جستجوی سفارشی یا نگاشتهای خام
از نمایهٔ نویسه به جعبهٔ محاطی
این هندل تنها زمانی معتبر است که Active مقدار True
داشته باشد و صفحهٔ معتبری انتخاب شده باشد. تغییر صفحه (انتساب PageNumber
جدید یا فراخوانی ReloadPage) هندل قبلی را نابود و هندلی تازه میسازد،
بنابراین هندل را میان تغییرات صفحه ذخیره نکنید. کامپوننت مالک این هندل است و آن را
در جریان تخریب صفحه آزاد میکند — خودتان
FPDFText_ClosePage را روی آن فراخوانی نکنید
این یک ویژگی پیشرفته است. بیشتر فراخوانها باید ترجیحاً از پوششهای سطح بالای
CharacterCount، Character[I]، CharacterRectangle[I]
و Find / FindNext استفاده کنند — اینها چرخهٔ عمر
FPDF_TEXTPAGE را از درون مدیریت میکنند. تنها زمانی به هندل خام رو بیاورید
که به APIهایی از PDFium نیاز داشته باشید که PDFium Delphi Component هنوز آنها را
ارائه نکرده است
nil برمیگرداند. پیش از ارسال هندل به
PDFium همیشه آن را بررسی کنیدFPDFText_FindStart را شامل نمیشود؛ آن زمینهٔ جستجو
بهطور مستقل از طریق ویژگی Find نگهداری میشود
var TP: FPDF_TEXTPAGE;
TP := Pdf1.TextPage;
if Assigned(TP) then
ShowMessage(Format('PDFium reports %d chars',
[FPDFText_CountChars(TP)]));