WebLink - TPdf - PDFiumPas

Dieser API-Eintrag behält Bezeichner, Signaturen, Codeblöcke und PDF-Begriffe in ihrer Originalform.

Komponente: TPdf · Unit: PDFium

URL und Begrenzungsrechtecke für einen automatisch erkannten Weblink auf einer Seite

Syntax

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

Beschreibung

WebLink gibt einen TWebLink-Record für die URL zurück, die an der angegebenen, 1-basierten PageNumber und dem 0-basierten Index erkannt wurde. Der Record enthält die Zeichenkette Url (typischerweise http://, https:// oder mailto:) sowie ein Rectangles-Array mit Begrenzungsboxen vom Typ TPdfRectangle — ein Rechteck pro sichtbarer Zeile, da PDFium getrennte Rechtecke meldet, wenn eine einzelne URL über mehrere Zeilen umbricht

Der Index reicht von 0 bis WebLinkCount[PageNumber] - 1 Außerhalb dieses Bereichs gibt PDFium einen leeren Record zurück (Url ist leer, Rectangles ist nil). Die Weblink-Erkennung läuft bei der ersten Abfrage für eine gegebene Seite verzögert an und wird bis zum erneuten Laden der Seite gecacht; das Lesen von WebLink selbst ist nach Abschluss des Scans O(1)

WebLink ergänzt LinkAnnotation, das die vom PDF-Autor explizit deklarierten /Link-Anmerkungen liefert. Verwenden Sie die Rechtecke, um in einem eigenen Renderer Click-through-Overlays aufzubauen oder URLs im extrahierten Text zu markieren. Die Daten sind schreibgeschützt — PDFiumPas stellt Erkennungsergebnisse bereit, keine Änderungsprimitive. Um echte Link-Anmerkungen einzufügen, verwenden Sie den FPDFPage_CreateAnnot-Pfad am zugrunde liegenden Page-Handle

Hinweise

Die Rechteckkoordinaten liegen im PDF-User-Space vor — transformieren Sie sie über TPdfView.PageToScreen, wenn Sie HTML oder andere Widgets darüberlegen
Es werden nur textbasierte URLs erkannt. Bilder, die optisch eine URL darstellen, werden nicht registriert, solange ihr zugrunde liegender Text nicht per OCR in die Seite übernommen wurde
Für ein einheitliches Klickverhalten (Anmerkungen + automatisch erkannte URLs) verdrahten Sie sowohl TPdfView.OnAnnotationLinkClick als auch TPdfView.OnWebLinkClick

Beispiel

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;

Siehe auch

WebLinkCount, LinkAnnotation, TPdfView.OnWebLinkClick, TPdfView.LinkOptions