ObjectHandle property

يحافظ إدخال API هذا على المعرّفات والتواقيع وكتل الكود ومصطلحات PDF بصيغتها الأصلية.

Raw PDFium FPDF_PAGEOBJECT pointer for the specified page object, intended for direct calls into the native PDFium C API.

Returns the opaque FPDF_PAGEOBJECT pointer that PDFium uses to identify the page object at position Index on the current page. The same handle that ObjectBounds, ObjectType and the other indexed object properties resolve internally is exposed here so advanced callers can invoke FPDFPageObj_*, FPDFPath_*, FPDFText_*, or FPDFImageObj_* functions that are not yet wrapped by the component.

The handle is owned by the current page and stays valid only while the page is loaded. Calling ReloadPage, switching PageNumber, removing the object with RemoveObject, or setting Active to False invalidates every previously cached ObjectHandle. Never call FPDFPageObj_Destroy on a handle that is already attached to a page — destroying it twice will crash PDFium.

Use ObjectType first to dispatch on the kind of object you are pointing at, then cast and call the appropriate PDFium family of helpers. The pointer can also be compared for identity across calls within a single page session, which is useful when correlating editing operations with their resulting objects.

• The pointer type is declared as Pointer for ABI portability; cast it to FPDF_PAGEOBJECT before passing to native calls.
• Out-of-range indices return nil instead of raising.
• After mutating the object through native PDFium calls, follow up with UpdatePage so the cached page content stream is regenerated.
• Two different page objects may briefly share the same address after RemoveObject if PDFium reuses the slot — do not hold the handle across structural edits.

ObjectCount, ObjectType, ObjectBounds, UpdatePage, RemoveObject