PDFium Delphi Component Docs

WebLink プロパティ

コンポーネント: TPdf  ·  ユニット: PDFium
ページ上で自動検出されたウェブリンクの URL と外接矩形です

構文

property WebLink[PageNumber, Index: Integer]: TWebLink; // read only

説明

WebLink は、指定した 1 起点の PageNumber と 0 起点の Index で検出された URL に対応する TWebLink レコードを返します。レコードには Url 文字列 (通常は http://、https://、または mailto:)、TPdfRectangle 外接ボックスの Rectangles 配列 — 1 つの URL が複数行に折り返すと PDFium が行ごとの矩形を報告するため、視覚的な 1 行につき 1 つの矩形になります —、およびリンクがカバーする StartCharIndex と CharCount のテキストページ文字範囲が含まれます

Index は 0 から WebLinkCount[PageNumber] - 1 までの範囲です。範囲外では PDFium は空のレコードを返します (Url が空、Rectangles が nil)。ウェブリンクの検出は、ページに対する最初の読み取りで遅延実行され、ページが再読み込みされるまでキャッシュされます。走査が完了した後の WebLink の読み取り自体は O(1) です

WebLink は、PDF 作成者が宣言した明示的な /Link 注釈を取り上げる LinkAnnotation を補完します。矩形は、カスタムレンダラー上でクリックスルーのオーバーレイを作ったり、抽出したテキスト内の URL をハイライトしたりするのに使えます。データは読み取り専用 — PDFium Delphi Component が公開するのは検出結果であり、変更プリミティブではありません。実際のリンク注釈を挿入するには、基盤の Page ハンドルに対する FPDFPage_CreateAnnot の経路を使用します

備考

例

var Link: TWebLink;
var I: Integer;
for I := 0 to Pdf1.WebLinkCount[1] - 1 do
begin
  Link := Pdf1.WebLink[1, I];
  Memo1.Lines.Add(Format('%s  (%d rects)',
    [Link.Url, Length(Link.Rectangles)]));
end;

関連項目

WebLinkCount, LinkAnnotation, TPdfView.OnWebLinkClick, TPdfView.LinkOptions