property TextPage: FPDF_TEXTPAGE; // read only
TextPage expõe o handle bruto FPDF_TEXTPAGE do PDFium associado à página carregada no momento. O handle é criado de forma preguiçosa quando a página se torna ativa e é mantido vivo durante toda a vida útil desse vínculo de página; ele dá acesso direto à API de extração de texto do PDFium (FPDFText_*) para quem precisa de operações não expostas por propriedades de nível superior de TPdf — por exemplo, sequências de texto no nível de glifo, dados de kerning, semântica de busca personalizada ou mapeamentos brutos de índice de caractere para caixa delimitadora
O handle é válido apenas enquanto Active for True e uma página válida estiver selecionada. Trocar de página (atribuindo um novo PageNumber ou chamando ReloadPage) destrói o handle anterior e cria um novo, então não armazene o handle entre mudanças de página. O componente é o dono do handle e o liberará durante a desmontagem da página — não chame FPDFText_ClosePage nele você mesmo
Esta é uma propriedade avançada. A maioria dos chamadores deve preferir os wrappers de alto nível CharacterCount, Character[I], CharacterRectangle[I], Find / FindNext — eles já gerenciam o ciclo de vida de FPDF_TEXTPAGE internamente. Só desça para o handle bruto quando precisar de APIs do PDFium que o PDFiumPas ainda não expôs
nil quando nenhuma página está ativa. Sempre verifique o handle antes de passá-lo ao PDFiumFPDFText_FindStart; esse contexto de busca é mantido de forma independente pela propriedade Find
var TP: FPDF_TEXTPAGE;
TP := Pdf1.TextPage;
if Assigned(TP) then
ShowMessage(Format('PDFium reports %d chars',
[FPDFText_CountChars(TP)]));