property TextPage: FPDF_TEXTPAGE; // read only
TextPage exponerar det råa PDFium-handtaget FPDF_TEXTPAGE som hör till
den aktuellt inlästa sidan. Handtaget skapas lat när sidan blir aktiv
och hålls vid liv så länge sidbindningen består; det ger direkt åtkomst till
PDFiums textextraktions-API (FPDFText_*) för anropare som behöver
operationer som inte exponeras av TPdf-egenskaper på högre nivå — till exempel
textruns på teckennivå, kerning-data, anpassad söksemantik eller råa mappningar från
teckenindex till begränsningsruta
Handtaget är giltigt endast medan Active är True och en giltig
sida är vald. Sidbyte (tilldelning av ett nytt PageNumber eller anrop av
ReloadPage) förstör det tidigare handtaget och skapar ett nytt, så lagra inte
handtaget över sidbyten. Komponenten äger handtaget och frigör
det vid nedmontering av sidan — anropa inte
FPDFText_ClosePage på det själv
Detta är en avancerad egenskap. De flesta anropare bör föredra omslagen på hög nivå
CharacterCount, Character[I], CharacterRectangle[I],
Find / FindNext — de hanterar redan
FPDF_TEXTPAGE-livscykeln internt. Gå ner till det råa handtaget endast när
du behöver PDFium-API:er som PDFium Delphi Component ännu inte har exponerat
nil när ingen sida är aktiv. Kontrollera alltid handtaget innan
det skickas till PDFiumFPDFText_FindStart; det
söksammanhanget ägs oberoende via egenskapen Find
var TP: FPDF_TEXTPAGE;
TP := Pdf1.TextPage;
if Assigned(TP) then
ShowMessage(Format('PDFium reports %d chars',
[FPDFText_CountChars(TP)]));