PDFium Delphi Component 文件

Active 屬性

元件: TPdf  ·  單元: PDFium
開啟或關閉選取的 PDF 文件

Syntax

property Active: Boolean; // default False

Description

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

您也可以直接呼叫 LoadDocument,而不必切換此屬性;它在失敗時會引發 EPdfError。FileName 與 Password 只能在元件非作用中時指派,因此在單一 TPdf 實體中切換文件的做法是:先把 Active 設為 False,指派新路徑,再將 Active 設回 True

將 Active 設為 True 後若檔案無法開啟(路徑錯誤、密碼錯誤、PDF 損毀,或不支援的純 XFA 表單),並不會引發例外:元件只是保持非作用中。指派之後檢查 Active,並讀取 LastLoadReport,其 Status 為 plsFailed,ErrorMessage 則描述失敗原因

Remarks

Example

Pdf1.FileName := 'C:\docs\report.pdf';
Pdf1.Password := ''; // leave empty if not encrypted
Pdf1.Active := True;
if Pdf1.Active then
  ShowMessage('Pages: ' + IntToStr(Pdf1.PageCount))
else
  ShowMessage('Cannot open: ' + Pdf1.LastLoadReport.ErrorMessage);

See Also

FileName, Password, LoadDocument, PageCount, LoadLibrary, CreateDocument