WP Find next

Home

4D v20 R7

WP Find next


WP Find next ( targetObj ; searchAfter ; searchValue ; searchCondition {; replaceValue} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
targetObj	Objekt	Range oder Element oder 4D Write Pro Dokument
searchAfter	Objekt	Range, nach dem die Suche beginnen soll
searchValue	String	Suchwert
searchCondition	Lange Ganzzahl	Suchregel(n)
replaceValue	String	String zum Ersetzen
Funktionsergebnis	Objekt	Range des gefundenen/ersetzen Werts

Beschreibung

Der Befehl WP Find next sucht das targetObj nach dem searchAfter-Range nach dem searchValue auf Basis der searchCondition. Ein optionaler Parameter kann verwendet werden, um gefundene Ergebnisse zu ersetzen.

Hinweis: WP Find next sucht oder ersetzt keinen Text in Formeln. Verwenden Sie in diesem Fall den Befehl WP Get formulas.

Übergeben Sie im Parameter targetObj ein Objekt mit:

einem Range oder
einem Element (Tabelle / Zeile / Zelle(n) / Absatz / Hauptteil / Kopfteil / Fußteil / Abschnitt / Unterabschnitt / Textfeld) oder
einem 4D Write Pro Dokument.

Übergeben Sie einen Range im Parameter searchAfter. Die Suche beginnt unmittelbar nach dem definierten Range oder übergeben Sie NULL, um den ersten Wert von targetObj zu finden.

Hinweis: Wenn targetObj das 4D Write Pro Dokument ist und searchAfter in einem Textfeld steht, sucht der Befehl zuerst im übergeordneten Textfeld und dann in den nächsten Textfeldern in aufsteigender Reihenfolge - entsprechend der unten beschriebenen Reihenfolge.

Mit dem Parameter searchValue können Sie den Text übergeben, nach dem im targetObj gesucht werden soll.

Mit dem Parameter searchCondition können Sie festlegen, wie die Suche durchgeführt wird. Sie können eine (oder eine Kombination) der folgenden Konstanten verwenden:

Konstante	Kommentar
wk case insensitive	Strings werden ohne Berücksichtigung von Klein- und Großschreibung verglichen, diakritische Zeichen werden dagegen berücksichtigt. Beispiel: "A" wird genauso gewertet wie "a", dagegen ist "a" nicht dasselbe wie "à".
wk diacritic insensitive	Strings werden verglichen und diakritische Zeichen für Buchstaben (z.B. Akzent oder Symbol) werden ignoriert. Beispiel: "a" ist dasselbe wie "à".
wk find reverse	Suche erfolgt in umgekehrter Reihenfolge.
wk kana insensitive	Für die japanische Sprache. Strings werden nach Bedeutung verglichen (nicht nach Schreibweise). Zum Beispiel wird "あ" als dasselbe wie "ア" gewertet. Diese Option impliziert wk width insensitive (gilt als gesetzt), das gilt jedoch nicht für das Gegenteil.
wk keep character style	Beim Ersetzen von Text bleibt der vorhandene Schriftstil erhalten (sofern möglich).
wk override protected
wk use keyboard language	Verwendet bei Stringvergleichen die Tastatur Spracheigenschaft des Formularobjekts in Bearbeitung anstelle der aktuellen Sprache der Daten (Standard). Hinweis: Wird ignoriert, wenn Dokument offscreen ist.
wk whole word	Es werden nur Strings berücksichtigt, die vollständige Wörter sind. Übereinstimmende Strings innerhalb anderer Strings werden nicht berücksichtigt. Zum Beispiel wird "wo" nicht berücksichtigt, wenn es in "irgendwo" vorkommt.
wk width insensitive

Hinweis: Strings werden mit der aktuellen Datensprache verglichen, sofern nicht wk use keyboard language verwendet wird.

Im optionalen Parameter replaceValue können Sie einen Text übergeben, der an die Stelle einer beliebigen Instanz des Textes in searchValue tritt, die im targetObj gefunden wurde.

Zurückgegebener Range

Die Funktion gibt einen Range des gefundenen oder ersetzten Wertes zurück:

Such Operationen - die Ranges stimmen mit den gefundenen Stringpositionen überein
Ersetzen Operationen - die Range stimmen mit den Positionen der ersetzten Zeichenketten überein

Wenn targetObj ein Range oder Element ist, werden die gefundenen Werte in der Reihenfolge zurückgegeben, in der sie gefunden wurden. Wenn targetObj ein 4D Write Pro Dokument ist, werden die gefundenen Werte in der folgenden Reihenfolge zurückgegeben:

Hauptteil
Kopfteil erste Seite für Abschnitt 1 (falls vorhanden)
Fußteil erste Seite für Abschnitt 1 (falls vorhanden)
Kopfteil linke Seite für Abschnitt 1 (falls vorhanden)
Fußteil linke Seite für Abschnitt 1 (falls vorhanden)
Kopfteil rechte Seite für Abschnitt (falls vorhanden)
Fußteil rechte Seite für Abschnitt 1 (falls vorhanden)
Hauptkopfteil für Abschnitt 1 (falls vorhanden)
Hauptfußteil für Abschnitt 1 (falls vorhanden)
Wiederholen mit Abschnitt 2, Abschnitt 3 und so weiter.
Textfelder.

Wenn keine Ergebnisse gefunden werden, wird ein leerer Range zurückgegeben.

Beispiel

 var $userSel ;$target ;$alphaRanges ;$nextRange : object

 var $options : Integer

 

  // define search options

 $options:=wk case insensitive+wk diacritic insensitive

 

  // get current user position

 $userSel:=WP Selection range(*;"WParea")

 

  // define target

 $target:=WP Get body(WParea) // search only inside the body

 

  // launch SEARCH of NEXT occurence of the "alpha" string (based on current selection)

 $nextRange:=WP Find next($target;$userSel;"alpha";$options)

Siehe auch

WP Find all
WP Find previous