SearchText

Texto, extração

Descrição

Pesquisa blocos de texto no intervalo de páginas solicitado e copia as ocorrências para a matriz fornecida pelo chamador, devolvendo o número total de correspondências mesmo quando a matriz é mais pequena

O método comunica o progresso das páginas através de OnProgress, respeita Abort entre páginas e blocos e repõe a página que estava selecionada antes da pesquisa

Desde v3.430.0, TPDFlibSearchOption também aceita soDiacriticInsensitive (dobragem Unicode 1:1 para que letras simples correspondam a equivalentes latinos, gregos e cirílicos com acentos), soWildcards (* e ? na consulta, correspondência mais longa a partir da esquerda, compatível com palavras completas) e soAcrossLines (as frases podem abranger quebras de linha e de bloco através duma correspondência unida por página)

Desde a v3.452.0, soCanonicalEquivalent encontra texto NFC e NFD canonicamente equivalente, preservando as coordenadas originais da ocorrência, e soGraphemeClusters impede que as correspondências e substituições dividam pares substitutos, sequências combinadas, sequências ZWJ de emojis, bandeiras ou conjunções índicas. Quando combinado com soWildcards, um ? consome um cluster de grafemas completo

Os resultados também transportam as posições MatchStart e MatchLength no texto do bloco, além dos fragmentos ContextBefore e ContextAfter quando SearchContextChars é superior a zero

Utilize SearchTextEach quando as ocorrências devam ser consumidas imediatamente sem escolher uma capacidade para a matriz de resultados

Sintaxe

Delphi

Function TPDFlib.SearchText(Const Query: WideString; Options: TPDFlibSearchOptions; Const PageRange: WideString; Var Hits: Array Of TPDFlibSearchHit): Integer;

Parâmetros

Consulte o Guia do Programador da PDF Library for Delphi e os comentários dos cabeçalhos para obter descrições detalhadas dos parâmetros

Valor devolvido

Consulte o Guia do Programador da PDF Library for Delphi para conhecer a semântica específica dos valores devolvidos

Observações

Para obter mais informações relacionadas, consulte a documentação relevante da biblioteca ou os projetos de demonstração