4D v19
WP Find next
- 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 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 | |||||
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) 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.
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 |
| 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ü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.
Wenn keine Ergebnisse gefunden werden, wird ein leerer Range zurückgegeben.
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)
Produkt: 4D
Thema: 4D Write Pro Programmiersprache
Nummer:
1764
Erstellt: 4D v19
4D Write Pro Handbuch ( 4D v19)
