The TVM_GETNEXTITEM message retrieves the tree-view item that bears the specified relationship to a specified item. You can send this message explicitly, by using the TreeView_GetNextItem macro, or by using one of the following related macros: TreeView_GetChild, TreeView_GetDropHilite, TreeView_GetFirstVisible, TreeView_GetNextSibling, TreeView_GetNextVisible, TreeView_GetParent, TreeView_GetPrevSibling, TreeView_GetPrevVisible, TreeView_GetRoot, or TreeView_GetSelection.
TVM_GETNEXTITEM
wParam = (WPARAM) (UINT) flag;
lParam = (LPARAM) (HTREEITEM) hitem;
Parameters
flag
Flag specifying the item to retrieve. This parameter can be one of the following values:
| Value | Message |
| TVGN_CARET | Retrieves the currently selected item. You can use the TreeView_GetSelection macro 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_GetDropHilite macro to send this message. |
| TVGN_FIRSTVISIBLE | Retrieves the first visible item. You can use the TreeView_GetFirstVisible 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 Values
Returns the handle to the item if successful or NULL otherwise.
See Also
TreeView_GetChild, TreeView_GetDropHilite, TreeView_GetFirstVisible, TreeView_GetNextSibling, TreeView_GetNextVisible, TreeView_GetParent, TreeView_GetPrevSibling, TreeView_GetPrevVisible, TreeView_GetRoot, TreeView_GetSelection, TVM_GETITEMRECT