WP Find next

Home

4D v20 R7

WP Find next


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

Parameter	Type	Description
targetObj	Object	Range or element or 4D Write Pro document
searchAfter	Object	Range after which to begin searching
searchValue	String	Search value
searchCondition	Longint	Search rule(s)
replaceValue	String	Replacement string
Function result	Object	Range of the found/replaced value

Description

The WP Find next command searches the targetObj, after the searchAfter range, for the searchValue based on the searchCondition. An optional parameter can be used to replace any results found.

Note: WP Find next does not search or replace text in formulas. Use the WP Get formulas command in this case.

In the targetObj parameter, pass an object containing:

a range, or
an element (table / row / cell(s) / paragraph / body / header / footer / section / subsection / text box), or
a 4D Write Pro document.

Pass a range in the searchAfter parameter. The search will begin immediately after the range defined or pass NULL to find the first value of targetObj.

Note: If targetObj is the 4D Write Pro document and searchAfter is in a text box, the command searches occurences first in the parent text box and then in next text box(es) in ascending order -- according to the ordering described below.

The searchValue parameter lets you pass the text to search for within the targetObj.

You can specify how the search is performed with the searchCondition parameter. You can use one (or a combination) of the following constants:

Constant	Comment
wk case insensitive	Strings are compared with no consideration of capitalization differences. Note that diacritical marks are taken into consideration. For example, "A" is considered the same as "a", however "a" is not considered the same as "à".
wk diacritic insensitive	Strings are compared but the diacritical mark (e.g., accent or symbol) of letters is ignored. For example, "a" is considered the same as "à".
wk find reverse	Search is performed in reverse order.
wk kana insensitive	For Japanese language. Strings are compared according to the meaning (not the writing style). For example, "あ" is considered the same as "ア". When this option is set, wk width insensitive is implicit (considered set), however, the opposite is not true.
wk keep character style	When replacing text, the existing character style is retained (if possible).
wk override protected	Read/write protection is ignored and strings in protected areas can be replaced.
wk use keyboard language	For string comparison, use the keyboard language property from the form object being edited instead of the current data language (default). Note: Ignored if the document is offscreen.
wk whole word	Only strings that are complete words are considered. Matching strings within other strings are not considered. For example, "where" is not considered when found within "somewhere".
wk width insensitive	For Japanese language. Strings are compared by character width. For example, "ｱ" is considered the same as "ア".

Note: Strings are compared to the current data language unless wk use keyboard language is used.

In the optional replaceValue parameter, you can pass text to take the place of any instance of the text in searchValue found in the targetObj.

Returned Range

The function returns a range of the value that was found or replaced:

search operations - the ranges match the found strings positions
replace operations - the ranges match the replaced strings positions

If targetObj is a range or element, found values are returned in the order they are found.

If targetObj is a 4D Write Pro document, found values are returned in the following order:

body
first page header for section 1 (if any)
first page footer for section 1 (if any)
left page header for section 1 (if any)
left page footer for section 1 (if any)
right page header for section (if any)
right page footer for section 1 (if any)
main header for section 1 (if any)
main footer for section 1 (if any)
repeat with section 2, section 3, and so on
text boxes.

An empty range is returned if no results are found.

Example

 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)