Общие сведения об элементе управления ListBox (Windows Forms)

Обновлен: Ноябрь 2007

Элемент управления Windows Forms ListBox отображает список элементов, в котором пользователь может выбрать один или несколько элементов. Если не все элементы могут одновременно отобразиться в поле списка, к элементу управления ListBox автоматически добавляется полоса прокрутки. Если для свойства MultiColumn задано значение true, элементы списка отображаются в нескольких столбцах и появляется горизонтальная полоса прокрутки. Если для свойства MultiColumn задано значение false, элементы списка отображаются в одном столбце и появляется вертикальная полоса прокрутки. Если для ScrollAlwaysVisible задано значение true, полоса прокрутки появляется независимо от числа элементов. Свойство SelectionMode определяет, сколько элементов списка можно выбрать одновременно.

Способы изменения элемента управления ListBox

Свойство SelectedIndex возвращает целочисленное значение, соответствующее первому выбранному элементу списка. Выбранный элемент можно изменить программными средствами, изменив в коде значение SelectedIndex; соответствующий элемент списка будет выделен в форме Windows. Если выбранных элементов нет, значение SelectedIndex равно -1. Если выбран первый элемент в списке, значение свойства SelectedIndex равно 0. Если выбрано несколько элементов, значение свойства SelectedIndex отражает выбранный элемент, появляющийся первым в списке. Свойство SelectedItem аналогично свойству SelectedIndex, но возвращает сам элемент, обычно в виде строкового значения. Свойство Count отражает число элементов в списке, а значение свойства Count всегда на единицу больше максимально возможного значения свойства SelectedIndex, поскольку для свойства SelectedIndex индексация ведется от нуля.

Чтобы добавить или удалить элементы в элементе управления ListBox, используйте метод Add, Insert, Clear или Remove. Кроме того, можно добавить элементы в список с помощью свойства Items во время разработки.

См. также

Задачи

Практическое руководство. Добавление и удаление элементов, отображаемых в элементах управления ComboBox, ListBox и CheckedListBox в Windows Forms

Практическое руководство. Сортировка содержимого элемента управления ComboBox, ListBox или CheckedListBox в Windows Forms

Практическое руководство. Связывание элемента управления ComboBox или ListBox с данными в Windows Forms

Ссылки

Общие сведения об элементе управления ComboBox (Windows Forms)

Общие сведения об элементе управления CheckedListBox (Windows Forms)

ListBox

Другие ресурсы

Создание списка для выбора элементов в Windows Forms