ListView_GetNextItem macro

Searches for a list-view item that has the specified properties and bears the specified relationship to a specified item. You can use this macro or send the LVM_GETNEXTITEM message explicitly.

Syntax


int ListView_GetNextItem(
   HWND hwnd,
   int  iStart,
   UINT flags
);

Parameters

hwnd

Type: HWND

A handle to the list-view control.

iStart

Type: int

The 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

Type: UINT

The 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 lParam 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

Returns the index of the next item if successful, or -1 otherwise.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Commctrl.h

 

 

Show: