property Page: FPDF_PAGE; // read only
Page stelt de ruwe PDFium FPDF_PAGE-handle beschikbaar die aan de momenteel actieve pagina is gebonden. De handle wordt toegewezen wanneer PageNumber wordt ingesteld (of wanneer Active naar True overgaat) en wordt in leven gehouden voor de levensduur van die paginabinding. Het is dezelfde handle die de C-API van PDFium verwacht voor elke FPDFPage_*-, FPDF_RenderPage*-, annotatie-, inhoudsstroom- en formulierwidget-aanroep.
De handle is alleen geldig zolang Active True is en een geldige PageNumber is ingesteld. Het toewijzen van een nieuwe PageNumber, het aanroepen van ReloadPage, of het instellen van Active terug op False vernietigt de bestaande handle en (in de eerste twee gevallen) maakt een nieuwe aan. Roep geen FPDF_ClosePage aan op deze handle — de component is eigenaar van zijn levensduur en zal deze automatisch afbreken.
Page is een geavanceerde eigenschap, nuttig bij het aanroepen van PDFium-API's die PDFiumPas nog niet heeft ingepakt — bijvoorbeeld aangepaste verschijningsstroomregeneratie, pagina-objectadministratie, of low-level tekstextractie-tweaks. De meeste aanroepers zouden de hoog-niveau-eigenschappen (PageWidth, PageHeight, RenderToBitmap, Annotation enz.) moeten verkiezen, die de handle al correct beheren.
nil wanneer geen pagina actief is. Controleer altijd voordat u
de handle doorgeeft aan een PDFium-functie.Document.Document bij het aanroepen van PDFium-API's die beide
handles nemen — bijv. FPDFPage_Delete(Pdf.Document, Pdf.PageNumber - 1).
var P: FPDF_PAGE;
Pdf1.Active := True;
Pdf1.PageNumber := 1;
P := Pdf1.Page;
if Assigned(P) then
ShowMessage(Format('%.0f x %.0f points',
[FPDF_GetPageWidth(P), FPDF_GetPageHeight(P)]));