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 的錯誤描述
Active 第一次變成 True 時,PDFium 執行階段 DLL 會在需要時載入 — 若要從自訂路徑預先載入,請參考 LoadLibraryPdfView1.Pdf := Pdf1;再指定 Pdf1.Active := True 以開啟文件並呈現第一頁Active := False)會讓先前從索引屬性(Annotation、Bookmark、FormFieldInfo 等)取得的每個 record 失效 — 請不要在開啟/關閉循環之間保留它們
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;