SEC_TREECLASS::GetNextItem

HTREEITEMSEC_TREECLASS::GetNextItem(HTREEITEMhti, UINTnCode)

Retrieves the next tree view item.

Defined in: trcore.inl

Return Value

The handle of the next item if successful; otherwise NULL.

Parameters

hti

Handle of a tree item.

nCode

A flag indicating the type of relation to hItem. This flag can be one of the following values: TVGN_CARET - retrieves the currently selected item. TVGN_CHILD - retrieves the first child item. The hItem parameter must be NULL. TVGN_DROPHILITE - retrieves the item that is the target of a drag-and-drop operation. TVGN_FIRSTVISIBLE - retrieves the first visible item.

TVGN_NEXT - retrieves the next sibling item. TVGN_NEXTVISIBLE - retrieves the next visible item that follows the specified item. TVGN_PARENT - retrieves the parent of the specified item. TVGN_PREVIOUS - retrieves the previous sibling item. TVGN_PREVIOUSVISIBLE - retrieves the first visible item that precedes the specified item. TVGN_ROOT - retrieves the first child item of the root item of which the specified item is a part.

TVGN_SELECTED - gets next selected item if more than one. TVGN_FIRSTSELECTED - retrieves the first selected item. TVGN_NEXTSELECTED - retrieves the next selected item. TVGN_PREVIOUSSELECTED - retrieves the previous selected item.

Comments

Call this function to retrieve the tree view item that has the specified relationship, indicated by the nCode parameter, to hItem.