Search-Text

As soon as this property is set to a value, the Grid control is searched for that value, according to the options set in the Search-Options property.

The search begins at the cell identified by the X and Y properties. Cells that are hidden due to Row-Hiding and Column-Hiding are not considered by the search.

If the search succeeds, the X and Y properties are updated to match the coordinates of the cell that contains the searched text.

After the search, one of the following values is returned:

0	Search failed. The X and Y properties are left unchanged.
1	Search succeeded.
2	Search succeeded, but it reached the end (or the top) of the Grid control and continued from the top (or the end).

 

Example - Search for the string "Phoenix" and advise the user if the string is not found

modify screen-2-gr-1 search-text "Phoenix" giving search-result.  if search-result = 0     display message "Not found" icon mb-error-icon  end-if.