ListView_GetNextItem  190JNCN 

The 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 explicitly send the LVM_GETNEXTITEM1MADYCT message.

int ListView_GetNextItem(

    HWND hwnd,

 

    int iStart,

 

    UINT flags

 

   );

 

 

Parameters

hwnd

Handle to the list view control.

iStart

Index of the item to begin the searching with, 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.

The geometric relation can be one of the following values:

Value

Meaning

LVNI_ABOVE

Searches for an item that is above the specified item.

LVNI_ALL

Searches for a subsequent item by index (the default value).

LVNI_BELOW

Searches for an item that is below the specified item.

LVNI_TOLEFT

Searches for an item to the left of the specified item.

LVNI_TORIGHT

Searches for an item to the right of the specified item.

 

The state can be zero, or it can be one or more of the following values:

Value

Meaning

LVNI_CUT

The item has the LVIS_CUT state flag set.

LVNI_DROPHILITED

The item has the LVIS_DROPHILITED state flag set.

LVNI_FOCUSED

The item has the LVIS_FOCUSED state flag set.

LVNI_SELECTED

The item has the LVIS_SELECTED state flag set.

 

If an item does not have all of the specified state flags set, the search continues with the next item.

 

Return Values

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

See Also

LVM_GETNEXTITEM