Item de vários controles: Trabalhar com controles ComboBox e ListBox

Artigo
08/25/2010

Nesta lição, você aprenderá como adicionar itens e remover itens de listas.Você também aprenderá a executar uma ação quando um usuário seleciona um item em uma lista.

Quando você deseja fornecer aos usuários uma lista de opções, você pode exibir a lista de itens em um controle ListBox ou em um controle ComboBox.

Um controle ListBox permite que você exiba vários itens ao mesmo tempo, permitindo que os usuários rolem uma lista maior.Quando um usuário seleciona um item, ele fica realçado na lista, como mostra a ilustração a seguir.

Controle ListBox

Um controle ComboBox é uma combinação de uma caixa de texto e um caixa de listagem.Por padrão, a caixa de combinação é exibida como um caixa de texto, mas quando os usuários clicam na seta suspensa, é exibida uma lista.Quando um usuário seleciona um item, ele fica realçado e está visível na exibição padrão, como mostra a ilustração a seguir.

Controle ComboBox

Os processos para adicionar itens a caixas de listagem e caixas de combinação são semelhantes.Você pode usar o método Add do controle ListBox e o método Add do controle ComboBox para adicionar itens.

Tente-o!

Para adicionar itens a uma caixa de listagem

On the Arquivo menu, clicar Novo projeto.

A caixa de diálogo New Project será exibida.
Clique em Windows Forms Application e em seguida, clique em OK .

Abre um novo projeto Windows Forms.
Adicionar um ListBox controle ao formulário, deixando o nome padrão, ListBox1.
Clique duas vezes no formulário para adicionar o manipulador de eventos padrão no Editor de Códigos.

No manipulador de eventos Form_Load, adicione o código a seguir para adicionar itens à lista.

With Me.ListBox1.Items
    .Add("red")
    .Add("blue")
    .Add("green")
    .Add("yellow")
    .Add("orange")
    .Add("pink")
    .Add("brown")
    .Add("black")
End With

Pressione F5 para executar a página.

O formulário é aberto e exibe uma ListBox que contém uma lista de cores.
Feche o programa.

Executar uma ação quando o item selecionado for alterado

Você pode executar uma ação, como exibir uma cor, quando o usuário seleciona o item correspondente em um caixa de listagem.Para fazer isso, você escreve código no manipulador de eventos SelectedIndexChanged de ListBox.Há também um evento correspondente para o controle ComboBox.

Você pode determinar qual item na lista está selecionado usando a propriedade SelectedItem.Você pode atribuir a cor selecionada na lista para a propriedade BackColor de um controle usando o método FromName do objeto Color.

Para exibir a cor selecionada na caixa de listagem

Adicionar um TextBox controle ao formulário, deixando o nome padrão TextBox1.
Clique duas vezes no controle ListBox para adicionar o manipulador de eventos padrão no Editor de Códigos.
No manipulador de eventos ListBox_SelectedIndexChanged, adicione o seguinte código para exibir a cor na caixa de texto.Certifique-se que a variável ColorName contém um valor antes de atribuí-la à propriedade BackColor da caixa de texto.
```
Dim ColorName As String = CStr(ListBox1.SelectedItem)

If ColorName IsNot Nothing Then
    Me.TextBox1.BackColor = _
        System.Drawing.Color.FromName(ColorName)
End If
```
Pressione F5 para executar a página.
Quando o formulário for aberto, clique em um item da caixa de listagem para ver a cor selecionada exibida na caixa de texto.
Feche o programa.

Verificando se um item na lista existe

Quando você adiciona itens a uma lista, geralmente não deseja duplicar um item existente.Por exemplo, você pode querer que os usuários possam copiar um item na caixa de listagem para uma caixa de combinação clicando duas vezes no item.Se o item já estiver no caixa de combinação, ele não deve ser adicionado novamente.Você pode usar o método Contains para determinar se o item já está na caixa de combinação.Há também um método Contains correspondente para a caixa de listagem.

Para adicionar itens a uma caixa de combinação

Adicionar um ComboBox controle ao formulário, deixando o nome padrão, ComboBox1.
Abra o Editor de Código clicando com o botão direito do mouse no formulário e clicando em View Code.
No Editor de códigos, na lista suspensa Nome de Classe , clique em ListBox1 .
Na lista suspensa Method Name, clique em DoubleClick para criar o manipulador de eventos.

No manipulador de eventos ListBox1_DoubleClick, adicione o código a seguir para adicionar itens à caixa de combinação.Como você pode ter um caixa de listagem vazia, verifique se o item selecionado não está vazio antes de adicioná-lo.

If ListBox1.SelectedItem IsNot Nothing Then
    If Not ComboBox1.Items.Contains(Me.ListBox1.SelectedItem) Then
        Me.ComboBox1.Items.Add(Me.ListBox1.SelectedItem)
    End If

    Me.ComboBox1.SelectedItem = Me.ListBox1.SelectedItem

End If

Pressione F5 para executar a página.

Clique duas vezes em itens da caixa de listagem e verifique se eles são adicionados à caixa de combinação apenas uma vez.
Feche o programa.

Excluindo um item de uma caixa de listagem

Você pode excluir um item de uma caixa de listagem usando o método Remove.Por exemplo, em vez de copiar itens de uma caixa de listagem para um caixa de combinação, você pode decidir movê-los.Você pode mover um item primeiramente adicionando-o à caixa de combinação e, em seguida, excluindo-o a partir da caixa de listagem.

Para excluir itens de uma caixa de listagem

Adicione o seguinte código acima da declaração End If do manipulador de eventos ListBox_DoubleClick.
```
Me.ListBox1.Items.Remove(Me.ListBox1.SelectedItem)
```
Pressione F5 para executar a página.
Clique duas vezes em itens da caixa de listagem e verifique se eles são removidos da caixa de listagem e adicionados à caixa de combinação.

Próximas etapas

Nesta lição, você aprendeu como adicionar itens e remover itens de listas.Você também aprendeu como executar uma ação quando um usuário seleciona um item.Na próxima lição, você aprenderá a usar controles que exibem a data e hora.

Próxima Lesson: Exibição de datas: Usando MonthCalendar e DateTimePicker controles