Share via

TVM_GETNEXTITEM (Compact 2013)

  • Article

3/28/2014

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.

Syntax

TVM_GETNEXTITEM wParam = (WPARAM)(UINT) flag; 
    lParam = (LPARAM)(HTREEITEM) hitem;

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

    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 Value

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

Requirements

Header

commctrl.h

See Also

Reference

Tree View Controls Messages
TreeView_GetChild
TreeView_GetDropHilight
TreeView_GetFirstVisible
TreeView_GetNextItem
TreeView_GetNextSibling
TreeView_GetNextVisible
TreeView_GetParent
TreeView_GetPrevSibling
TreeView_GetPrevVisible
TreeView_GetRoot
TreeView_GetSelection
TVM_GETITEMRECT