PDFium Delphi Component Docs

TPdfDocumentSearch classe

Unidade: PDFium
Transmite correspondências de texto para frente ou para trás por um documento, retendo handles nativos para apenas uma página

Methods

MethodDescription
CreateInicializa uma busca pertencente ao documento com texto, opções, página inicial, direção e token de cancelamento
DestroyFecha os handles de busca nativos retidos e desanexa do documento proprietário
Next(out Match: TPdfDocumentSearchResult): BooleanRetorna a próxima correspondência ou False após conclusão, cancelamento ou fechamento do documento proprietário

Properties

PropertyTypeDescription
CurrentPageIntegerPágina de base um sendo pesquisada no momento
DirectionTPdfDocumentSearchDirectionTravessia de páginas e correspondências para frente ou para trás
FinishedBooleanSe nenhum resultado adicional pode ser produzido
CancelledBooleanSe um cancelamento cooperativo encerrou a busca
MatchCountUInt64Número de correspondências já retornadas

TPdfDocumentSearchResult

FieldTypeDescription
PageNumberIntegerPágina de base um que contém a correspondência
StartIndexIntegerÍndice de caractere de base zero da página de texto nativa
CountIntegerNúmero de caracteres da página de texto nativa na correspondência
TextWStringTexto Unicode extraído do intervalo correspondente
RectanglesTPdfRectanglesUm ou mais retângulos mesclados no espaço de página PDF para realce

Lifetime and concurrency

O chamador é proprietário da busca e deve liberá-la. O documento proprietário rastreia buscas ativas apenas para poder fechar seus handles nativos antes que o documento seja descarregado

Chamadas ao documento proprietário compartilham seu lock do PDFium. Uma única instância de busca ainda deve ser avançada e liberada por um chamador coordenado, e a edição do documento não deve se sobrepor a uma busca ativa

See Also

TPdf.CreateDocumentSearch, TPdf.FindFirst