This message retrieves the tree view item that bears the specified relationship to a specified item. You can send this message explicitly or by using the TreeView_GetNextItem macro or one of the related macros.
At a Glance
| Header file: | Commctrl.h |
| Windows CE versions: | 1.0 and later |
| Related macros: | TreeView_GetNextItem TreeView_GetChild TreeView_GetDropHilite TreeView_GetFirstVisible TreeView_GetNextSibling TreeView_GetNextVisible TreeView_GetParent TreeView_GetPrevSibling TreeView_GetPrevVisible TreeView_GetRoot TreeView_GetSelection |
Syntax
Parameters
flag
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_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_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. |
hitem
Handle to an item.
Return Values
The handle to the item indicates success. NULL indicates otherwise.