Bezeichnung
pdf.FindStart -- leitet den Suchvorgang ein (V1.1)
Übersicht
pdf.FindStart(id, page, s$[, flags, idx])
Beschreibung
Mit diesem Befehl kann ein neuer Suchvorgang auf der Seite gestartet werden, die durch page in dem durch id definierten Dokument angegeben ist. Sie müssen die Zeichenkette, nach der die Seite durchsucht werden soll, im Argument s$ übergeben. Mit dem optionalen Argument flags können zusätzliche Optionen für den Suchvorgang konfiguriert werden. Der Parameter flags kann eine Kombination aus den folgenden speziellen Konstanten sein:

#PDFFIND_MATCHCASE:
Wenn dieses Flag gesetzt ist, wird der Suchvorgang unter Berücksichtigung der Groß-/Kleinschreibung durchgeführt.

#PDFFIND_MATCHWHOLEWORD:
Wenn dieses Flag gesetzt ist, wird nur dann etwas gefunden, wenn s$ einem ganzen Wort entspricht.

Standardmäßig beginnt der Suchvorgang am Anfang der Seite. Sie können dies ändern, indem Sie im optionalen Parameter idx einen Zeichenindex übergeben, um die Suche an einer anderen Stelle zu starten. Beachten Sie, dass Zeichenindizes bei 0 beginnen, während die Übergabe von -1 im Parameter idx die Suche am Ende der Seite startet.

Im Argument page geben Sie die zu verwendende Seite als Zahl an, die im Bereich von 1 bis zur Gesamtzahl der Seiten im Dokument liegen muss. Die Seite muss vorher mit pdf.LoadPage() mit dem Argument text auf True geladen und das durch id angegebene PDF-Dokument muss zuvor mit pdf.OpenDocument() geöffnet worden sein.

Nachdem Sie pdf.FindStart() aufgerufen haben, um den Suchvorgang einzuleiten, müssen Sie dann entweder pdf.FindNext() oder pdf.FindPrev() aufrufen, um den Suchvorgang tatsächlich auszuführen.

Eingaben
id
Kennung des zu verwendenden PDF-Dokuments
page
zu suchende Seitennummer (beginnend ab 1)
s$
zu suchende Zeichenkette
flags
optional: Kombination von Flags, die zusätzliche Optionen definieren (siehe oben) (Voreingestellt ist 0).
idx
optional: Zeichenindex, bei dem die Suche gestartet werden soll (Voreingestellt ist 0)
Navigation zeigen