ActivateWebLinks

注释、热点链接和文本提取

描述

检测现有页面文本中的 Web 地址和电子邮件地址,并创建带 URI 操作的非重复 Link 注释

语法

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

参数

PageRange页码和范围,例如 1,3,5-8;空值会选择所有页面

返回值

返回新建链接注释的数量

备注

默认检测器识别 http://、https://、www.、ftp://、mailto: 和裸电子邮件地址;www. 目标会获得 https:// 方案,裸地址会获得 mailto: 方案

每页仅提取一次,链接矩形从匹配字符前移量推导,非轴对齐文本会在活动 PDF 一致性允许 PDF 1.6 功能时获得 /QuadPoints

保留具有相同规范目标且矩形区域大幅重叠的现有 URI 链接,使重复调用具有幂等性

检测使用 ASCII URI 语法;调用此方法前,请使用 Punycode 或百分号编码对非 ASCII 主机名和路径进行编码

带标签的 PDF 和 PDF/UA 文档保持不变,因为插入注释而不更新其结构树关联会破坏一致性,该方法返回 0,并将 LastErrorCode 设置为 PDFLIB_ERROR_TAGGED_LINK_STRUCTURE

该方法按页报告进度,遵循取消操作,并恢复所选页面

另请参阅

ActivateWebLinksEx、AddLinkToWeb、SetAutoCreateWebLinks