PDFiumPas 文件

Page 屬性

此 API 條目保留識別符號、簽名、程式碼塊和 PDF 術語的原始形式。
元件: TPdf  ·  單元: PDFium
目前作用中頁面的原生 PDFium 頁面控制代碼

語法

property Page: FPDF_PAGE; // read only

說明

Page 會暴露綁定到目前作用中頁面的原生 PDFium FPDF_PAGE 控制代碼。當 PageNumber 被設定時(或當 Active 轉為 True 時),這個控制代碼就會配置出來,並在該頁面綁定的生命週期內持續有效。它也是 PDFium 的 C API 對每個 FPDFPage_*FPDF_RenderPage*、註解、內容串流與表單元件呼叫所預期的同一個控制代碼

這個控制代碼只有在 ActiveTrue 且已設定有效的 PageNumber 時才有效。重新指定 PageNumber、呼叫 ReloadPage,或將 Active 改回 False,都會銷毀現有的控制代碼,並且在前兩種情況下建立新的控制代碼。不要 對這個控制代碼呼叫 FPDF_ClosePage — 元件會負責它的生命週期,並自動將其關閉

Page 是一個進階屬性,適合在呼叫 PDFiumPas 尚未包裝的 PDFium API 時使用,例如自訂外觀串流重建、頁面物件記帳,或低階文字擷取調整。大多數呼叫端應優先使用高階屬性(PageWidthPageHeightRenderToBitmapAnnotation 等),因為它們已經會正確管理這個控制代碼

備註

範例

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

另請參閱

Document, PageNumber, TextPage, FormHandle