ComboBox.SelectedIndex Propriedade

Definição

Obtém ou define o índice que especifica o item selecionado no momento.Gets or sets the index specifying the currently selected item.

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.A zero-based index of the currently selected item. Um valor de um negativo (-1) é retornado se nenhum item é selecionado.A value of negative one (-1) is returned if no item is selected.

Atributos

Exceções

O índice especificado é menor ou igual a -2.The specified index is less than or equal to -2.

- ou --or-

O índice especificado é maior ou igual ao número de itens na caixa de combinação.The specified index is greater than or equal to the number of items in the combo box.

Exemplos

O exemplo de código a seguir mostra como usar o FindString método e a SelectedIndex propriedade.The following code example show how to use the FindString method and SelectedIndex property. O exemplo faz parte de um exemplo completo na ComboBox classe visão geral.The example is part of a complete example in the ComboBox class overview.

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

This property indicates the zero-based index of the currently selected item in the combo box list. A definição de um novo índice gera o SelectedIndexChanged evento.Setting a new index raises the SelectedIndexChanged event.

SelectedIndex, SelectedValue e FormattingEnabled são relacionados da seguinte maneira:SelectedIndex, SelectedValue, and FormattingEnabled are related as follows:

Observação

Para desmarcar o item selecionado no momento, defina SelectedIndex como-1.To deselect the currently selected item, set the SelectedIndex to -1. Você não poderá definir o SelectedIndex de um ComboBox Item como-1 se o item for um item associado a dados.You cannot set the SelectedIndex of a ComboBox item to -1 if the item is a data-bound item.

Aplica-se a

Confira também