TVM_GETNEXTITEM

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This message retrieves the tree view item that bears the specified relationship to a specified item. You can send this message explicitly or by using the TreeView_GetNextItem macro or one of the related macros.

Syntax

TVM_GETNEXTITEM wParam = (WPARAM)(UINT) flag; 
    lParam = (LPARAM)(HTREEITEM) hitem;

Parameters

• flag
  Specifies the item to retrieve. It is one of the following values.

  Value	Description
  TVGN_CARET	Retrieves the currently selected item. You can use the TreeView_GetSelectionmacro to send this message.
  TVGN_CHILD	Retrieves the first child item of the item specified by the hitem parameter. You can use the TreeView_GetChild macro to send this message.
  TVGN_DROPHILITE	Retrieves the item that is the target of a drag-and-drop operation. You can use the TreeView_GetDropHilight macro to send this message.
  TVGN_FIRSTVISIBLE	Retrieves the first item that is visible in the tree view window. You can use the TreeView_GetFirstVisible macro to send this message.
  TVGN_LASTVISIBLE	Retrieves the last expanded item in the tree. This does not retrieve the last item visible in the tree view window. You can use the TreeView_GetLastVisible macro to send this message.
  TVGN_NEXT	Retrieves the next sibling item. You can use the TreeView_GetNextSibling macro to send this message.
  TVGN_NEXTVISIBLE	Retrieves the next visible item that follows the specified item. The specified item must be visible. Use the TVM_GETITEMRECT message to determine whether an item is visible. You can use the TreeView_GetNextVisible macro to send this message.
  TVGN_PARENT	Retrieves the parent of the specified item. You can use the TreeView_GetParent macro to send this message.
  TVGN_PREVIOUS	Retrieves the previous sibling item. You can use the TreeView_GetPrevSibling macro to send this message.
  TVGN_PREVIOUSVISIBLE	Retrieves the first visible item that precedes the specified item. The specified item must be visible. Use the TVM_GETITEMRECT message to determine whether an item is visible. You can use the TreeView_GetPrevVisible macro to send this message.
  TVGN_ROOT	Retrieves the topmost or very first item of the tree view control. You can use the TreeView_GetRoot macro to send this message.

• hitem
  Handle to an item.

Return Value

The handle to the item indicates success. NULL indicates otherwise.

Requirements

See Also

Reference

TreeView_GetChild
TreeView_GetDropHilight
TreeView_GetFirstVisible
TreeView_GetNextItem
TreeView_GetNextSibling
TreeView_GetNextVisible
TreeView_GetParent
TreeView_GetPrevSibling
TreeView_GetPrevVisible
TreeView_GetRoot
TreeView_GetSelection
TVM_GETITEMRECT