Partilhar via

Visão geral do controle ListBox (Windows Forms)

  • Artigo

Um controle ListBox Windows Forms exibe uma lista a partir 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 aparece. Quando a propriedade MultiColumn é definida como false, a caixa de listagem exibe itens em uma única coluna e uma barra de rolagem vertical aparece. Quando ScrollAlwaysVisible está definido como true, a barra de rolagem aparece independentemente do número de itens. A propriedade SelectionMode determina quantos itens de lista podem ser selecionados de cada 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 aparecerá realçado no Windows Form. Se nenhum item for selecionado, o valor SelectedIndex será -1. Se o primeiro item da lista for 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 é baseada 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.

Ver também