ActivateWebLinks
Anotace, hotspotové odkazy a extrakce textu
Popis
Detekuje webové adresy a e-mailové adresy v existujícím textu stránek a vytváří neduplicitní anotace Link s akcemi URI
Syntaxe
Function TPDFlib.ActivateWebLinks(Const PageRange: WideString): Integer;Parametry
| PageRange | Čísla a rozsahy stránek, jako je 1,3,5-8; prázdná hodnota vybere všechny stránky |
|---|
Návratové hodnoty
Vrací počet nově vytvořených odkazových anotací
Poznámky
Výchozí detektor poznává http://, https://, www., ftp://, mailto: i holé e-mailové adresy; cíle www. dostanou schéma https:// a holé adresy schéma mailto:
Každá stránka se extrahuje jednou, obdélníky odkazů se odvozí z posunů odpovídajících znaků a text nezarovnaný k osám dostane /QuadPoints, pokud aktivní PDF shoda dovoluje funkce PDF 1.6
Existující URI odkaz se stejným kanonickým cílem a podstatně se překrývajícím obdélníkem se zachová, takže opakovaná volání jsou idempotentní
Detekce používá syntaxi URI v ASCII; před voláním této metody kódujte neascii názvy hostitelů a cesty pomocí Punycode nebo percent encoding
Tagované PDF a dokumenty PDF/UA zůstanou beze změny, protože vložení anotace bez aktualizace její asociace se strukturním stromem by porušilo shodu; metoda vrátí 0 a nastaví LastErrorCode na PDFLIB_ERROR_TAGGED_LINK_STRUCTURE
Metoda hlásí průběh po stránkách, respektuje zrušení a obnoví vybranou stránku