property TextPage: FPDF_TEXTPAGE; // read only
TextPage stelt de ruwe PDFium FPDF_TEXTPAGE-handle beschikbaar die met de momenteel geladen pagina is geassocieerd. De handle wordt lui aangemaakt wanneer de pagina actief wordt en in leven gehouden voor de levensduur van die paginabinding; het geeft directe toegang tot de tekstextractie-API van PDFium (FPDFText_*) voor aanroepers die bewerkingen nodig hebben die niet door hoog-niveau TPdf-eigenschappen worden aangeboden — bijvoorbeeld glyfniveau-tekstlopen, kerning-gegevens, aangepaste zoeksemantiek of ruwe tekenindex-naar-begrenzingskader-mappingen.
De handle is alleen geldig zolang Active True is en een geldige pagina is geselecteerd. Het wisselen van pagina's (een nieuwe PageNumber toewijzen of ReloadPage aanroepen) vernietigt de vorige handle en maakt een nieuwe aan, dus bewaar de handle niet over paginawijzigingen. De component is eigenaar van de handle en zal deze vrijgeven tijdens pagina-afbraak — roep geen FPDFText_ClosePage er zelf op aan.
Dit is een geavanceerde eigenschap. De meeste aanroepers zouden de hoog-niveau-wrappers CharacterCount, Character[I], CharacterRectangle[I], Find / FindNext moeten verkiezen — deze beheren de FPDF_TEXTPAGE-levenscyclus al intern. Daal alleen af naar de ruwe handle wanneer u PDFium-API's nodig heeft die PDFium Delphi Component nog niet heeft aangeboden.
nil wanneer geen pagina actief is. Controleer altijd de handle voordat
u deze doorgeeft aan PDFium.FPDFText_FindStart; die
zoekcontext wordt onafhankelijk beheerd via de eigenschap Find.
var TP: FPDF_TEXTPAGE;
TP := Pdf1.TextPage;
if Assigned(TP) then
ShowMessage(Format('PDFium reports %d chars',
[FPDFText_CountChars(TP)]));