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 相關，如下所示：

• 如果 為 FormattingEnabledfalse ， SelectedIndex 當 為空白時 SelectedValue ，將不會設定為 -1。

• 如果 為 FormattingEnabledtrue ， SelectedIndex 當 為空白時 SelectedValue ，將會設定為 -1。

注意

若要取消選取目前選取的專案，請將 設定 SelectedIndex 為 -1。 如果專案是資料繫結專案，則無法將專案的 設定 SelectedIndexComboBox 為 -1。

另請參閱

• Position
• FormattingEnabled
• SelectedValue