InsertItemFirst

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

Syntax 1 For TreeView controls

When you need to specify more than the item label and picture index

Syntax 2 For TreeView controls


Syntax 1 For TreeView controls

Description

Inserts an item as the first child of its parent.

Applies to

TreeView controls

Syntax

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.

Returns

Long. Returns the handle of the item inserted if it succeeds and -1 if an error occurs.

Examples

Example 1

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)

See also


Syntax 2 For TreeView controls

Description

Inserts an item as the first child of an item.

Applies to

TreeView controls

Syntax

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.

Returns

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

Example 2

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)

See also