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
该方法按页报告进度,遵循取消操作,并恢复所选页面