Visão geral do controle ComboBox (Windows Forms)

O controle ComboBox do Windows Forms é usado para exibir dados em uma caixa de combinação suspensa. Por padrão, o controle ComboBox aparece em duas partes: a parte superior é uma caixa de texto que permite que o usuário digite um item de lista. A segunda parte é uma caixa de listagem que exibe uma lista de itens dos quais o usuário pode selecionar um. Para obter mais informações sobre outros estilos de caixa de combinação, consulte Quando usar um ComboBox do Windows Forms em vez de um ListBox.

A propriedade SelectedIndex retorna um valor inteiro que corresponde ao item de lista selecionado. Você pode alterar programaticamente o item selecionado alterando o valor SelectedIndex no código; o item correspondente na lista será exibido na parte da caixa de texto da caixa de combinação. Se nenhum item estiver selecionado, o valor SelectedIndex será -1. Se o primeiro item da lista estiver selecionado, o valor SelectedIndex será 0. A propriedade SelectedItem é semelhante a SelectedIndex, mas retorna o item em si, geralmente um valor de cadeia de caracteres. A propriedade Count reflete o número de itens na lista e o valor da propriedade Count é sempre um a mais do que o maior valor de SelectedIndex possível porque SelectedIndex é baseado em zero.

Para adicionar ou excluir itens em um controle ComboBox, use o método Add, Insert, Clear ou Remove. Como alternativa, você pode adicionar itens à lista usando a propriedade Items no designer.

Consulte também

• ComboBox
• Visão geral do ListBox Control
• Quando usar um ComboBox do Windows Forms em vez de um ListBox
• Como adicionar e remover itens de um controle ComboBox, ListBox ou CheckedListBox do Windows Forms
• Como classificar o conteúdo de um controle ComboBox, ListBox ou CheckedListBox do Windows Forms
• Como acessar itens específicos em um controle ComboBox, ListBox ou CheckedListBox do Windows Forms
• Como vincular um controle ComboBox ou ListBox do Windows Forms a dados
• Controles do Windows Forms que são usados para listar opções
• Como criar uma tabela de pesquisa para um controle ComboBox, ListBox ou CheckedListBox do Windows Forms