ComboBox.SelectedItem Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define o item selecionado no momento no ComboBox.

public:
 property System::Object ^ SelectedItem { System::Object ^ get(); void set(System::Object ^ value); };

[System.ComponentModel.Bindable(true)]
[System.ComponentModel.Browsable(false)]
public object SelectedItem { get; set; }

[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.Browsable(false)>]
member this.SelectedItem : obj with get, set

Public Property SelectedItem As Object

Valor da propriedade

Object

O objeto que é o item selecionado no momento, ou null, se não houver nenhum item selecionado no momento.

Atributos

BindableAttribute BrowsableAttribute

Exemplos

O exemplo de código a seguir mostra o uso do e das SelectedIndex SelectedItem propriedades. O exemplo faz parte de um exemplo de código completo na visão geral da ComboBox classe.

void showSelectedButton_Click( Object^ sender, System::EventArgs^ e )
{
   int selectedIndex = comboBox1->SelectedIndex;
   Object^ selectedItem = comboBox1->SelectedItem;
   MessageBox::Show( "Selected Item Text: " + selectedItem->ToString() + "\n" +
      "Index: " + selectedIndex.ToString() );
}

private void showSelectedButton_Click(object sender, System.EventArgs e) {
    int selectedIndex = comboBox1.SelectedIndex;
    Object selectedItem = comboBox1.SelectedItem;

    MessageBox.Show("Selected Item Text: " + selectedItem.ToString() + "\n" +
                    "Index: " + selectedIndex.ToString());
}

Private Sub showSelectedButton_Click(ByVal sender As Object, ByVal e As System.EventArgs)
    Dim selectedIndex As Integer
    selectedIndex = comboBox1.SelectedIndex
    Dim selectedItem As Object
    selectedItem = comboBox1.SelectedItem

    MessageBox.Show("Selected Item Text: " & selectedItem.ToString() & Microsoft.VisualBasic.Constants.vbCrLf & _
                        "Index: " & selectedIndex.ToString())
End Sub

Comentários

Quando você define a SelectedItem propriedade como um objeto, as ComboBox tentativas de tornar esse objeto o selecionado atualmente na lista. Se o objeto for encontrado na lista, ele será exibido na parte de edição e ComboBox a SelectedIndex propriedade será definida como o índice correspondente. Se o objeto não existir na lista, a SelectedIndex propriedade será deixada no valor atual.

Observação

A ComboBox classe pesquisa o objeto especificado usando o IndexOf método. Esse método usa o Equals método para determinar a igualdade.