ComboBox.SelectedIndex Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define o índice que especifica o item selecionado no momento.

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

Valor da propriedade

Int32

O índice baseado em zero do item selecionado no momento. Um valor de um negativo (-1) é retornado se nenhum item é selecionado.

Atributos

BrowsableAttribute

Exceções

ArgumentOutOfRangeException

O índice especificado é menor ou igual a -2.

- ou -

O índice especificado é maior ou igual ao número de itens na caixa de combinação.

Exemplos

O exemplo de código a seguir mostra como usar o método e SelectedIndex a FindString propriedade . O exemplo faz parte de um exemplo completo na visão geral da ComboBox classe.

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

Comentários

Essa propriedade indica o índice baseado em zero do item selecionado no momento na lista de caixas de combinação. A configuração de um novo índice gera o SelectedIndexChanged evento.

SelectedIndex, SelectedValuee FormattingEnabled estão relacionados da seguinte maneira:

• Se FormattingEnabled for false, SelectedIndex não será definido como -1 quando SelectedValue estiver em branco.

• Se FormattingEnabled for true, SelectedIndex será definido como -1 quando SelectedValue estiver em branco.

Observação

Para desmarcar o item selecionado no momento, defina como SelectedIndex -1. Você não poderá definir o SelectedIndex de um ComboBox item como -1 se o item for um item associado a dados.

Confira também

• Position
• FormattingEnabled
• SelectedValue