Search

Searches the host screen for some specified text.

Parameters:

SearchStr  -  Specifies the text to search for.

RowVal  -  On input, the variable containing the row position where the search is to begin.  On output, this variable will contain the row position where the text was found.

ColumnVal  -  On input, the variable containing the column position where the search is to begin.  On output, this variable will contain the column position where the text was found.

Returns:

0 for success; or a non-zero error code.  See Error Codes for a complete listing of error code descriptions.

Remarks:

When the Search function returns, the RowVal and ColumnVal variables will contain the position where the text was found.  If the text was not found, or if the function returned an error, the RowVal and ColumnVal variables will contain zero.

Example:

Set Host = CreateObject( "BZWhll.WhllObj" )

 

Host.Connect "A"

row = 1

col = 1

Host.Search ">>", row, col

Host.MsgBox ">> is at position " & row & ", " & col, 0