TVINSERTSTRUCT structure

Contains information used to add a new item to a tree-view control. This structure is used with the TVM_INSERTITEM message. The structure is identical to the TV_INSERTSTRUCT structure, but it has been renamed to follow current naming conventions.

Syntax

typedef struct {
  HTREEITEM hParent;
  HTREEITEM hInsertAfter;
#if (_WIN32_IE >= 0x0400)
  union {
    TVITEMEX itemex;
    TVITEM   item;
  } DUMMYUNIONNAME;
#else 
  TVITEM    item;
#endif 
} TVINSERTSTRUCT, *LPTVINSERTSTRUCT;

Members

hParent

Type: HTREEITEM

Handle to the parent item. If this member is the TVI_ROOT value or NULL, the item is inserted at the root of the tree-view control.

hInsertAfter

Type: HTREEITEM

Handle to the item after which the new item is to be inserted, or one of the following values:

Value	Meaning
TVI_FIRST	Inserts the item at the beginning of the list.
TVI_LAST	Inserts the item at the end of the list.
TVI_ROOT	Add the item as a root item.
TVI_SORT	Inserts the item into the list in alphabetical order.

 

DUMMYUNIONNAME

itemex

Type: TVITEMEX

Version 4.71. TVITEMEX structure that contains information about the item to add.

item

Type: TVITEM

TVITEM structure that contains information about the item to add.

item

Type: TVITEM

TVITEM structure that contains information about the item to add.

Remarks

The unions in this structure have been updated to work with compilers that do not support nameless unions. If your compiler does not support nameless unions, define the NONAMELESSUNION token before including the commctrl.h header file.

Requirements