TreeView_GetNextItem
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_GETNEXTITEM
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_GetSelection |
TVGN_CHILD |
Retrieves
the first child item of the item specified by the hitem parameter. You
can use the TreeView_GetChild |
TVGN_DROPHILITE |
Retrieves
the item that is the target of a drag-and-drop operation. You can use the TreeView_GetDropHilite |
TVGN_FIRSTVISIBLE |
Retrieves
the first visible item. You can use the TreeView_GetFirstVisible |
TVGN_NEXT |
Retrieves
the next sibling item. You can use the TreeView_GetNextSibling |
TVGN_NEXTVISIBLE |
Retrieves
the next visible item that follows the specified item. The specified item
must be visible. Use the TVM_GETITEMRECT |
TVGN_PARENT |
Retrieves
the parent of the specified item. You can use the TreeView_GetParent |
TVGN_PREVIOUS |
Retrieves
the previous sibling item. You can use the TreeView_GetPrevSibling |
TVGN_PREVIOUSVISIBLE |
Retrieves
the first visible item that precedes the specified item. The specified item
must be visible. Use the TVM_GETITEMRECT |
TVGN_ROOT |
Retrieves
the topmost or very first item of the tree-view control. You can use the TreeView_GetRoot |
Return Values
Returns the
handle to the item if successful or NULL otherwise.
See Also