GetNextSel Method (DATALIST)

PLBCMP GUI Only

The GetNextSel method retrieves the index for the next selected item in a DATALIST object. The method uses the following format:

Where:

label

Optional. A Program Execution Label.

object

Required. A DATALIST object that is accessed.

return

Optional. A Numeric Variable that returns the zero-based index of the next selected item.

Flags Affected: EOS, OVER, ZERO

Note the following:

1. If no additional items are selected, the method returns -1.

2. If the value returned is zero, the ZERO Condition Flag is set.

3. If {return} is too small to contain the item number, the OVER Condition Flag is set.

4. The EOS Condition Flag is always cleared.

5. Use the GetFirstSel method to retrieve the first selected item.

See Also: Method Syntax, DATALIST Methods