4D v19
WP Find all
- 4D Write Pro Handbuch
-
- 4D Write Pro Programmiersprache
-
- Über 4D Write Pro Objekte
- Befehle aus dem Kapitel Objekte (Formulare) verwenden
- Befehle aus dem Kapitel Mehrfachstil Text verwenden
- Per Programmierung auf Dokumentinhalte zugreifen
- 4D Write Pro Konstanten
- WP Add picture
- WP Bookmark range
- WP COMPUTE FORMULAS
- WP DELETE BOOKMARK
- WP DELETE FOOTER
- WP DELETE HEADER
- WP DELETE PICTURE
- WP DELETE STYLE SHEET
- WP DELETE SUBSECTION
- WP EXPORT DOCUMENT
- WP EXPORT VARIABLE
- WP Find allNew
- WP Find nextNew
- WP Find previousNew
- WP FREEZE FORMULAS
- WP GET ATTRIBUTES
- WP Get body
- WP GET BOOKMARKS
- WP Get breaksNew
- WP Get element by ID
- WP Get elements
- WP Get footer
- WP Get formulas
- WP Get frame
- WP Get header
- WP Get links
- WP Get page count
- WP Get position
- WP Get section
- WP Get sections
- WP Get style sheet
- WP Get style sheets
- WP Get subsection
- WP Get text
- WP Get view properties
- WP Import documentUpd
- WP IMPORT STYLE SHEETS
- WP INSERT BREAK
- WP INSERT DOCUMENT
- WP INSERT FORMULA
- WP INSERT PICTURE
- WP Insert table
- WP Is font style supported
- WP New
- WP NEW BOOKMARK
- WP New footer
- WP New header
- WP New style sheet
- WP New subsection
- WP Paragraph range
- WP Picture range
- WP PRINT
- WP RESET ATTRIBUTES
- WP SELECT
- WP Selection range
- WP SET ATTRIBUTES
- WP SET FRAME
- WP SET LINK
- WP SET TEXT
- WP SET VIEW PROPERTIES
- WP Table append row
- WP TABLE DELETE COLUMNS
- WP TABLE DELETE ROWS
- WP Table get cells
- WP Table get columns
- WP Table get rows
- WP Table insert columns
- WP Table insert rows
- WP Table range
- WP Text range
- WP USE PAGE SETUP
- 4D Write Pro Attribute
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 | |||||
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) 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 |
| wk case insensitive |
| wk diacritic insensitive |
| wk find reverse |
| wk kana insensitive |
| wk keep character style |
| wk override protected |
| wk use keyboard language |
| wk whole word |
| 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.
Die Reihenfolge wird umgekehrt, wenn wk find reverse verwendet wird.
Wenn keine Ergebnisse gefunden werden, wird eine leere Collection zurückgegeben.
var $userSel ;$target ;$alphaRanges ;$bravoRanges : 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 REPLACEMENT of ALL occurences of "alpha" by "bravo" in the body
$bravoRanges:=WP Find all($target;"alpha";$options;"bravo")</p><p>
Produkt: 4D
Thema: 4D Write Pro Programmiersprache
Nummer:
1755
Erstellt: 4D v19
4D Write Pro Handbuch ( 4D v19)
