ListBox.SelectedItem Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define o item selecionado atualmente no ListBox.

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

Um objeto que representa a seleção atual no controle.

Atributos

BindableAttribute BrowsableAttribute

Exemplos

O exemplo de código a seguir demonstra como usar o SelectedIndexChanged evento para pesquisar e selecionar um item em um controle diferente ListBox . O exemplo usa o SelectedIndexChanged evento para determinar quando o item selecionado no ListBox é alterado. Em seguida, o código de exemplo lê o texto do item usando a SelectedItem propriedade e chama o FindString método em um diferente ListBox usando o texto retornado por SelectedItem no primeiro ListBox. Se um item for encontrado no outro ListBox, o item será selecionado. Este exemplo requer que dois ListBox controles, chamados listBox1 e listBox2, tenham sido adicionados a um formulário e que ambos os ListBox controles contenham itens idênticos. O exemplo também requer que o método de manipulação de eventos definido no exemplo esteja conectado ao SelectedIndexChanged evento de listBox1.

private:
   void listBox1_SelectedIndexChanged( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      // Get the currently selected item in the ListBox.
      String^ curItem = listBox1->SelectedItem->ToString();

      // Find the string in ListBox2.
      int index = listBox2->FindString( curItem );

      // If the item was not found in ListBox 2 display a message box,
      //  otherwise select it in ListBox2.
      if ( index == -1 )
            MessageBox::Show( "Item is not available in ListBox2" );
      else
            listBox2->SetSelected( index, true );
   }

private void listBox1_SelectedIndexChanged(object sender, System.EventArgs e)
{
   // Get the currently selected item in the ListBox.
   string curItem = listBox1.SelectedItem.ToString();

   // Find the string in ListBox2.
   int index = listBox2.FindString(curItem);
   // If the item was not found in ListBox 2 display a message box, otherwise select it in ListBox2.
   if(index == -1)
      MessageBox.Show("Item is not available in ListBox2");
   else
      listBox2.SetSelected(index,true);
}

Private Sub listBox1_SelectedIndexChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles listBox1.SelectedIndexChanged
   ' Get the currently selected item in the ListBox.
   Dim curItem As String = listBox1.SelectedItem.ToString()

   ' Find the string in ListBox2.
   Dim index As Integer = listBox2.FindString(curItem)
   ' If the item was not found in ListBox 2 display a message box, otherwise select it in ListBox2.
   If index = -1 Then
      MessageBox.Show("Item is not available in ListBox2")
   Else
      listBox2.SetSelected(index, True)
   End If
End Sub

Comentários

Para um padrão ListBox, você pode usar essa propriedade para determinar qual item está selecionado no ListBox. Se a SelectionMode propriedade do ListBox estiver definida como SelectionMode.MultiSimple ou SelectionMode.MultiExtended (o que indica uma seleção ListBoxmúltipla ) e vários itens forem selecionados na lista, essa propriedade poderá retornar qualquer item selecionado.

Para recuperar uma coleção que contém todos os itens selecionados em uma seleção ListBoxmúltipla, use a SelectedItems propriedade . Se você quiser obter a posição de índice do item selecionado no momento no ListBox, use a SelectedIndex propriedade . Além disso, você pode usar a SelectedIndices propriedade para obter todos os índices selecionados em uma seleção ListBoxmúltipla.