Docs de PDFiumPas

Page Propiedad

Esta entrada API conserva identificadores, firmas, bloques de código y términos PDF en su forma original.
Componente: TPdf  ·  Unidad: PDFium
Native PDFium page handle for the currently active page.

Sintaxis

property Page: FPDF_PAGE; // solo lectura

Descripción

Page expone el handle bruto FPDF_PAGE de PDFium vinculado a la página actualmente activa. El handle se asigna cuando se establece PageNumber (o cuando Active pasa a True) y se mantiene vivo durante toda la vida de ese vínculo de página. Es el mismo handle que la API C de PDFium espera para todas las llamadas FPDFPage_*, FPDF_RenderPage*, de anotación, de flujo de contenido y de widget de formulario

El handle solo es válido mientras Active sea True y haya un PageNumber válido establecido. Asignar un nuevo PageNumber, llamar a ReloadPage o volver a poner Active en False destruye el handle existente y (en los dos primeros casos) crea uno nuevo. No llames a FPDF_ClosePage sobre este handle — el componente es dueño de su vida útil y lo desmontará automáticamente

Page es una propiedad avanzada útil al llamar a APIs de PDFium que PDFiumPas aún no ha envuelto — por ejemplo, regeneración personalizada de flujos de apariencia, contabilidad de objetos de página o ajustes de extracción de texto de bajo nivel. La mayoría de los llamadores deberían preferir las propiedades de alto nivel (PageWidth, PageHeight, RenderToBitmap, Annotation, etc.) que ya gestionan el handle correctamente

Notas

Ejemplo

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

Véase también

Document, PageNumber, TextPage, FormHandle