Inserts an item as the first child of a parent item.
To insert an item as the first child of its parent |
Use |
---|---|
When you only need to specify the item label and picture index |
|
When you need to specify more than the item label and picture index |
Inserts an item as the first child of its parent.
TreeView controls
treeviewname.InsertItemFirst ( handleparent, label, pictureindex )
Argument |
Description |
---|---|
treeviewname |
The TreeView control in which you want to specify an item as the first child of its parent. |
handleparent |
The handle of the item that will be the inserted item’s parent. To insert the item at the first level, specify 0. |
label |
The label of the item you want to specify as the first child of its parent. |
pictureindex |
The picture index for the item you want to specify as the first child of its parent. |
Long. Returns the handle of the item inserted if it succeeds and -1 if an error occurs.
This example populates the first level of a TreeView using InsertItemFirst:
long ll_lev1, ll_lev2 ,ll_lev3 ,ll_lev4
int index
tv_list.PictureHeight = 32
tv_list.PictureWidth = 32
ll_lev1 = tv_list.InsertItemFirst(0,"Composers",1)
ll_lev2 = tv_list.InsertItemLast(ll_lev1, &
"Beethoven",2)
ll_lev3 = tv_list.InsertItemLast(ll_lev2, &
"Symphonies", 3)
FOR index = 1 to 9
ll_lev4 = tv_list.InsertItemSort(ll_lev3, &
"Symphony # " + String(index) , 4)
NEXT
tv_list.ExpandItem(ll_lev3)
tv_list.ExpandItem(ll_lev4)
Inserts an item as the first child of an item.
TreeView controls
treeviewname.InsertItemFirst ( handleparent, item )
Argument |
Description |
---|---|
treeviewname |
The TreeView control in which you want to specify an item as the first child of its parent. |
handleparent |
The handle of the item that will be the inserted item’s parent. To insert the item at the first level, specify 0. |
item |
A TreeViewItem structure for the item you are inserting. |
Long. Returns the handle of the item inserted if it succeeds and -1 if an error occurs.
If SortType is anything except Unsorted!, items are sorted after they are added and the TreeView is always in a sorted state. Therefore, calling InsertItemFirst, InsertItemLast, and InsertItemSort produces the same result.
This example inserts the current item as the first item beneath the root item in a TreeView control:
long ll_handle, ll_roothandle
treeviewitem l_tvi
ll_handle = tv_list.FindItem(CurrentTreeItem!, 0)
ll_roothandle = tv_list.FindItem(RootTreeItem!, 0)
tv_list.GetItem(ll_handle , l_tvi)
tv_list.InsertItemFirst(ll_roothandle, l_tvi)