WP Find previous

Home

4D v20 R7

WP Find previous


WP Find previous ( targetObj ; searchBefore ; searchValue ; searchCondition {; replaceValue} ) -> Funktionsergebnis

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

Beschreibung

Der Befehl WP Find previous durchsucht das targetObj vor dem searchBefore-Range nach dem searchValue basierend auf der searchCondition. Ein optionaler Parameter kann verwendet werden, um gefundene Ergebnisse zu ersetzen.

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

Im Parameter targetObj übergeben Sie 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 searchBefore. Die Suche beginnt unmittelbar vor dem definierten Bereich.

Hinweis: Wenn targetObj das 4D Write Pro Dokument ist und searchBefore in einem Textfeld steht, sucht der Befehl zuerst im übergeordneten Textfeld und dann in vorherigen Textfeldern, Fußteil(en), Kopfteil(en) und schließlich im Hauptteil in absteigender Reihenfolge (gemäß der unten stehenden 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 Ranges 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 ;$previousRanges: 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 PREVIOUS occurences of the "alpha" string(based on current selection)

 $previousRanges:=WP Find previous($target;"alpha";$options)

Siehe auch

WP Find all
WP Find next