Inserts a child item in sorted order under the parent item.
To insert an item in sorted order |
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 in sorted order, if possible.
TreeView controls
treeviewname.InsertItemSort ( handleparent, label, pictureindex )
Argument |
Description |
|---|---|
treeviewname |
The TreeView control in which you want to insert and sort an item as a child of its parent, according to its label. |
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 by which you want to sort the item as a child of its parent. |
pictureindex |
The picture index for the item you want to sort as a child of its parent, according to its label. |
Long. Returns the handle of the item inserted if it succeeds and -1 if an error occurs.
If SortType is anything except Unsorted!, the TreeView is always in a sorted state and you do not need to use InsertItemSort—you can use any insert function.
If SortType is Unsorted!, InsertItemSort attempts to insert the item at the correct place in alphabetic ascending order. If the list is out of order, it does its best to find the correct place, but results may be unpredictable.
This example populates the fourth level of a TreeView control:
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)
Inserts an item in sorted order, if possible.
TreeView controls
treeviewname.InsertItemSort ( handleparent, item )
Argument |
Description |
|---|---|
treeviewname |
The TreeView control in which you want to sort an item as a child of its parent, according to its label. |
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!, the TreeView is always in a sorted state and you do not need to use InsertItemSort—you can use any insert function.
If SortType is Unsorted!, InsertItemSort attempts to insert the item at the correct place in alphabetic ascending order. If the list is out of order, it does its best to find the correct place, but results may be unpredictable.
This example inserts the current item beneath the root item in a TreeView control and sorts it according to its label:
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.InsertItemSort(ll_roothandle, l_tvi)
