PDFium Component Docs

Active プロパティ

この API エントリでは識別子、シグネチャ、コードブロック、PDF 用語を元の表記のまま保持します。
コンポーネント: TPdf  ·  ユニット: PDFium
選択中の PDF 文書を開くか閉じます

構文

property Active: Boolean; // default False

説明

ActiveTrue にすると、FileName で指定された PDF 文書を開いて読み込みます。文書が暗号化されている場合は Password を使います。False にすると文書は閉じられ、関連する PDFium リソース (ページ、font、form handle、text page) はすべて解放されます

この property を切り替える代わりに、LoadDocument を直接呼び出すこともできます。すでに ActiveTrue の状態で FileName を代入すると、新しい path から文書が自動的に再読み込みされます。単一の TPdf instance で PDF を切り替えるときはこれが推奨方法です

ファイルを開けない場合 (path の誤り、password の不一致、PDF の破損、未対応の XFA-only form など) は EPdfError exception が送出されます。安全に処理するには代入を try/except で囲み、E.Message で PDFium の error description を確認してください

備考

Pdf1.FileName := 'C:\docs\report.pdf';
Pdf1.Password := ''; // leave empty if not encrypted
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