TextPage Eigenschaft

TextPage legt das rohe PDFium-FPDF_TEXTPAGE-Handle offen, das zur aktuell geladenen Seite gehört. Das Handle entsteht lazily, sobald die Seite aktiv wird, und bleibt für die Lebensdauer dieser Seiten-Bindung am Leben; es gibt direkten Zugriff auf PDFiums Textextraktions-API (FPDFText_*) für Aufrufer, die Operationen brauchen, die hochsprachliche TPdf-Eigenschaften nicht anbieten — etwa Textläufe auf Glyphenebene, Kerning-Daten, eigene Such-Semantik oder rohe Zeichenindex-zu- Bounding-Box-Mappings

Das Handle ist nur gültig, solange Active True ist und eine gültige Seite gewählt ist. Ein Seitenwechsel (neue PageNumber zuweisen oder ReloadPage aufrufen) zerstört das vorherige Handle und erzeugt ein neues; heben Sie das Handle also nicht über Seitenwechsel hinweg auf. Die Komponente besitzt das Handle und gibt es beim Abbauen der Seite frei — rufen Sie FPDFText_ClosePage nicht selbst darauf auf

Das ist eine Fortgeschrittenen-Eigenschaft. Die meisten Aufrufer fahren mit den hochsprachlichen Wrappern CharacterCount, Character[I], CharacterRectangle[I], Find / FindNext besser — die verwalten den FPDF_TEXTPAGE-Lebenszyklus bereits intern. Zum rohen Handle steigt man nur ab, wenn man PDFium-APIs braucht, die PDFium Delphi Component noch nicht anbietet

• Liefert nil, wenn keine Seite aktiv ist. Immer das Handle prüfen, bevor man es an PDFium durchreicht
• Das Handle spiegelt den Content Stream der Seite wider, wie PDFium ihn geparst hat — es schließt keinen Extraktionszustand aus FPDFText_FindStart ein; dieser Suchkontext gehört unabhängig davon der Eigenschaft Find
• Rohe PDFium-APIs über dieses Handle zu rufen umgeht die Caching-Schichten von PDFium Delphi Component; intensiver Einsatz kann die Leistung also gegenüber den hochsprachlichen Accessors verschlechtern