FindNextRow Method (DATATABLE)

10.5, PLBCMP GUI Only

The FindNextRow method finds a row from a beginning position in a DATATABLE. Optional search criteria can be used in the find process. The method uses the following format:

Where:

label

Optional. A Program Execution Label.

object

Required. A DATATABLE object.

return

Optional. A Numeric Variable that returns the zero-based index of the next row or -1 if the text is not found.

flags

Required. A decimal number or Numeric Variable that alters the search method as described below.

start

Optional. A decimal number or Numeric Variable that specifies the zero-based row number from which to start the search. The search starts with the row following this row number.

Flags Affected: EOS, OVER, ZERO

Note the following:

1. The EOS flag is always cleared.

2. The ZERO flag is set if the {return} value is zero.

3. The OVER flag is set if the {return} variable is too small to receive the return value.

4. If a {start} is not specified, the default value is -1.

5. The {flags} bit mask values are defined as follows:

 

Value	Meaning
0x1	Find next focused item.
0x2	Find next selected item.

See Also: Method Syntax, DATATABLE Methods