WP Find all

Home

4D v20 R7

WP Find all


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

Parameter	Typ	Beschreibung
targetObj	Objekt	Range oder Element oder 4D Write Pro Dokument
searchValue	String	Suchwert
searchCondition	Lange Ganzzahl	Suchregel(n)
replaceValue	String	String zum Ersetzen
Funktionsergebnis	Collection	Collection aus Rangeobjekten

Beschreibung

Der Befehl WP Find all durchsucht das targetObj nach dem searchValue auf Basis der searchCondition. Ein optionaler Parameter kann verwendet werden, um gefundene Ergebnisse zu ersetzen.

Hinweis: WP Find all 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 Rangeoder
einem Element (Tabelle / Zeile / Zelle(n) / Absatz / Hauptteil / Kopfteil / Fußteil / Abschnitt / Unterabschnitt / Textfeld) oder
einem 4D Write Pro Dokument.

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

Mit dem Parameter searchCondition können Sie angeben, 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ückgegebene Collection

Die Funktion gibt eine Collection von Range-Objekten zurück, die jeden gefundenen oder ersetzten Wert beschreiben:

Such Operationen - die Ranges stimmen mit den gefundenen Stringpositionen überein
Ersetzen Operationen ersetzen - 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.

Die Reihenfolge wird umgekehrt, wenn wk find reverse verwendet wird.

Wenn keine Ergebnisse gefunden werden, wird eine leere Collection zurückgegeben.

Beispiel

 var $userSel ;$target ;$alphaRanges : Object

 var $bravoRanges: &NBSP;Collection

 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 REPLACEMENT of ALL occurences of "alpha" by "bravo" in the body

 $bravoRanges:=WP Find all($target;"alpha";$options;"bravo")

Siehe auch

WP Find next
WP Find previous