ActivateWebLinks
Annotazioni, collegamenti hotspot, estrazione del testo
Descrizione
Rileva indirizzi Web e indirizzi e-mail nel testo esistente della pagina e crea annotazioni Link non duplicate con azioni URI
Sintassi
Function TPDFlib.ActivateWebLinks(Const PageRange: WideString): Integer;Parametri
| PageRange | Numeri e intervalli di pagina come 1,3,5-8; un valore vuoto seleziona tutte le pagine |
|---|
Valori restituiti
Restituisce il numero di nuove annotazioni collegamento create
Note
Il rilevatore riconosce http://, https://, www., ftp://, mailto: e indirizzi email; ai target www. aggiunge https:// e agli indirizzi mailto:
Ogni pagina viene estratta una volta, i rettangoli dei collegamenti derivano dagli avanzamenti dei caratteri trovati e il testo non allineato agli assi riceve /QuadPoints quando la conformità PDF attiva consente funzionalità PDF 1.6
Un collegamento URI esistente con la stessa destinazione canonica e un rettangolo sostanzialmente sovrapposto viene conservato, rendendo idempotenti le chiamate ripetute
Il rilevamento usa la sintassi URI ASCII; codificare i nomi host e i percorsi non ASCII con Punycode o codifica percentuale prima di chiamare questo metodo
I documenti PDF con tag e PDF/UA restano invariati perché l'inserimento di un'annotazione senza aggiornare la relativa associazione nell'albero della struttura comprometterebbe la conformità; il metodo restituisce 0 e imposta LastErrorCode su PDFLIB_ERROR_TAGGED_LINK_STRUCTURE
Il metodo segnala l'avanzamento per pagina, rispetta l'annullamento e ripristina la pagina selezionata