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

  • Статья

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

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

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

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

См. также