GetFirstSel Method (DATALIST)

PLBCMP GUI Only

The GetFirstSel method retrieves the index for the first 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 zero-based index of the first selected item.

Flags Affected: EOS, OVER, ZERO

Note the following:

1. Upon completion, {return} will contain the zero-based index of the first selected item in the list.

2. If no item is selected, {return} will have a value of -1.

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

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

5. The EOS Condition Flag is always cleared.

6. Use the GetNextSel method to retrieve additional selected items.

7. When using the PL/B Web Server, this method is not supported.

See Also: Method Syntax, DATALIST Methods