Inserts an item as the last child of a parent item.
Description
Inserts an item as the last child of its parent.
Applies to
TreeView controls
Syntax
treeviewname.InsertItemLast ( handleparent, label, pictureindex )
|
Argument |
Description |
|---|---|
|
treeviewname |
The TreeView control in which you want to specify an item as the last 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 last child of its parent. |
|
pictureindex |
The picture index for the item you want to specify as the last child of its parent. |
Return value
Long.
Returns the handle of the item inserted if it succeeds and -1 if an error occurs.
Usage
If more than the item label and Index need to be specified, use syntax 2.
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.
Examples
This example populates the first three levels of a TreeView using InsertItemLast:
long ll_lev1, ll_lev2, ll_lev3, ll_lev4 int index tv_list.PictureHeight = 32 tv_list.PictureWidth = 32 ll_lev1 = tv_list.InsertItemLast(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)
See also
Description
Inserts an item as the last child of its parent.
Applies to
TreeView controls
Syntax
treeviewname.InsertItemLast ( handleparent, item )
|
Argument |
Description |
|---|---|
|
treeviewname |
The TreeView control in which you want to specify an item as the last 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. |
Return value
Long.
Returns the handle of the item inserted if it succeeds and -1 if an error occurs.
Usage
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.
Examples
This example inserts the current item as the last 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.InsertItemLast(ll_roothandle, l_tvi)
See also
