TreeView_GetNextItem 184F1BK

The TreeView_GetNextItem macro retrieves the tree-view item that bears the specified relationship to a specified item. You can use this macro or one of the related macros, or you can explicitly send the TVM_GETNEXTITEM1ZH_ZN9 message.

HTREEITEM TreeView_GetNextItem(

hwnd,
hitem,
flag
);

Parameters

hwnd

Handle to the tree-view control.

hitem

Handle to an item.

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.

Return Values

Returns the handle to the item if successful or NULL otherwise.