وثائق PDFiumPas

Page الخاصية

يحافظ إدخال API هذا على المعرّفات والتواقيع وكتل الكود ومصطلحات PDF بصيغتها الأصلية.
المكون: TPdf  ·  الوحدة: PDFium
Native PDFium page handle for the currently active page.

الصياغة

property Page: FPDF_PAGE; // read only

الوصف

تعرض Page المقبض الخام FPDF_PAGE الخاص بـ PDFium المرتبط بالصفحة النشطة حاليًا. يُخصص هذا المقبض عندما يتم تعيين PageNumber أو عندما ينتقل Active إلى True، ويظل حيًا طوال عمر هذا الارتباط. وهو نفس المقبض الذي تتوقعه C API الخاصة بـ PDFium في كل استدعاء خاص بالصفحة

يكون المقبض صالحًا فقط بينما تكون Active مساوية لـ True ويكون PageNumber صالحًا مضبطًا. يؤدي تعيين PageNumber جديد أو استدعاء ReloadPage أو إعادة Active إلى False إلى إتلاف المقبض الموجود وإنشاء مقبض جديد في الحالتين الأوليين. لا تستدعِ FPDF_ClosePage على هذا المقبض، لأن المكوّن يملك عمره ويتولى إزالته تلقائيًا

Page هي خاصية متقدمة ومفيدة عند استدعاء واجهات API الخاصة بـ PDFium التي لم يغطها PDFiumPas بعد، مثل إعادة توليد appearance stream مخصصة أو تتبع page-object أو تعديلات استخراج النص منخفضة المستوى. ينبغي لمعظم المستدعين تفضيل الخصائص عالية المستوى (PageWidth وPageHeight وRenderToBitmap وAnnotation وغيرها) لأنها تدير المقبض بصورة صحيحة بالفعل

ملاحظات

مثال

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)]));

انظر أيضا

Document, PageNumber, TextPage, FormHandle