SELECTED-SUCCESSOR

If applied to a control (rather than to an item), this attribute returns the handle of the first selected item (or tab, in the case of tab controls) within the control. For controls supporting multiple selection (list box and list view controls), the attribute may also be applied to an item, in which case the handle of the next selected item (if any) is returned.

The value NULL-HANDLE indicates that no (further) selected items exist.

For programming techniques related to the SELECTED-SUCCESSOR attribute, please refer to Working with List Box Controls and Selection Box Controls in the Event-driven Programming Techniques documentation.

Applies to List box control, list box item, list view control, list view item, selection box control, tab control, tree view control.
Data Type HANDLE
Default Value NULL-HANDLE
Possible Values NULL-HANDLE / handle of list box item, selection box item or tab.