PDFiumPas 文件

Active 屬性

此 API 條目保留識別符號、簽名、程式碼塊和 PDF 術語的原始形式
元件: TPdf  ·  單元: PDFium
開啟或關閉選取的 PDF 文件

語法

property Active: Boolean; // default False

說明

Active 設為 True 會開啟並載入由 FileName 指定的 PDF 文件,若文件已加密則會使用 Password。設為 False 時,文件會關閉,且所有相關的 PDFium 資源(頁面、字型、表單控制代碼、文字頁面)都會釋放

您也可以直接呼叫 LoadDocument,而不必切換這個屬性。當 Active 已經是 True 時再指定 FileName,會自動從新路徑重新載入文件,這是在單一 TPdf 執行個體中切換不同 PDF 的建議方式

如果檔案無法開啟(路徑錯誤、密碼錯誤、PDF 損毀,或不支援僅 XFA 的表單),就會拋出 EPdfError 例外。請將指定動作包在 try/except 區塊中以便妥善處理錯誤,並檢查 E.Message 以取得 PDFium 的錯誤描述

備註

範例

Pdf1.FileName := 'C:\docs\report.pdf';
Pdf1.Password := ''; // 若未加密則留空
try
  Pdf1.Active := True;
  ShowMessage('Pages: ' + IntToStr(Pdf1.PageCount));
except
  on E: EPdfError do
    ShowMessage('Cannot open: ' + E.Message);
end;

另請參閱

FileName, Password, LoadDocument, PageCount, LoadLibrary, CreateDocument