ComboBox::SelectedIndex Property

 

Gets or sets the index specifying the currently selected item.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public:
[BrowsableAttribute(false)]
property int SelectedIndex {
	virtual int get() override;
	virtual void set(int value) override;
}

Property Value

Type: System::Int32

A zero-based index of the currently selected item. A value of negative one (-1) is returned if no item is selected.

Exception Condition
ArgumentOutOfRangeException

The specified index is less than or equal to -2.

-or-

The specified index is greater than or equal to the number of items in the combo box.

This property indicates the zero-based index of the currently selected item in the combo box list. Setting a new index raises the SelectedIndexChanged event.

SelectedIndex, SelectedValue, and FormattingEnabled are related as follows:

System_CAPS_noteNote

To deselect the currently selected item, set the SelectedIndex to -1. You cannot set the SelectedIndex of a ComboBox item to -1 if the item is a data-bound item.

The following code example show how to use the FindString method and SelectedIndex property. The example is part of a complete example in the ComboBox class overview.

void findButton_Click( Object^ sender, System::EventArgs^ e )
{
   int index = comboBox1->FindString( textBox2->Text );
   comboBox1->SelectedIndex = index;
}

.NET Framework
Available since 1.1
Return to top
Show: