FPDF_PAGEOBJECT من PDFium لكائن الصفحة المحدد، مخصص للاستدعاءات المباشرة إلى واجهة PDFium C API الأصليةproperty ObjectHandle[Index: Integer]: Pointer; // read only
تُرجع مؤشر FPDF_PAGEOBJECT المعتم الذي يستخدمه PDFium لتحديد هوية
كائن الصفحة عند الموضع Index على الصفحة الحالية. وهو المقبض نفسه الذي
تحله داخليًا ObjectBounds و ObjectType
وبقية خصائص الكائنات المفهرسة، وقد كُشف هنا كي يستطيع المستدعون المتقدمون استدعاء FPDFPageObj_* و FPDFPath_* و FPDFText_*
أو FPDFImageObj_* التي لم يغلفها المكوّن بعد.
المقبض يملكه كائن الصفحة الحالي ولا يبقى صالحًا إلا ما دامت الصفحة محمَّلة.
ويؤدي استدعاء ReloadPage أو تبديل
PageNumber أو إزالة الكائن بـ
RemoveObject أو ضبط Active على
False إلى إبطال كل مقابض ObjectHandle المخزنة سابقًا. ولا تستدعِ أبدًا
FPDFPageObj_Destroy على مقبض لا يزال مرتبطًا بصفحة —
فتدميره مرتين سيعطل PDFium.
استخدم ObjectType أولًا للتفرع حسب نوع الكائن الذي تشير إليه، ثم قم بالتحويل واستدع عائلة مساعدي PDFium المناسبة. ويمكن أيضًا مقارنة المؤشر من حيث الهوية عبر الاستدعاءات داخل جلسة صفحة واحدة، وهو ما يفيد عند ربط عمليات التحرير بكائناتها الناتجة.
| Index | فهرس كائن صفحة يبدأ من الصفر، 0 ≤ Index < ObjectCount. |
Pointer من أجل قابلية نقل ABI؛ فحوّله إلى FPDF_PAGEOBJECT قبل تمريره إلى الاستدعاءات الأصلية.nil بدلًا من رفع استثناء.
// Read the blend mode of the first object using the raw PDFium API.
uses PDFiumLib;
var Obj: FPDF_PAGEOBJECT;
var Blend: array[0..15] of AnsiChar;
begin
Obj := Pdf1.ObjectHandle[0];
if Assigned(Obj) then
FPDFPageObj_GetBlendMode(Obj, @Blend[0], SizeOf(Blend));
ShowMessage(string(Blend));
end;