ComboBox.SelectedIndex Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Возвращает или задает индекс, указывающий текущий выделенный элемент.

public:
 virtual property int SelectedIndex { int get(); void set(int value); };

[System.ComponentModel.Browsable(false)]
public override int SelectedIndex { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.SelectedIndex : int with get, set

Public Overrides Property SelectedIndex As Integer

Значение свойства

Int32

Индекс текущего выделенного элемента (индексация ведется с нуля). Если элемент не выбран, возвращается отрицательное значение (-1).

Атрибуты

BrowsableAttribute

Исключения

ArgumentOutOfRangeException

Указанный индекс меньше или равен -2.

-или-

Указанный индекс больше или равен числу элементов в поле со списком.

Примеры

В следующем примере кода показано, как использовать FindString метод и SelectedIndex свойство . Этот пример является частью полного примера в обзоре ComboBox класса.

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

private void findButton_Click(object sender, System.EventArgs e) {
    int index = comboBox1.FindString(textBox2.Text);
    comboBox1.SelectedIndex = index;
}

Private Sub findButton_Click(ByVal sender As Object, ByVal e As System.EventArgs)
    Dim index As Integer
    index = comboBox1.FindString(textBox2.Text)
    comboBox1.SelectedIndex = index
End Sub

Комментарии

Это свойство указывает отсчитываемый от нуля индекс текущего выбранного элемента в списке полей со списком. При задании нового индекса возникает SelectedIndexChanged событие .

SelectedIndex, SelectedValueи FormattingEnabled связаны следующим образом:

• Если FormattingEnabled имеет значение false, SelectedIndex не будет иметь значение -1, если SelectedValue значение пусто.

• Если FormattingEnabled имеет значение true, SelectedIndex будет задано значение -1, если SelectedValue значение пусто.

Примечание

Чтобы отменить выбор выбранного элемента, задайте для параметра SelectedIndex значение -1. Для элемента нельзя задать SelectedIndexComboBox значение -1, если элемент является элементом с привязкой к данным.

См. также раздел

• Position
• FormattingEnabled
• SelectedValue