ComboBox.SelectedIndex プロパティ

.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

C#

public override int SelectedIndex { get;
 set; }

C++

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

J#

/** @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 以下です。 または 指定されたインデックスが、コンボ ボックスの項目数以上の値です。

解説

このプロパティは、コンボ ボックスのリストで現在選択されている項目の 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

C#

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;
}

J#

private void findButton_Click(Object sender,
 System.EventArgs e)
{
    int index = comboBox1.FindString(textBox2.get_Text());
    comboBox1.set_SelectedIndex(index);
} //findButton_Click

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
ComboBox クラス
ComboBox メンバ
System.Windows.Forms 名前空間
Position
FormattingEnabled
SelectedValue