Docs PDFiumPas

Page Propriété

Cette entrée API conserve identifiants, signatures, blocs de code et termes PDF dans leur forme d’origine.
Composant: TPdf  ·  Unité: PDFium
Native PDFium page handle for the currently active page.

Syntaxe

property Page: FPDF_PAGE; // read only

Description

Page exposes the raw PDFium FPDF_PAGE handle lié à la page actuellement active. Le handle est alloué lorsque PageNumber is set (or when Active transitions to True) et est maintenu en vie pendant toute la durée de vie de cette liaison de page. C’est le même handle que l’API C de PDFium attend pour chaque FPDFPage_*, FPDF_RenderPage*, annotation, content stream, and form widget call.

Le handle n’est valide que tant que Active is True and a valid PageNumber is set. Assigning a new PageNumber, calling ReloadPage, or setting Active back to False destroys the existing handle and (in the first two cases) creates a new one. Do not call FPDF_ClosePage sur ce handle — le composant en possède la durée de vie et le libérera automatiquement

Page is an advanced property useful when calling PDFium APIs that PDFiumPas has not yet wrapped — for example custom appearance stream regeneration, page-object bookkeeping, or low-level text-extraction tweaks. Most callers should prefer the high-level properties (PageWidth, PageHeight, RenderToBitmap, Annotation, etc.) which already manage the handle correctly.

Remarques

Exemple

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)]));

Voir aussi

Document, PageNumber, TextPage, FormHandle