Compartilhar via


Visão geral do controle ListBox (Windows Forms)

Windows Forms ListBox controle exibe uma lista na qual o usuário pode selecionar um ou mais itens. Se o número total de itens excede o número que pode ser exibido, uma barra de rolagem é adicionada automaticamente para o ListBox de controle. Quando o MultiColumn for definida como true, a caixa de listagem exibe itens em várias colunas e uma barra de rolagem horizontal aparece. Quando o MultiColumn for definida como false, a caixa de listagem exibe itens em uma única coluna e uma barra de rolagem vertical aparece. Quando ScrollAlwaysVisible for definido como true, a barra de rolagem aparece independentemente do número de itens. O SelectionMode propriedade determina quantos itens de lista podem ser selecionados no momento.

Maneiras de alterar o controle ListBox

O SelectedIndex propriedade retorna um valor inteiro que corresponde ao primeiro item selecionado na caixa de lista. Você pode alterar programaticamente o item selecionado, alterando a SelectedIndex o valor em código; o item correspondente na lista aparecerá realçado no Windows Form. Se nenhum item esteja selecionado, o SelectedIndex valor é -1. Se o primeiro item na lista é selecionado, o SelectedIndex valor é 0. Quando vários itens são selecionados, o SelectedIndex valor reflete o item selecionado, que aparece em primeiro lugar na lista. O SelectedItem propriedade é semelhante a SelectedIndex, mas retorna o item em si, geralmente uma string value. O Count propriedade reflete o número de itens na lista e o valor da Count propriedade é sempre um mais do que a maior possível SelectedIndex valor pois SelectedIndex é baseada em zero.

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

Consulte também

Tarefas

Como: Adicionar e remover itens do Windows Forms ComboBox, ListBox, ou controle CheckedListBox

Como: Classificar o conteúdo de um ComboBox do Windows Forms, ListBox ou CheckedListBox controle

Como: Vincular um ComboBox do Windows Forms ou um controle ListBox a dados

Como: Criar uma tabela de pesquisa para um Windows Forms ComboBox, ListBox, ou controle CheckedListBox

Referência

Visão geral do controle ComboBox (Windows Forms)

Visão geral do controle CheckedListBox (Windows Forms)

ListBox

Outros recursos

Usado para opções da lista de controles do Windows Forms