PDFium Delphi Component Docs

WebLink egenskap

Component: TPdf  ·  Unit: PDFium
URL och begränsande rektanglar för en automatiskt upptäckt weblänk på en sida

Syntax

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

Description

WebLink returnerar en TWebLink-post för den URL som upptäckts vid angivet ettbaserade PageNumber och nollbaserade Index. Posten innehåller strängen Url (typiskt http://, https:// eller mailto:), en Rectangles-array med TPdfRectangle-omslutningsrutor — en rektangel per visuell rad, eftersom PDFium rapporterar separata rektanglar när en enda URL radbryts över flera rader — samt textsidans teckenintervall StartCharIndex och CharCount som länken täcker

Index går från 0 till WebLinkCount[PageNumber] - 1 Utanför det intervallet returnerar PDFium en tom post (Url är tom, Rectangles är nil). Upptäckt av weblänkar körs lat vid första läsningen för en given sida och cachas tills sidan läses in igen; själva läsningen av WebLink är O(1) när skanningen är klar

WebLink kompletterar LinkAnnotation, som exponerar explicita /Link-annoteringar som PDF-författaren deklarerat. Använd rektanglarna för att bygga klickbara överlägg i en egen renderer, eller för att lyfta fram URL:er i extraherad text. Data är skrivskyddad — PDFium Delphi Component exponerar upptäcktsresultat, inte primitiver för ändring. För att infoga riktiga länkannoteringar, använd FPDFPage_CreateAnnot-vägen på det underliggande Page-handtaget

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