LVM_GETNEXTITEM

This message searches for a list-view item that has the specified properties and bears the specified relationship to a specified item. You can send this message explicitly or by using the ListView_GetNextItem macro.

LVM_GETNEXTITEM wParam = (WPARAM)(int) iStart; 
  lParam = MAKELPARAM((UINT)flags,0);

Parameters

• iStart
  Index of the item to begin the search with, or –1 to find the first item that matches the specified flags. The specified item itself is excluded from the search.

• flags
  Specifies the relationship to the item specified in iStart. This is the following value.

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

  The physical relationship to iStart is specified with one of the following values.

  Value	Description
  LVNI_ABOVE	Searches for an item that is above the specified item.
  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 of the item to find is specified with one or a combination of the following values.

  Value	Description
  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

The index of the next item indicates success. –1 indicates failure.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Commctrl.h.

See Also

ListView_GetNextItem | List-View Controls Messages

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.