ActivateWebLinks

Anotaciones, enlaces de zonas activas y extracción de texto

Descripción

Detecta direcciones web y de correo electrónico en texto de páginas existente y crea anotaciones Link no duplicadas con acciones URI

Sintaxis

Function TPDFlib.ActivateWebLinks(Const PageRange: WideString): Integer;

Parámetros

PageRangeNúmeros e intervalos de página como 1,3,5-8; un valor vacío selecciona todas las páginas

Valores devueltos

Devuelve el número de nuevas anotaciones de enlace creadas

Observaciones

El detector predeterminado reconoce http://, https://, www., ftp://, mailto: y direcciones de correo sin prefijo; los destinos www. reciben un esquema https:// y las direcciones sin prefijo reciben un esquema mailto:

Cada página se extrae una vez, los rectángulos de enlace se derivan de los avances de caracteres coincidentes y el texto no alineado con los ejes recibe /QuadPoints cuando la conformidad PDF activa permite funciones de PDF 1.6

Se conserva un enlace URI existente con el mismo destino canónico y un rectángulo que se superpone sustancialmente, lo que hace que las llamadas repetidas sean idempotentes

La detección usa sintaxis URI ASCII; codifique los nombres de host y las rutas no ASCII con Punycode o codificación porcentual antes de llamar a este método

Los documentos PDF etiquetados y PDF/UA se dejan sin cambios porque insertar una anotación sin actualizar su asociación con el árbol de estructura rompería la conformidad; el método devuelve 0 y establece LastErrorCode en PDFLIB_ERROR_TAGGED_LINK_STRUCTURE

El método informa el progreso por página, respeta la cancelación y restaura la página seleccionada

Véase también

ActivateWebLinksEx, AddLinkToWeb, SetAutoCreateWebLinks