Compartilhar via

Visão geral do controle ListBox (Windows Forms)

Um controle do Windows Forms ListBox 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 ListBox controle. Quando a MultiColumn propriedade é definida como true, a caixa de listagem exibe itens em várias colunas e uma barra de rolagem horizontal é exibida. Quando a MultiColumn propriedade é 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 SelectionMode propriedade determina quantos itens de lista podem ser selecionados por vez.

Maneiras de alterar o controle ListBox

A SelectedIndex propriedade retorna um valor inteiro que corresponde ao primeiro item selecionado na caixa de listagem. Você pode alterar programaticamente o item selecionado alterando o SelectedIndex valor no código; o item correspondente na lista aparecerá 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 SelectedIndex valor será 0. Quando vários itens são selecionados, o SelectedIndex valor reflete o item selecionado que aparece primeiro na lista. A SelectedItem propriedade é 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 Items propriedade no momento do design.

Consulte também