ObjectHandle Eigenschaft

Liefert den opaken FPDF_PAGEOBJECT-Zeiger, mit dem PDFium das Seitenobjekt an Position Index auf der aktuellen Seite identifiziert. Dasselbe Handle, das ObjectBounds, ObjectType und die anderen indizierten Objekteigenschaften intern auflösen, wird hier offen gelegt, damit fortgeschrittene Aufrufer FPDFPageObj_*-, FPDFPath_*-, FPDFText_*- oder FPDFImageObj_*-Funktionen rufen können, die die Komponente noch nicht wrappt

Das Handle gehört der aktuellen Seite und bleibt nur gültig, solange die Seite geladen ist Ein Aufruf von ReloadPage, ein Wechsel der PageNumber, das Entfernen des Objekts mit RemoveObject oder das Setzen von Active auf False macht alle zuvor gecachten ObjectHandle ungültig. Rufen Sie niemals FPDFPageObj_Destroy auf einem Handle auf, das bereits an eine Seite hängt — die doppelte Zerstörung bringt PDFium zum Absturz

Zuerst ObjectType verwenden, um nach der Objektart zu verzweigen, auf die der Zeiger zeigt, dann casten und die passende PDFium-Helferfamilie aufrufen. Der Zeiger lässt sich auch innerhalb einer einzelnen Seiten-Sitzung aufrufübergreifend auf Identität vergleichen — nützlich, um Bearbeitungsoperationen mit ihren Ergebnisobjekten in Beziehung zu setzen

• 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.