Unidade: PDFium
Percorre em stream correspondências de texto num documento, para a frente ou para trás, mantendo handles nativos apenas de uma página
Methods
| Método | Descrição |
|---|
Create | Inicializa uma pesquisa pertencente ao documento com texto, opções, página inicial, direção e token de cancelamento |
Destroy | Fecha os handles nativos de pesquisa retidos e desanexa-se do documento proprietário |
Next(out Match: TPdfDocumentSearchResult): Boolean | Devolve a correspondência seguinte ou False após conclusão, cancelamento ou fecho do documento proprietário |
Properties
| Propriedade | Tipo | Descrição |
|---|
CurrentPage | Integer | Página atualmente em pesquisa, com numeração base 1 |
Direction | TPdfDocumentSearchDirection | Percursos de páginas e correspondências para a frente ou para trás |
Finished | Boolean | Indica se já não pode ser produzido mais nenhum resultado |
Cancelled | Boolean | Indica se o cancelamento cooperativo terminou a pesquisa |
MatchCount | UInt64 | Número de correspondências já devolvidas |
TPdfDocumentSearchResult
| Campo | Tipo | Descrição |
|---|
PageNumber | Integer | Página que contém a correspondência, com numeração base 1 |
StartIndex | Integer | Índice de caracteres nativo da página de texto, com base 0 |
Count | Integer | Número de caracteres nativos da página de texto na correspondência |
Text | WString | Texto Unicode extraído do intervalo da correspondência |
Rectangles | TPdfRectangles | Um ou mais retângulos fundidos no espaço da página PDF para realce |
Lifetime and concurrency
A pesquisa pertence a quem a criou e deve ser libertada por este. O documento proprietário apenas acompanha as pesquisas ativas para poder fechar os respetivos handles nativos antes de o documento ser descarregado
As chamadas ao documento proprietário partilham o lock PDFium deste. Uma única instância de pesquisa ainda assim tem de ser avançada e libertada por um único chamador coordenado, e a edição do documento não pode sobrepor-se a uma pesquisa ativa
See Also