PDFium Delphi Component Docs

TPdfDocumentSearch Klasse

Unit: PDFium
Streamt Vorwärts- oder Rückwärts-Texttreffer durch ein Dokument und behält native Handles nur für eine einzige Seite

Methoden

MethodeBeschreibung
CreateInitialisiert eine dokumenteigene Suche mit Text, Optionen, Startseite, Richtung und Abbruch-Token
DestroySchließt vorgehaltene native Such-Handles und trennt die Verbindung zum Eigentümer-Dokument
Next(out Match: TPdfDocumentSearchResult): BooleanLiefert den nächsten Treffer oder False nach Abschluss, Abbruch oder Schließung des Eigentümer-Dokuments

Eigenschaften

EigenschaftTypBeschreibung
CurrentPageIntegerAktuell durchsuchte, auf 1 basierende Seite
DirectionTPdfDocumentSearchDirectionVorwärts- oder rückwärtiger Seiten- und Treffer-Durchlauf
FinishedBooleanOb kein weiteres Ergebnis mehr erzeugt werden kann
CancelledBooleanOb ein kooperativer Abbruch die Suche beendet hat
MatchCountUInt64Anzahl der bereits gelieferten Treffer

TPdfDocumentSearchResult

FeldTypBeschreibung
PageNumberIntegerAuf 1 basierende Seite, die den Treffer enthält
StartIndexIntegerAuf 0 basierender Zeichenindex der nativen Textseite
CountIntegerAnzahl der nativen Textseiten-Zeichen im Treffer
TextWStringAus dem Trefferbereich extrahierter Unicode-Text
RectanglesTPdfRectanglesEine oder mehrere zusammengeführte Rechtecke im PDF-Seitenraum zur Hervorhebung

Lebensdauer und Nebenläufigkeit

Der Aufrufer besitzt die Suche und muss sie freigeben. Das Eigentümer-Dokument verfolgt aktive Suchen nur, um ihre nativen Handles schließen zu können, bevor das Dokument entladen wird

Aufrufe in das Eigentümer-Dokument teilen sich dessen PDFium-Sperre. Eine einzelne Suchinstanz muss dennoch von einem koordinierten Aufrufer vorangetrieben und freigegeben werden, und Dokumentbearbeitung darf sich nicht mit einer aktiven Suche überlappen

Siehe auch

TPdf.CreateDocumentSearch, TPdf.FindFirst