property Page: FPDF_PAGE; // read only
يكشف Page عن مقبض FPDF_PAGE الخام الخاص بـ PDFium المرتبط بالصفحة
النشطة حاليًا. يُخصَّص المقبض عندما يُضبط PageNumber (أو عندما
ينتقل Active إلى True) ويبقى حيًا طوال
عمر ارتباط تلك الصفحة. وهو نفس المقبض الذي تتوقعه واجهة C الخاصة بـ PDFium
لكل استدعاء FPDFPage_*، وFPDF_RenderPage*، والتعليقات التوضيحية، وتدفقات
المحتوى، وعناصر النماذج
يكون المقبض صالحًا فقط عندما يكون Active بقيمة True ويكون PageNumber
صالحًا مضبوطًا. إسناد PageNumber جديد، أو استدعاء
ReloadPage، أو إعادة ضبط Active إلى False
يُتلف المقبض الحالي و(في الحالتين الأوليين) ينشئ مقبضًا جديدًا. لا
تستدعِ FPDF_ClosePage على هذا المقبض — فالمكوّن يملك
دورة حياته وسيُزيله تلقائيًا
Page خاصية متقدمة مفيدة عند استدعاء واجهات PDFium البرمجية التي لم يغلّفها PDFiumPas
بعد — على سبيل المثال إعادة توليد تدفق المظهر المخصص، أو مسك
دفاتر كائنات الصفحة، أو تعديلات استخراج النص منخفضة المستوى. يجب على أغلب المستدعين تفضيل
الخصائص عالية المستوى (PageWidth، وPageHeight،
وRenderToBitmap، وAnnotation، إلخ) التي تدير
المقبض بشكل صحيح بالفعل
nil عندما لا تكون هناك صفحة نشطة. تحقق دائمًا قبل تمرير
المقبض إلى دالة PDFiumDocument الأصليDocument عند استدعاء واجهات PDFium البرمجية التي تتطلب كلا
المقبضين — مثل FPDFPage_Delete(Pdf.Document, Pdf.PageNumber - 1)
var P: FPDF_PAGE;
Pdf1.Active := True;
Pdf1.PageNumber := 1;
P := Pdf1.Page;
if Assigned(P) then
ShowMessage(Format('%.0f x %.0f points',
[FPDF_GetPageWidth(P), FPDF_GetPageHeight(P)]));