ListView_GetNextItem
A version of this page is also available for
4/8/2010
This inline function searches for a list-view item that has the specified properties and bears the specified relationship to a specified item. You can use this inline function or send the LVM_GETNEXTITEM message explicitly.
Syntax
int ListView_GetNextItem(
HWND hwnd,
int iStart,
UINT flags
);
Parameters
- hwnd
Handle to the list-view control.
- iStart
Index of the item with which to begin the search, or -1 to find the first item that matches the specified flags. The specified item itself is excluded from the search.
- flags
Geometric relation of the requested item to the specified item and, if specified, the state of the requested item. For a list of possible values, see the description of the flags parameter in the LVM_GETNEXTITEM message. If an item does not have all of the specified state flags set, the search continues with the next item.
Return Value
The index of the next item indicates success. –1 indicates failure.
Remarks
Related message: LVM_GETNEXTITEM
Requirements
| Header | commctrl.h |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |