Visão geral do controle ListBox (Windows Forms)ListBox Control Overview (Windows Forms)

Um Windows Forms ListBox controle exibe uma lista da qual o usuário pode selecionar um ou mais itens.A Windows Forms ListBox control displays a list from which the user can select one or more items. Se o número total de itens exceder o número que pode ser exibido, uma barra de rolagem é adicionada automaticamente para o ListBox controle.If the total number of items exceeds the number that can be displayed, a scroll bar is automatically added to the ListBox control. Quando o MultiColumn estiver definida como true, a caixa de listagem exibirá itens em várias colunas e uma barra de rolagem horizontal é exibida.When the MultiColumn property is set to true, the list box displays items in multiple columns and a horizontal scroll bar appears. Quando o MultiColumn estiver definida como false, a caixa de listagem exibirá itens em uma única coluna e uma barra de rolagem vertical é exibida.When the MultiColumn property is set to false, the list box displays items in a single column and a vertical scroll bar appears. Quando ScrollAlwaysVisible é definido como true, a barra de rolagem é exibida, independentemente do número de itens.When ScrollAlwaysVisible is set to true, the scroll bar appears regardless of the number of items. O SelectionMode propriedade determina quantos itens de lista podem ser selecionados por vez.The SelectionMode property determines how many list items can be selected at a time.

Maneiras de alterar o controle ListBoxWays to Change the ListBox Control

O SelectedIndex propriedade retorna um valor inteiro que corresponde ao primeiro item selecionado na caixa de listagem.The SelectedIndex property returns an integer value that corresponds to the first selected item in the list box. Você pode alterar programaticamente o item selecionado, alterando o SelectedIndex valor em código; o item correspondente na lista será exibido realçado no formulário do Windows.You can programmatically change the selected item by changing the SelectedIndex value in code; the corresponding item in the list will appear highlighted on the Windows Form. Se nenhum item for selecionado, o SelectedIndex valor é -1.If no item is selected, the SelectedIndex value is -1. Se o primeiro item na lista é selecionado, o SelectedIndex valor é 0.If the first item in the list is selected, the SelectedIndex value is 0. Quando vários itens são selecionados, o SelectedIndex valor reflete o item selecionado que aparece primeiro na lista.When multiple items are selected, the SelectedIndex value reflects the selected item that appears first in the list. O SelectedItem propriedade é semelhante à SelectedIndex, mas retorna o item em si, geralmente um valor de cadeia de caracteres.The SelectedItem property is similar to SelectedIndex, but returns the item itself, usually a string value. O 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 valor porque SelectedIndex é baseado em zero.The Count property reflects the number of items in the list, and the value of the Count property is always one more than the largest possible SelectedIndex value because SelectedIndex is zero-based.

Para adicionar ou excluir itens em uma ListBox controlar, use o Add, Insert, Clear ou Remove método.To add or delete items in a ListBox control, use the Add, Insert, Clear or Remove method. Como alternativa, você pode adicionar itens à lista usando o Items propriedade em tempo de design.Alternatively, you can add items to the list by using the Items property at design time.

Consulte tambémSee also