TVM_GETNEXTITEM  1EK7VKP 

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_GetNextItemCMZJ0Q macro, or by using one of the following related macros: TreeView_GetChild302_PC, TreeView_GetDropHilite8PV_EC, TreeView_GetFirstVisible1DDIZC0, TreeView_GetNextSibling3N99O2F, TreeView_GetNextVisibleILKL55, TreeView_GetParent5S5KYZ, TreeView_GetPrevSiblingQBGG6_, TreeView_GetPrevVisible1P7KAD6, TreeView_GetRootGU5Z3Y, or TreeView_GetSelectionCDUVDW.

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_GetSelectionCDUVDW 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_GetChild302_PC 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_GetDropHilite8PV_EC macro to send this message.

TVGN_FIRSTVISIBLE

Retrieves the first visible item. You can use the TreeView_GetFirstVisible1DDIZC0 macro to send this message.

TVGN_NEXT

Retrieves the next sibling item. You can use the TreeView_GetNextSibling3N99O2F 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_GETITEMRECTJK9FWA message to determine whether an item is visible. You can use the TreeView_GetNextVisibleILKL55 macro to send this message.

TVGN_PARENT

Retrieves the parent of the specified item. You can use the TreeView_GetParent5S5KYZ macro to send this message.

TVGN_PREVIOUS

Retrieves the previous sibling item. You can use the TreeView_GetPrevSiblingQBGG6_ 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_GETITEMRECTJK9FWA message to determine whether an item is visible. You can use the TreeView_GetPrevVisible1P7KAD6 macro to send this message.

TVGN_ROOT

Retrieves the topmost or very first item of the tree-view control. You can use the TreeView_GetRootGU5Z3Y 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