ActivateWebLinks
Anotações, links de zona ativa e extração de texto
Descrição
Detecta endereços de web e e-mail no texto existente da página e cria anotações Link sem duplicatas, com ações URI
Sintaxe
Function TPDFlib.ActivateWebLinks(Const PageRange: WideString): Integer;Parâmetros
| PageRange | Números e intervalos de páginas, como 1,3,5-8; um valor vazio seleciona todas as páginas |
|---|
Valores retornados
Retorna o número de novas anotações de link criadas
Observações
O detector padrão reconhece http://, https://, www., ftp://, mailto: e endereços de e-mail soltos; alvos www. ganham um scheme https:// e endereços soltos ganham um scheme mailto:
Cada página é extraída uma única vez, os retângulos dos links são derivados dos avanços de caracteres correspondidos, e texto fora do alinhamento aos eixos recebe /QuadPoints quando a conformidade PDF ativa permite recursos do PDF 1.6
Um link URI existente com o mesmo destino canônico e um retângulo substancialmente sobreposto é mantido, tornando chamadas repetidas idempotentes
A detecção usa sintaxe ASCII de URI; codifique nomes de host e caminhos não ASCII com Punycode ou percent encoding antes de chamar este método
Tagged PDF and PDF/UA documents are left unchanged because inserting an annotation without updating its structure-tree association would break conformance; the method returns 0 and sets LastErrorCode to PDFLIB_ERROR_TAGGED_LINK_STRUCTURE
O método informa o progresso por página, respeita o cancelamento e restaura a página selecionada