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.

Parameters

wParam

Flag specifying the item to retrieve. This parameter can be one of the following values:

ValueMeaning
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_GetDropHilight macro to send this message.

TVGN_FIRSTVISIBLE

Retrieves the first item that is visible in the tree-view window. You can use the TreeView_GetFirstVisible macro to send this message.

TVGN_LASTVISIBLE

Version 4.71. Retrieves the last expanded item in the tree. This does not retrieve the last item visible in the tree-view window. You can use the TreeView_GetLastVisible macro to send this message.

TVGN_NEXT

Retrieves the next sibling item. You can use the TreeView_GetNextSibling macro to send this message.

TVGN_NEXTSELECTED

Windows Vista and later. Retrieves the next selected item. You can use the TreeView_GetNextSelected 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.

 

lParam

Handle to an item.

Return value

Returns the handle to the item if successful. For most cases, the message returns a NULL value to indicate an error. See the Remarks section for details.

Remarks

This message will return NULL if the item being retrieved is the root node of the tree. For example, if you use this message with the TVGN_PARENT flag on a first-level child of the tree view's root node, the message will return NULL.

You can also use one of these related macros:

TreeView_GetChild
TreeView_GetDropHilight
TreeView_GetFirstVisible
TreeView_GetLastVisible
TreeView_GetNextSibling
TreeView_GetNextVisible
TreeView_GetParent
TreeView_GetPrevSibling
TreeView_GetPrevVisible
TreeView_GetRoot
TreeView_GetSelection

 

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Commctrl.h

 

 

Community Additions

ADD
Show:
© 2014 Microsoft