AddTextMarkupFromSearchHits

Anotações e ligações de áreas interativas

Descrição

Adiciona uma anotação de marcação de texto por retângulo em Hits, transformando diretamente em anotações de marcação qualquer matriz de ocorrências devolvida por SearchText, SearchTextEach, SearchTextBatch ou GetTextInAreaEx, sem um ciclo manual sobre AddTextMarkupAnnotation

Para cada resultado, é ignorado um retângulo cujo Page esteja fora do intervalo de páginas do documento ou cujo Right/Bottom não exceda Left/Top. Cada retângulo restante seleciona temporariamente a página do resultado antes de adicionar a anotação; a página que estava selecionada no início da chamada é sempre restaurada antes da devolução, mesmo para resultados que abranjam várias páginas

Sintaxe

Delphi

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

Parâmetros

Valores devolvidos

O número de anotações efetivamente criadas. As ocorrências cuja página esteja fora do intervalo ou cujo retângulo seja degenerado são ignoradas e não entram na contagem. Devolve 0 sem alterar a seleção de página atual quando MarkupType está fora do intervalo 1–4, não está selecionado nenhum documento ou Hits está vazio

Observações

Utilize antes HighlightTextSearchHits quando as ocorrências a marcar forem as já retidas por uma sessão BeginTextSearch ativa. Defina SearchContextChars antes da pesquisa para também capturar o texto circundante de cada ocorrência, para inspeção ou registo, antes de a marcar

Consulte também

AddTextMarkupAnnotation, HighlightTextSearchHits, SearchText, SearchTextEach, SearchTextBatch, TPDFlibSearchHit