property TextPage: FPDF_TEXTPAGE; // read only
TextPage espone l'handle FPDF_TEXTPAGE raw di PDFium associato alla
pagina attualmente caricata. L'handle viene creato in modo lazy quando la pagina diventa attiva
e resta vivo per tutto il ciclo di vita di quel legame alla pagina; dà accesso diretto
all'API di estrazione testo di PDFium (FPDFText_*) per i chiamanti che richiedono
operazioni non esposte dalle proprietà TPdf di alto livello — per esempio
run di testo a livello di glifo, dati di crenatura, semantiche di ricerca personalizzate o mappature dirette
indice-di-carattere → riquadro di delimitazione
L'handle è valido solo finché Active è True e una pagina
valida è selezionata. Cambiare pagina (assegnando un nuovo PageNumber o chiamando
ReloadPage) distrugge l'handle precedente e ne crea uno nuovo, quindi non
conservare l'handle attraverso i cambi di pagina. Il componente è proprietario dell'handle e lo rilascia
durante lo smontaggio della pagina — non chiamare
FPDFText_ClosePage tu stesso su questo handle
Questa è una proprietà avanzata. La maggior parte dei chiamanti dovrebbe preferire i wrapper di alto livello
CharacterCount, Character[I], CharacterRectangle[I],
Find / FindNext — questi gestiscono già internamente il
ciclo di vita dell'FPDF_TEXTPAGE. Scendi sull'handle raw solo quando
ti servono API PDFium che PDFium Delphi Component non ha ancora esposto
nil quando nessuna pagina è attiva. Verifica sempre l'handle prima
di passarlo a PDFiumFPDFText_FindStart; quel
contesto di ricerca è possionato indipendentemente tramite la proprietà Find
var TP: FPDF_TEXTPAGE;
TP := Pdf1.TextPage;
if Assigned(TP) then
ShowMessage(Format('PDFium reports %d chars',
[FPDFText_CountChars(TP)]));