ComboBox.SelectedIndex プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ComboBox.SelectedIndex プロパティ

現在選択されている項目を指定しているインデックスを取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Overrides Property
 SelectedIndex As Integer

Visual Basic (使用法)

Dim instance As ComboBox
Dim value As Integer

value = instance.SelectedIndex

instance.SelectedIndex = value

public override int SelectedIndex { get;
 set; }

C++

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

/** @property */
public int get_SelectedIndex ()

/** @property */
public void set_SelectedIndex (int
 value)

JScript

public override function get
 SelectedIndex () : int

public override function set
 SelectedIndex (value : int)

プロパティ値
現在選択されている項目の 0 から始まるインデックス。項目が選択されていない場合は、値 -1 が返されます。

例外

例外の種類	条件
ArgumentOutOfRangeException	指定されたインデックスが -2 以下です。または指定されたインデックスが、コンボボックスの項目数以上の値です。

例外の種類

条件

ArgumentOutOfRangeException

指定されたインデックスが -2 以下です。

または

指定されたインデックスが、コンボボックスの項目数以上の値です。

解説

このプロパティは、コンボボックスのリストで現在選択されている項目の 0 から始まるインデックス番号を示します。新しいインデックスを設定すると、SelectedIndexChanged イベントが発生します。

SelectedIndex、SelectedValue、および FormattingEnabled は、次のように関連します。

FormattingEnabled が false で、SelectedValue が空白の場合、SelectedIndex は -1 に設定されません。
FormattingEnabled が true で、SelectedValue が空白の場合、SelectedIndex は -1 に設定されます。

メモ
現在選択されている項目の選択を解除するには、SelectedIndex を -1 に設定します。ただし、データバインドされた ComboBox の項目の SelectedIndex は -1 に設定できません。

使用例

FindString メソッドと SelectedIndex プロパティを使用する方法を次のコード例に示します。この例は、ComboBox クラスの概要で取り上げている例の一部分です。

Visual Basic

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

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

C++

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.get_Text());
    comboBox1.set_SelectedIndex(index);
} //findButton_Click