Next_Selection - PickList_

Returns identifier of next selected item

Type: Function
Return Data Type: Integer

Syntax

Function Next_Selection Returns Integer

Call Example

Get Next_Selection to IntegerVariable

Description

Returns identifier (either item_number if batch_state is true or record_number if batch_state is false) of next selected item after item specified by enumeration_counter, or returns -1 if there are no more selected items. As an item (or record) identifier is returned, it is removed from the set of selected items. If batch_state is false, the record for the next selected item is found (using read_by_recnum if server exists). Enumeration_counter is also incremented unless there are no more selected items.