Partilhar via


Visão geral do controle ComboBox (Windows Forms)

O controle ComboBox 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 ao usuário digitar um item de lista. A segunda parte é uma caixa de listagem que exibe uma lista de itens a partir dos quais o usuário pode selecionar um. Para obter mais informações sobre outros estilos de caixa de combinação, consulte Quando usar uma caixa de combinação do Windows Forms em vez de uma caixa de listagem.

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 aparecerá na área de texto da caixa de combinação. Se nenhum item for selecionado, o valor SelectedIndex será -1. Se o primeiro item da lista for 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 é baseada 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.

Ver também