ObjectHandle Egenskap

Returnerar den opaka FPDF_PAGEOBJECT-pekare som PDFium använder för att identifiera sidobjektet på position Index på den aktuella sidan. Samma handtag som ObjectBounds, ObjectType och de övriga indexerade objektegenskaperna löser internt exponeras här så att avancerade anropare kan anropa FPDFPageObj_*-, FPDFPath_*-, FPDFText_*- eller FPDFImageObj_*-funktioner som komponenten ännu inte har omslag för

Handtaget ägs av den aktuella sidan och förblir giltigt bara så länge sidan är inläst Att anropa ReloadPage, växla PageNumber, ta bort objektet med RemoveObject eller sätta Active till False ogiltigförklarar varje tidigare cachlat ObjectHandle. Anropa aldrig FPDFPageObj_Destroy på ett handtag som redan är kopplat till en sida — att förstöra det två gånger kraschar PDFium

Använd ObjectType först för att fördela på objektets slag du pekar på, typomvandla sedan och anropa lämplig PDFium-familj av hjälpare. Pekaren kan också jämföras för identitet mellan anrop inom en enda sidsession, vilket är användbart när redigeringsoperationer ska kopplas till sina resulterande objekt

• Peckartypen deklareras som Pointer för ABI-portabilitet; typomvandla den till FPDF_PAGEOBJECT innan den skickas till inbyggda anrop
• Index utanför intervallet returnerar nil i stället för att utlösa fel
• Efter att objektet har ändrats genom inbyggda PDFium-anrop, följ upp med UpdatePage så att den cachade sidinnehållsströmmen genereras om
• Två olika sidobjekt kan tillfälligt dela samma adress efter RemoveObject om PDFium återanvänder platsen — behåll inte handtaget över strukturella redigeringar