AddTextMarkupFromSearchHits

注释和热点链接

描述

Hits 中的每个矩形添加一个文本标记注释,将由 SearchTextSearchTextEachSearchTextBatchGetTextInAreaEx 返回的任意命中数组直接转换为标记注释,无需手动循环调用 AddTextMarkupAnnotation

对于每个命中项,若矩形的 Page 超出文档页面范围,或其 Right/Bottom 未超过 Left/Top,则跳过该矩形,每个保留的矩形都会在添加注释前暂时选择命中项所在页面,返回前始终恢复调用开始时所选的页面,即使命中项跨越多个页面也是如此

语法

Delphi

Function TPDFlib.AddTextMarkupFromSearchHits(MarkupType: Integer; Const Hits: Array Of TPDFlibSearchHit): Integer;

参数

MarkupType1 = 高亮,2 = 下划线,3 = 波浪线,4 = 删除线
Hits要转换为注释的搜索命中,通常由 SearchTextSearchTextEachSearchTextBatchGetTextInAreaEx 生成

返回值

实际创建的注释数。页码超出范围或矩形退化的命中会被跳过且不计数。当 MarkupType 不在 1–4 范围内、未选择文档或 Hits 为空时,将在不更改当前页面选择的情况下返回 0

备注

请改用 HighlightTextSearchHits 标记已经由活动 BeginTextSearch 会话保留的命中结果,搜索前设置 SearchContextChars,还可捕获每个命中结果周围的文本以便在标记前检查或记录

另请参阅

AddTextMarkupAnnotationHighlightTextSearchHitsSearchTextSearchTextEachSearchTextBatchTPDFlibSearchHit