ComboBox.SelectedIndex Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define o índice que especifica o item atualmente selecionado.
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, setPublic Overrides Property SelectedIndex As IntegerValor de Propriedade
Um índice baseado em zero do item atualmente selecionado. Um valor de menos um (-1) é devolvido se nenhum item for 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 combinada.
Exemplos
O seguinte exemplo de código mostra como usar o método e SelectedIndex a FindString propriedade. O exemplo faz parte de um exemplo completo na ComboBox visão geral da 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
Observações
Esta propriedade indica o índice em base zero do item atualmente selecionado na lista de caixas combinadas. Definir um novo índice eleva o SelectedIndexChanged evento.
SelectedIndex, SelectedValue, e FormattingEnabled estão relacionados da seguinte forma:
Se FormattingEnabled for
false, SelectedIndex não será definido para -1 quando SelectedValue estiver em branco.Se FormattingEnabled for
true, SelectedIndex será definido para -1 quando SelectedValue estiver em branco.
Note
Para desmarcar o item atualmente selecionado, defina o SelectedIndex para -1. Não pode definir o SelectedIndex item ComboBox para -1 se o item for um item ligado a dados.