Returns the first or next checked item.

If applied to a list view control, the handle of the first checked list view item (if any) is returned. If applied to a list view item or tree view item, the handle of the next checked item (if any) is returned. In the latter case, it is not necessary that the item to which this attribute is applied is itself checked.

The search sequence used for finding the first or next item in the case of list views is based on an internal index. For SORTED controls, this is alphabetic sequence. Otherwise it is the creation sequence (earliest first). Furthermore, if the items are sorted via the SORT-ITEMS action, the internal indexes are updated automatically to correspond to the sorted sequence. For tree views, the search sequence is identical to the visual sequence (i.e., the order in which the tree view items are displayed), and child items (if any) are not searched.

Note that check boxes are only displayed if the list or tree view control's "Check boxes (c)" STYLE is set.

For more information, please refer to the articles Working with List View Controls and Working with Tree View Controls.

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