WebLink - TPdf - PDFiumPas

Ten wpis API zachowuje identyfikatory, sygnatury, bloki kodu i terminy PDF w oryginalnej postaci.

Komponent: TPdf · Moduł: PDFium

Adres URL i prostokąty ograniczające dla automatycznie wykrytego łącza internetowego na stronie

Składnia

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

Opis

WebLink zwraca rekord TWebLink dla adresu URL wykrytego pod podanym 1-based PageNumber i 0-based Index. Rekord zawiera ciąg Url (zwykle http://, https:// albo mailto:) oraz tablicę Rectangles z prostokątami ograniczającymi TPdfRectangle — jeden prostokąt na każdą linię wizualną, ponieważ PDFium zwraca osobne prostokąty, gdy pojedynczy URL zawija się na wiele wierszy

Indeks mieści się w zakresie od 0 do WebLinkCount[PageNumber] - 1 Poza tym zakresem PDFium zwraca pusty rekord (Url jest pusty, Rectangles ma wartość nil). Wykrywanie łączy internetowych działa leniwie przy pierwszym odczycie dla danej strony i jest buforowane do momentu ponownego wczytania strony; sam odczyt WebLink ma złożoność O(1) po zakończeniu skanu

WebLink uzupełnia LinkAnnotation, które pokazuje jawne adnotacje /Link zadeklarowane przez autora PDF. Użyj prostokątów, aby budować nakładki klikalne w niestandardowym rendererze albo wyróżniać URL-e w wyodrębnionym tekście. Dane są tylko do odczytu — PDFiumPas udostępnia wyniki wykrywania, a nie mechanizmy modyfikacji. Aby wstawić prawdziwe adnotacje łączy, użyj ścieżki FPDFPage_CreateAnnot na bazowym uchwycie Page

Uwagi

Współrzędne prostokątów są w przestrzeni użytkownika PDF — przekształć je przez TPdfView.PageToScreen, aby nałożyć HTML lub inne widżety
Wykrywane są wyłącznie URL-e oparte na tekście. Obrazy, które wizualnie pokazują URL, nie zostaną zarejestrowane, chyba że ich tekst źródłowy został OCR-owany do strony
Aby uzyskać ujednolicone przetwarzanie kliknięć (adnotacje + automatycznie wykryte URL-e), podłącz zarówno TPdfView.OnAnnotationLinkClick, jak i TPdfView.OnWebLinkClick

Przykład

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;

Zobacz też

WebLinkCount, LinkAnnotation, TPdfView.OnWebLinkClick, TPdfView.LinkOptions