PDFium Delphi Component Docs

WebLink властивість

Component: TPdf  ·  Unit: PDFium
URL та обвідні прямокутники для автоматично виявленого веб-посилання на сторінці

Syntax

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

Description

WebLink повертає запис TWebLink для URL, виявленого за вказаним PageNumber (нумерація від одиниці) та Index (від нуля). Запис містить рядок Url (типово http://, https:// чи mailto:), масив Rectangles з обвідних прямокутників TPdfRectangle — по одному прямокутнику на візуальний рядок, бо PDFium звітує окремі прямокутники, коли один URL переноситься на кілька рядків — і діапазон символів текстової сторінки StartCharIndex і CharCount, покритий посиланням

Index лежить у діапазоні від 0 до WebLinkCount[PageNumber] - 1. Поза цим діапазоном PDFium повертає порожній запис (Url порожній, Rectangles дорівнює nil). Виявлення веб-посилань ліниво виконується при першому читанні для даної сторінки і кешується до перезавантаження сторінки; саме читання WebLink після завершення скана є O(1)

WebLink доповнює LinkAnnotation, який показує явні анотації /Link, оголошені автором PDF. Використовуйте прямокутники, щоб будувати click-through накладання на власному рендерері або підсвічувати URL у витягнутому тексті. Дані read-only — PDFium Delphi Component відкриває результати виявлення, а не примітиви модифікації. Щоб вставити справжні link-анотації, використайте шлях FPDFPage_CreateAnnot на базовому дескрипторі Page

Remarks

Example

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;

See Also

WebLinkCount, LinkAnnotation, TPdfView.OnWebLinkClick, TPdfView.LinkOptions