TreeView::InsertItem

Inserts an item to the tree view control.

long InsertItem (
    long                parentItem,
    long                tvItem
);

Parameters

parentItem

ID of the parent item under which the new item should be placed as a child item. RootItem specifies the root of the tree view. If tvItem is RootItem, this parameter is ignored.

tvItem

The tree view item after which the new item should appear on the same hierarchy level. You can use the following predefined values, too.

Value	Meaning
RootItem	The new item will be the root of the tree view.
TopItem	Insert the new item at the top of the level below parentItem.
BottomItem	Insert the new item at the bottom of the level below parentItem.

Return Value

ID of the new tree view item, or NoItem if the function failed.

Description

Inserts an item to the tree view control.

The new item will have the following default properties:

Property	Value
Color	The system default foreground (text) color.
Icon (normal)	NoIcon
Icon (state)	NoIcon
Long	0
Status	Enabled
Style	The style of the font of the tree view.
Text	empty