Compartilhar via

Visão geral do controle ListBox (Windows Forms)

  • Artigo

Um controle ListBox do Windows Forms exibe uma lista da qual o usuário pode selecionar um ou mais itens. Se o número total de itens exceder o número que pode ser exibido, uma barra de rolagem será adicionada automaticamente ao controle ListBox. Quando a propriedade MultiColumn é definida como true, a caixa de listagem exibe itens em várias colunas e uma barra de rolagem horizontal é exibida. Quando a propriedade MultiColumn é definida como false, a caixa de listagem exibe itens em uma única coluna e uma barra de rolagem vertical é exibida. Quando ScrollAlwaysVisible é definido como true, a barra de rolagem é exibida independentemente do número de itens. A propriedade SelectionMode determina quantos itens de lista podem ser selecionados por vez.

Maneiras de alterar o controle ListBox

A propriedade SelectedIndex retorna um valor inteiro que corresponde ao primeiro item selecionado na caixa de listagem. Você pode alterar programaticamente o item selecionado alterando o valor SelectedIndex no código; o item correspondente na lista será exibido realçado no Formulário do Windows. Se nenhum item estiver selecionado, o valor SelectedIndex será -1. Se o primeiro item da lista estiver selecionado, o valor SelectedIndex será 0. Quando vários itens são selecionados, o valor SelectedIndex reflete o item selecionado que aparece primeiro na lista. 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 ListBox, use o método Add, Insert, Clear ou Remove. Como alternativa, você pode adicionar itens à lista usando a propriedade Items em tempo de design.

Consulte também