ComboBox.SelectedIndex Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
O índice baseado em zero do item selecionado no momento. Um valor de um negativo (-1) é retornado se nenhum item é selecionado.
- Atributos
Exceções
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.