PDFium Delphi Component Docs

Свойство WebLink

Компонент: TPdf  ·  Модул: PDFium
URL и ограничаващи правоъгълници за автоматично разпознат уеб линк на страница

Синтаксис

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

Описание

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

Index варира от 0 до WebLinkCount[PageNumber] - 1 Извън този диапазон PDFium връща празен запис (Url е празен, Rectangles е nil). Разпознаването на уеб линкове се изпълнява lazy при първото четене за дадена страница и се кешира, докато страницата не бъде презаредена; самото четене на WebLink е O(1) след завършване на сканирането

WebLink допълва LinkAnnotation, която разкрива изричните анотации /Link, декларирани от автора на PDF. Използвайте правоъгълниците, за да изградите click-through слоеве върху персонален рендер, или да маркирате URL адреси в извлечения текст. Данните са само за четене — PDFium Delphi Component разкрива резултати от разпознаване, а не примитиви за модификация. За да вмъкнете истински link анотации, използвайте пътя FPDFPage_CreateAnnot върху базовия handle Page

Забележки

Пример

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