ObjectHandle Proprietà

Restituisce il puntatore opaco FPDF_PAGEOBJECT che PDFium usa per identificare l'oggetto di pagina alla posizione Index sulla pagina corrente. Lo stesso handle che ObjectBounds, ObjectType e le altre proprietà indicizzate sugli oggetti risolvono internamente viene esposto qui, così i chiamanti avanzati possono invocare le funzioni FPDFPageObj_*, FPDFPath_*, FPDFText_* o FPDFImageObj_* non ancora incapsulate dal componente

L'handle è di proprietà della pagina corrente e resta valido solo finché la pagina è caricata Chiamare ReloadPage, cambiare PageNumber, rimuovere l'oggetto con RemoveObject, o impostare Active a False invalida ogni ObjectHandle messo in cache in precedenza. Non chiamare mai FPDFPageObj_Destroy su un handle già attaccato a una pagina — distruggerlo due volte crasha PDFium

Usa prima ObjectType per fare dispatch sul tipo di oggetto a cui stai puntando, poi fai il cast e chiama la famiglia di helper PDFium appropriata. Il puntatore si può anche confrontare per identità tra chiamate dentro una singola sessione di pagina, cosa utile quando correli le operazioni di modifica con i loro oggetti risultanti

• Il tipo del puntatore è dichiarato Pointer per portabilità ABI; fai il cast a FPDF_PAGEOBJECT prima di passarlo alle chiamate native
• Gli indici fuori intervallo restituiscono nil invece di sollevare eccezioni
• Dopo aver mutato l'oggetto tramite chiamate native PDFium, completa con UpdatePage così lo stream di contenuto della pagina in cache viene rigenerato
• Due oggetti di pagina diversi possono condividere brevemente lo stesso indirizzo dopo RemoveObject se PDFium riusa lo slot — non trattieni l'handle attraverso modifiche strutturali