Visão geral do controle ListBox (Windows Forms)

  • Artigo

Um controle do Windows Forms ListBox 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 ListBox controle. Quando a propriedade é definida como true, a MultiColumn caixa de listagem exibe itens em várias colunas e uma barra de rolagem horizontal é exibida. Quando a propriedade é definida como false, a MultiColumn 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 aparece 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 valor no código, o SelectedIndex item correspondente na lista aparecerá realçado no Windows Form. Se nenhum item for selecionado, o SelectedIndex valor será -1. Se o primeiro item da lista estiver selecionado, o SelectedIndex valor será 0. Quando vários itens são selecionados, o valor reflete o SelectedIndex 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 Count propriedade reflete o número de itens na lista, e o valor da Count propriedade é sempre um a mais do que o maior valor possível SelectedIndex porque SelectedIndex é baseado em zero.

Para adicionar ou excluir itens em um ListBox controle, use o Addmétodo , InsertClear ou Remove . Como alternativa, você pode adicionar itens à lista usando a Items propriedade em tempo de design.

Confira também