property TextPage: FPDF_TEXTPAGE; // read only
TextPage stellt den rohen PDFium-Handle FPDF_TEXTPAGE bereit, der mit
der aktuell geladenen Seite verknüpft ist. Der Handle wird erst erzeugt, wenn die Seite
aktiv wird, und bleibt für die Lebensdauer dieser Seitenbindung erhalten; er gibt
direkten Zugriff auf die PDFium-Text-Extraktions-API (FPDFText_*) für
Aufrufer, die Operationen brauchen, die von höherwertigen TPdf-Eigenschaften
nicht angeboten werden — etwa Textläufe auf Glyphenebene, Kerning-Daten,
benutzerdefinierte Suchsemantik oder rohe Zuordnungen von Zeichenindex zu Begrenzungsbox
Der Handle ist nur gültig, solange Active True ist und eine
gültige Seite ausgewählt ist. Beim Wechseln der Seite (Zuweisen einer neuen
PageNumber oder Aufruf von ReloadPage) wird der vorherige Handle
zerstört und ein neuer erzeugt, also speichern Sie den Handle nicht über Seitenwechsel
hinweg. Die Komponente besitzt den Handle und gibt ihn beim Abbau der Seite frei —
rufen Sie nicht selbst FPDFText_ClosePage darauf auf
Dies ist eine fortgeschrittene Eigenschaft. Die meisten Aufrufer sollten die
höherwertigen Wrapper CharacterCount, Character[I],
CharacterRectangle[I], Find / FindNext
bevorzugen — diese verwalten den Lebenszyklus von FPDF_TEXTPAGE
bereits intern. Greifen Sie nur dann auf den rohen Handle zurück, wenn Sie PDFium-APIs
benötigen, die PDFiumPas noch nicht bereitstellt
nil zurück, wenn keine Seite aktiv ist. Prüfen Sie den Handle immer, bevor Sie ihn an PDFium übergebenFPDFText_FindStart; dieser
Suchkontext wird unabhängig über die Eigenschaft Find verwaltet
var TP: FPDF_TEXTPAGE;
TP := Pdf1.TextPage;
if Assigned(TP) then
ShowMessage(Format('PDFium reports %d chars',
[FPDFText_CountChars(TP)]));