PDFium Delphi Component Docs

WebLink Propiedad

Componente: TPdf  ·  Unidad: PDFium
URL y rectángulos delimitadores de un enlace web detectado automáticamente en una página

Syntax

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

Description

WebLink devuelve un registro TWebLink para la URL detectada en el PageNumber especificado, basado en uno, y en el Index basado en cero. El registro contiene la cadena Url (normalmente http://, https:// o mailto:), una matriz Rectangles de cajas delimitadoras TPdfRectangle — un rectángulo por línea visual, ya que PDFium informa de rectángulos separados cuando una sola URL se divide en varias líneas — y el rango de caracteres de la página de texto StartCharIndex y CharCount cubierto por el enlace

Index va de 0 a WebLinkCount[PageNumber] - 1 Fuera de ese rango PDFium devuelve un registro vacío (Url vacía, Rectangles nil). La detección de enlaces web se ejecuta de forma perezosa en la primera lectura de una página determinada y se almacena en caché hasta que la página se recarga; la lectura de WebLink en sí es O(1) una vez completado el barrido

WebLink complementa a LinkAnnotation, que expone las anotaciones /Link explícitas declaradas por el autor del PDF. Use los rectángulos para construir superposiciones de clic en un renderizador personalizado, o para resaltar URL en el texto extraído. Los datos son de solo lectura — PDFium Delphi Component expone los resultados de la detección, no primitivas de modificación. Para insertar anotaciones de enlace reales, use la ruta FPDFPage_CreateAnnot sobre el manejador Page subyacente

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