SearchText

Texto, extraction

Descrição

Busca em blocos de texto ao longo do intervalo de páginas solicitado e copia os hits para o array fornecido pelo chamador, retornando a contagem total de ocorrências mesmo quando o array é menor

O método reporta o progresso de página por OnProgress, respeita Abort entre páginas e blocos, e restaura a página que estava selecionada antes da busca

Desde a v3.430.0, TPDFlibSearchOption também aceita soDiacriticInsensitive (fold Unicode 1:1 para que letras simples casem com equivalentes acentuados latinos, gregos e cirílicos), soWildcards (* e ? na consulta, leftmost-longest, compatível com palavra inteira) e soAcrossLines (frases podem atravessar quebras de linha e de bloco via casamento com páginas unidas)

Desde a v3.452.0, soCanonicalEquivalent casa texto NFC e NFD canonicamente equivalente preservando as coordenadas originais das ocorrências, e soGraphemeClusters impede que correspondências e substituições quebrem pares surrogate, sequências combinantes, sequências de emoji ZWJ, flags ou conjuntos indic. Combinado com soWildcards, um ? consome um cluster de grafemas completo

As ocorrências também trazem as posições MatchStart e MatchLength dentro do texto do bloco, mais os trechos ContextBefore e ContextAfter quando SearchContextChars é maior que zero

Use SearchTextEach quando as ocorrências devem ser consumidas imediatamente, sem escolher a capacidade de um array 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 PDF Library for Delphi Developer Guide e os comentários do header para descrições detalhadas dos parâmetros

Valor de retorno

Consulte o PDF Library for Delphi Developer Guide para conhecer a semântica específica dos valores de retorno

Observações

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