property TextPage: FPDF_TEXTPAGE; // read only
TextPage expose le handle brut PDFium FPDF_TEXTPAGE associé à la page actuellement chargée. Le handle est créé paresseusement lorsque la page devient active et reste vivant pendant toute la durée de vie de cette liaison de page ; il donne un accès direct à l'API d'extraction de texte de PDFium (FPDFText_*) pour les appelants qui ont besoin d'opérations non exposées par les propriétés TPdf de niveau supérieur — par exemple les segments de texte au niveau des glyphes, les données de crénage, une sémantique de recherche personnalisée ou des mappages bruts indice de caractère vers boîte englobante
Le handle n'est valide que tant que Active est True et qu'une page valide est sélectionnée. Changer de page (attribuer un nouveau PageNumber ou appeler ReloadPage) détruit le handle précédent et en crée un nouveau, donc ne stockez pas le handle d'une page à l'autre. Le composant possède le handle et le libérera lors de la fin de vie de la page — ne l'appelez pas vous-même via FPDFText_ClosePage
Il s'agit d'une propriété avancée. La plupart des appelants devraient préférer les wrappers de haut niveau CharacterCount, Character[I], CharacterRectangle[I], Find / FindNext — ceux-ci gèrent déjà le cycle de vie de FPDF_TEXTPAGE en interne. Redescendez vers le handle brut uniquement lorsque vous avez besoin d'API PDFium que PDFium Delphi Component n'a pas encore exposées
nil lorsqu’aucune page n’est active. Vérifiez toujours le handle avant de le passer à PDFiumFPDFText_FindStart ; ce contexte de recherche est possédé indépendamment via la propriété Find
var TP: FPDF_TEXTPAGE;
TP := Pdf1.TextPage;
if Assigned(TP) then
ShowMessage(Format('PDFium reports %d chars',
[FPDFText_CountChars(TP)]));