AddTextMarkupFromSearchHits
注释和热点链接
描述
在 Hits 中的每个矩形添加一个文本标记注释,将由 SearchText、SearchTextEach、SearchTextBatch 或 GetTextInAreaEx 返回的任意命中数组直接转换为标记注释,无需手动循环调用 AddTextMarkupAnnotation
对于每个命中项,若矩形的 Page 超出文档页面范围,或其 Right/Bottom 未超过 Left/Top,则跳过该矩形,每个保留的矩形都会在添加注释前暂时选择命中项所在页面,返回前始终恢复调用开始时所选的页面,即使命中项跨越多个页面也是如此
语法
Delphi
Function TPDFlib.AddTextMarkupFromSearchHits(MarkupType: Integer; Const Hits: Array Of TPDFlibSearchHit): Integer;参数
| MarkupType | 1 = 高亮,2 = 下划线,3 = 波浪线,4 = 删除线 |
|---|---|
| Hits | 要转换为注释的搜索命中,通常由 SearchText、SearchTextEach、SearchTextBatch 或 GetTextInAreaEx 生成 |
返回值
实际创建的注释数。页码超出范围或矩形退化的命中会被跳过且不计数。当 MarkupType 不在 1–4 范围内、未选择文档或 Hits 为空时,将在不更改当前页面选择的情况下返回 0
备注
请改用 HighlightTextSearchHits 标记已经由活动 BeginTextSearch 会话保留的命中结果,搜索前设置 SearchContextChars,还可捕获每个命中结果周围的文本以便在标记前检查或记录
另请参阅
AddTextMarkupAnnotation,HighlightTextSearchHits,SearchText,SearchTextEach,SearchTextBatch,TPDFlibSearchHit