PDFium Delphi Component Docs

Active プロパティ

コンポーネント: TPdfView  ·  ユニット: PDFium
ビューアーをアクティブ化または非アクティブ化し、バインドされた PDF 文書を開いて選択ページをレンダリングします

Syntax

property Active: Boolean; // default False

Description

Active に True を設定すると、ビューアーは関連付けられた Pdf コンポーネントが参照するドキュメントをロードし、PageNumber が示すページを開いて再描画を起こします。False を設定するとページを閉じ、キャッシュ済みのテキストページハンドルを解放し、検索セッションを破棄し、表示領域をクリアします

Active はビューアーのマスタースイッチです。PageCount、PageWidth、PageLabel といったドキュメント系プロパティや、インデックス付きアクセサー(Character、Bitmap、WebLink など)が意味のある値を返すのは、Active が True でリンク先の Pdf インスタンスにドキュメントがロードされている間だけです

Pdf が nil の場合、ビューアーは Active が最初に True にされた時点で内部の TPdf インスタンスを生成して所有します。最小限のプログラムなら、ファイルを指したあと PdfView1.Pdf.FileName := ...; PdfView1.Active := True; を呼ぶだけで動きます

Remarks

Example

// Bind to an explicit TPdf and open a file.
PdfView1.Pdf := Pdf1;
Pdf1.FileName := 'C:\docs\sample.pdf';
PdfView1.Active := True;

// React to open/close in code.
if PdfView1.Active then
  StatusBar1.SimpleText := Format('%d pages', [PdfView1.PageCount])
else
  StatusBar1.SimpleText := 'No document loaded';

// Close the viewer.
PdfView1.Active := False;

See Also

Pdf, PageNumber, PageCount, ReloadPage, TPdf.Active