PDFium Delphi Component Docs

TextPage プロパティ

コンポーネント: TPdf  ·  ユニット: PDFium
現在アクティブなページのネイティブ PDFium テキストページハンドル

Syntax

property TextPage: FPDF_TEXTPAGE; // read only

Description

TextPage は現在読み込まれたページに対応する生の PDFium FPDF_TEXTPAGE ハンドルを公開します。ハンドルはページがアクティブになったとき遅延作成され、そのページバインディングの生存期間中維持されます。上位の TPdf プロパティで表面化されていない操作を必要とする呼び出し側のために、PDFium のテキスト抽出 API(FPDFText_*)への直接アクセスを提供します。例えばグリフレベルのテキストラン、カーニングデータ、カスタム検索意味論、生の文字インデックスから境界ボックスへのマッピングです

ハンドルは Active が True で有効なページが選択されている間のみ有効です。ページの切り替え(新しい PageNumber の代入や ReloadPage の呼び出し)は前のハンドルを破棄して新しいものを作成するため、ページ変更をまたいでハンドルを保存しないでください。コンポーネントがハンドルを所有し、ページ解体中に解放します — 自分で FPDFText_ClosePage を呼び出さないでください

これは高度なプロパティです。ほとんどの呼び出し側は高レベルラッパー CharacterCount、Character[I]、CharacterRectangle[I]、Find / FindNext を優先するべきです。これらはすでに FPDF_TEXTPAGE ライフサイクルを内部で管理します。PDFium Delphi Component がまだ表面化していない PDFium API が必要な場合にのみ生ハンドルへ落とし込みます

Remarks

Example

var TP: FPDF_TEXTPAGE;
TP := Pdf1.TextPage;
if Assigned(TP) then
  ShowMessage(Format('PDFium reports %d chars',
    [FPDFText_CountChars(TP)]));

See Also

CharacterCount, Character, Page, Find