Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
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 flagsparameter 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

See Also