Page Proprietà

Page espone l'handle FPDF_PAGE raw di PDFium legato alla pagina attiva corrente. L'handle viene allocato quando PageNumber viene impostato (o quando Active passa a True) e resta vivo per il ciclo di vita di quel legame alla pagina. È lo stesso handle che l'API C di PDFium si attende per ogni chiamata FPDFPage_*, FPDF_RenderPage*, annotazioni, content stream e widget di modulo

L'handle è valido solo finché Active è True e un PageNumber valido è impostato. Assegnare un nuovo PageNumber, chiamare ReloadPage, o riportare Active a False distrugge l'handle esistente e (nei primi due casi) ne crea uno nuovo. Non chiamare FPDF_ClosePage su questo handle — il componente è proprietario del suo ciclo di vita e lo smonta automaticamente

Page è una proprietà avanzata utile quando chiami API PDFium che PDFium Delphi Component non ha ancora incapsulato — per esempio rigenerazione personalizzata degli appearance stream, contabilità degli oggetti di pagina, o ritocchi di basso livello all'estrazione del testo. La maggior parte dei chiamanti dovrebbe preferire le proprietà di alto livello (PageWidth, PageHeight, RenderToBitmap, Annotation ecc.) che già gestiscono l'handle correttamente

• Restituisce nil quando nessuna pagina è attiva. Verifica sempre prima di passare l'handle a una funzione PDFium
• Gli handle di pagina non sono threadsafe in PDFium. Usa la pagina solo dal thread che possiede il Document genitore
• Combinalo con Document quando chiami API PDFium che richiedono entrambi gli handle — es. FPDFPage_Delete(Pdf.Document, Pdf.PageNumber - 1)