PDFium Component Docs

Page-egenskap

Komponent: TPdf  ·  Enhet: PDFium
Inbyggt PDFium-sidhandtag för den för närvarande aktiva sidan

Syntax

property Page: FPDF_PAGE; // read only

Beskrivning

Page exponerar det råa PDFium-FPDF_PAGE-handtaget som är bundet till den aktuellt aktiva sidan. Handtaget allokeras när PageNumber sätts (eller när Active övergår till True) och hålls vid liv under hela den sidbindningens livslängd. Det är samma handtag som PDFiums C API förväntar sig för varje anrop till FPDFPage_*, FPDF_RenderPage*, annoteringar, innehållsströmmar och formulärwidgetar

Handtaget är giltigt bara medan Active är True och ett giltigt PageNumber är satt. Att tilldela ett nytt PageNumber, anropa ReloadPage eller sätta Active tillbaka till False förstör det befintliga handtaget och skapar i de två första fallen ett nytt. Anropa inte FPDF_ClosePage på detta handtag — komponenten äger dess livslängd och städar bort det automatiskt

Page är en avancerad egenskap som är användbar när du anropar PDFium-API:er som PDFiumPas ännu inte har kapslat in — till exempel regenerering av anpassade appearance streams, bokföring av page-objects eller lågnivåjusteringar av textutvinning. De flesta anropare bör föredra de högre egenskaperna (PageWidth, PageHeight, RenderToBitmap, Annotation med flera) som redan hanterar handtaget korrekt

Anmärkningar

Exempel

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

Se även

Document, PageNumber, TextPage, FormHandle