Compartilhar via


ListBox controle visão geral (Windows Forms)

Um Windows Forms ListBox controle 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 um BAR de rolar é adicionado automaticamente ao ListBox controle. Quando o MultiColumn propriedade estiver definida como true, o lista caixa exibe itens em várias colunas e uma BAR de rolar horizontal aparece. Quando o MultiColumn propriedade estiver definida como false, o lista caixa exibe itens em uma única coluna e uma BAR de rolar vertical aparece. Quando ScrollAlwaysVisible é definido como true, a BAR de rolar aparece independentemente do número de itens. The SelectionMode propriedade determina quantos itens de lista podem ser selecionados ao mesmo time.

Maneiras de alterar o controle ListBox

The 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 Windows formulário. Se nenhum item estiver selecionado, a SelectedIndex valor é -1. Se o primeiro item na lista estiver selecionado, a SelectedIndex valor é 0. Quando vários itens são selecionados, a SelectedIndex valor reflete o item selecionado é exibido primeiro na lista. The SelectedItem propriedade é semelhante à SelectedIndex, mas retorna o item propriamente dito, normalmente um valor de seqüência de caracteres. The Count propriedade reflete o número de itens na lista e o valor da Count propriedade é sempre um mais do que o maior possível SelectedIndex porque SelectedIndex é baseada em zero.

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

Consulte também

Tarefas

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

Como: Classificar o Sumário de um Windows Forms ComboBox, ListBox ou CheckedListBox controle

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

Referência

Visão geral do ComboBox controle (Windows Forms)

Controle CheckedListBox visão geral (Windows Forms)

ListBox

Outros recursos

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