Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This macro retrieves the tree-view item that bears the specified relationship to a specified item. You can use this macro, use one of the TreeView_Get XXX macros described below, or send the TVM_GETNEXTITEMmessage explicitly.

Syntax 

HTREEITEM TreeView_GetNextItem( 

hwnd, 

hitem, 

flag 
);

Parameters

hwnd

Handle to the tree view control.

hitem

Handle to an item.

flag

Flag that 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 hitemparameter. You can use the TreeView_GetChildmacro to send this message.

TVGN_DROPHILITE

Retrieves the item that is the target of a drag-and-drop operation. You can use the TreeView_GetDropHilightmacro to send this message.

TVGN_FIRSTVISIBLE

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

TVGN_NEXT

Retrieves the next sibling item. You can use the TreeView_GetNextSiblingmacro 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_GETITEMRECTmessage to determine whether an item is visible. You can use the TreeView_GetNextVisiblemacro to send this message.

TVGN_PARENT

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

TVGN_PREVIOUS

Retrieves the previous sibling item. You can use the TreeView_GetPrevSiblingmacro 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_GetPrevVisiblemacro to send this message.

TVGN_ROOT

Retrieves the topmost or very first item of the tree view control. You can use the TreeView_GetRootmacro to send this message.

Return Value

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

Requirements

Header commctrl.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also