ActivateWebLinks

Anotaciones, enlaces de zona activa, y extracción de texto

Descripción

Detecta direcciones web y de correo electrónico en texto de página 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áginas, como 1,3,5-8; un valor vacío selecciona todas las páginas

Valores devueltos

Devuelve el número de anotaciones de enlace nuevas creadas

Observaciones

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

Cada página se extrae una vez, los rectángulos se obtienen de los avances coincidentes y el texto inclinado recibe /QuadPoints si la conformidad permite PDF 1.6

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

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

PDF etiquetados y PDF/UA no cambian, pues añadir una anotación sin actualizar la estructura rompería conformidad; devuelve 0 y LastErrorCode = PDFLIB_ERROR_TAGGED_LINK_STRUCTURE

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

Véase también

ActivateWebLinksEx, AddLinkToWeb, SetAutoCreateWebLinks