PDFium Component Docs

WebLinkCount Eigenschaft

Dieser API-Eintrag behält Bezeichner, Signaturen, Codeblöcke und PDF-Begriffe in ihrer Originalform.
Komponente: TPdf  ·  Unit: PDFium
Anzahl automatisch erkannter Web-URLs, die durch das Scannen des Seitentexts identifiziert wurden

Syntax

property WebLinkCount[PageNumber: Integer]: Integer; // read only

Beschreibung

WebLinkCount meldet die Anzahl der URL-Muster, die PDFium auf der durch das 1-basige PageNumber-Argument bezeichneten Seite durch Scannen der gerenderten Textseite gefunden hat. Anders als LinkAnnotationCount — das die vom PDF-Autor explizit deklarierten /Link-Anmerkungen zählt — zeigt WebLinkCount URLs an, die als Klartext erscheinen (etwa https://example.com), aber nicht in eine klickbare Anmerkung eingepasst wurden. PDFium verwendet Mustererkennung (FPDFLink_LoadWebLinks auf einer FPDF_TEXTPAGE), um http, https, mailto: und einige weitere gängige URI-Schemata zu entdecken

Der Wert ist 0, wenn Active False ist oder wenn kein URL-Muster gefunden wird. Übergeben Sie PageNumber im Bereich 1 .. PageCount. WebLinkCount treibt die von TPdfView.OnWebLinkClick und der Option loAutoOpenURI verwendete Auto-Erkennungsschicht an — beide verlassen sich auf dieselben Scan-Ergebnisse

Verwenden Sie WebLink[PageNumber, Index], um einen TWebLink-Record abzurufen (die URL-Zeichenkette plus ein Array von TPdfRectangle-Begrenzungsboxen, eine pro Zeile, da eine einzelne URL umbrechen kann). Scans werden pro Seite bis zum erneuten Laden der Seite gecacht, daher sind wiederholte Lesezugriffe auf WebLinkCount günstig; die erste Abfrage für eine gegebene Seite führt den eigentlichen Scan aus

Hinweise

Beispiel

var P, I: Integer;
var Link: TWebLink;
for P := 1 to Pdf1.PageCount do
  for I := 0 to Pdf1.WebLinkCount[P] - 1 do
  begin
    Link := Pdf1.WebLink[P, I];
    Memo1.Lines.Add(Link.Url);
  end;

Siehe auch

WebLink, LinkAnnotationCount, TPdfView.OnWebLinkClick, TPdfView.LinkOptions