ListBox Class

Represents a Windows control for displaying a list of items.

Usage

A ListBox control allows a user to select one or more items from a list, depending on the SelectionMode.

SelectionMode

A ListBox can be set to one of four selection modes:

None

Setting the select mode to None disables the selection of an item in the list. This should be used when the ListBox is solely for displaying a list, rather than an input.

One (default)

The One selection mode allows the user to select a single item from the list.

MultiSimple

The MultiSimple selection mode allows the user to select multiple items from the list using only the mouse. The selection of an item is a toggle of either selected or deselected.

MultiExtended

The MultiExtended selection mode allows the user to select multiple items from the list, but the user will need to use the Shift and/or Ctrl keys to do so. The arrow keys can also be used with the selection keys to select/deselect more than one item.

Notable Class Members

Inherits members from the Control Class.

Properties

Items - Gets the items of the ListBox.
SelectedIndex - When overridden in a derived class, gets or sets the zero-based index of the currently selected item.
SelectedIndices - Gets a collection that contains the zero-based indexes of all currently selected items in the ListBox.
SelectedItem - Gets or sets the currently selected item in the ListBox.
SelectedItems - Gets a collection containing the currently selected items in the ListBox.
SelectedValue - Gets or sets the value of the member property specified by the ValueMember property.
SelectMode - Gets or sets the method in which items are selected in the ListBox.

Methods

ClearSelection() - Unselects all items in the ListBox.

Events

SelectedIndexChanged - Occurs when the SelectedIndex property or the SelectedIndices collection has changed.
SelectedValueChanged - Occurs when the SelectedValue property changes.