PDFium Component Docs

WebLink eigenschap

Component: TPdf  ·  Unit: PDFium
URL en begrenzingsrechthoeken voor een automatisch gedetecteerde webkoppeling op een pagina

Syntax

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

Description

WebLink retourneert een TWebLink-record voor de URL die op de opgegeven PageNumber (1-based) en Index (0-based) is gedetecteerd. Het record bevat de Url-string (doorgaans http://, https:// of mailto:), een Rectangles-array met TPdfRectangle-begrenzingskaders — één rechthoek per visuele regel, want PDFium rapporteert afzonderlijke rechthoeken zodra één URL over meerdere regels doorloopt — en met StartCharIndex en CharCount het tekenbereik op de tekstpagina dat de koppeling bestrijkt

Index loopt van 0 tot WebLinkCount[PageNumber] - 1. Buiten dat bereik geeft PDFium een leeg record terug (Url is leeg, Rectangles is nil). De webkoppelingdetectie start pas bij de eerste lezing van een pagina en wordt gecachet tot de pagina opnieuw wordt geladen; WebLink zelf lezen is O(1) zodra de scan klaar is

WebLink vult LinkAnnotation aan, waarmee de expliciete /Link-annotaties zichtbaar worden die de PDF-auteur heeft gedeclareerd. Gebruik de rechthoeken om click-through-overlays op een eigen renderer te bouwen of om URL's in geëxtraheerde tekst te markeren. De gegevens zijn read-only — PDFium Delphi Component stelt detectieresultaten beschikbaar, geen wijzigingsprimitieven. Om echte linkannotaties in te voegen gebruikt u het FPDFPage_CreateAnnot-pad op de onderliggende Page-handle

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