Finds and highlights an item in a ListBox, DropDownListBox, or TreeView control.
To select an item |
Use |
|---|---|
In a ListBox control when you know the text of the item, but not its position |
|
In a ListBox control when you know the position of the item in the control’s list, or to clear the current selection |
|
In a TreeView control |
Finds and highlights an item in a ListBox when you can specify some or all of the text of the item.
ListBox, DropDownListBox, PictureListBox, and DropDownPictureListBox controls
listboxname.SelectItem ( item, index )
Argument |
Description |
|---|---|
listboxname |
The name of the ListBox control in which you want to select a line |
item |
A string whose value is the starting text of the item you want to select |
index |
The number of the item after which you want to begin the search |
Integer. Returns the index number of the selected item. If no match is found, SelectItem returns 0; it returns -1 if an error occurs. If any argument’s value is null, SelectItem returns null.
SelectItem begins searching for the desired item after the item identified by index. To match, the item must start with the specified text; however, the text in the item can be longer than the specified text.
To find an item but not select it, use the FindItem function.
MultiSelect ListBoxes
SelectItem has no effect on a ListBox or
PictureListBox whose MultiSelect property is true.
Instead, use SetState to select items without
affecting the selected state of other items in the list.
Clearing the edit box of a drop-down list
To clear the edit box of a DropDownListBox or DropDownPictureListBox
that the user cannot edit, use Syntax 2 of SelectItem.
If item 5 in lb_Actions is Delete Files, this example starts searching after item 2, finds and highlights Delete Files, and sets li_Index to 5:
integer li_Index
li_Index = lb_Actions.SelectItem("Delete Files", 2)
If item 4 in lb_Actions is Select Objects, this example starts searching after item 2, finds and highlights Select Objects, and sets li_Index to 4:
integer li_Index
li_Index = lb_Actions.SelectItem("Sel", 2)
Finds and highlights an item in a ListBox when you can specify the index number of the item. You can also clear the selection by specifying zero as the index number.
ListBox, DropDownListBox, PictureListBox, and DropDownPictureListBox controls
listboxname.SelectItem ( itemnumber )
Argument |
Description |
|---|---|
listboxname |
The name of the ListBox control in which you want to select an item |
itemnumber |
An integer whose value is the location (index) of the item in the ListBox or the ListBox portion of the drop-down list. Specify 0 for itemnumber to clear the selected item. For a ListBox or PictureListBox, 0 removes highlighting from the selected item. For a DropDownListBox or DropDownPictureListBox, 0 clears the text box. |
Integer. Returns the index number of the selected item. SelectItem returns 0 if itemnumber is not valid or if you specified 0 in order to clear the selected item. It returns -1 if an error occurs. If any argument’s value is null, SelectItem returns null.
To find an item but not select it, use the FindItem function.
MultiSelect ListBoxes
SelectItem has no effect on a ListBox or
PictureListBox whose MultiSelect property is true.
Instead, use SetState to select items without
affecting the selected state of other items in the list.
Clearing the text box of a drop-down list
To clear the text box of a DropDownListBox or DropDownPictureListBox
that the user cannot edit, set itemnumber to
0. Setting the control’s text to the empty string does
not work if the control’s AllowEdit property is false.
This example highlights item number 5:
integer li_Index
li_Index = lb_Actions.SelectItem(5)
This example clears the selection from the text box of the DropDownListBox ddlb_choices and sets li_Index to 0:
integer li_Index
li_Index = ddlb_choices.SelectItem(0)
Selects a specified item.
TreeView controls
treeviewname.SelectItem ( itemhandle )
Argument |
Description |
|---|---|
treeviewname |
The name of the TreeView control in which you want to select an item |
itemhandle |
The handle of the specified item |
Integer. Returns 1 if it succeeds and -1 if an error occurs.
Use the FindItem function to get handles for items at specific positions in the TreeView control.
This example selects the parent of the current TreeView item:
long ll_tvi, ll_tvparent
int li_tvret
ll_tvi = tv_list.FindItem(CurrentTreeItem! , 0)
ll_tvparent = tv_list.FindItem(ParentTreeItem! , &
ll_tvi)
li_tvret = tv_list.SelectItem(ll_tvparent)
