List Controls

List controls covered in this section all inherit directly or indirectly from TListControl. Therefore, they share the same set of commonly used properties, including,

• Items - list of items in the control. The items are of type TListItem. The item list can be populated via databinding or specified in templates like the following: <com:TListBox> <com:TListItem Text="text 1" Value="value 1" /> <com:TListItem Text="text 2" Value="value 2" Selected="true" /> <com:TListItem Text="text 3" Value="value 3" /> </com:TListBox>
• SelectedIndex - the zero-based index of the first selected item in the item list.
• SelectedIndices - the indices of all selected items.
• SelectedItem - the first selected item in the item list.
• SelectedValue - the value of the first selected item in the item list.
• AutoPostBack - whether changing the selection of the control should trigger postback.
• CausesValidation - whether validation should be performed when postback is triggered by the list control.

Since TListControl inherits from TDataBoundControl, these list controls also share a common operation known as databinding. The data to be bound can be specified via either DataSource or DataSourceID. More details about databinding are covered in later chapters of this tutorial.

TListBox

TListBox displays a list box that allows single or multiple selection. Set the property SelectionMode as Single to make a single selection list box, and Multiple a multiple selection list box. The items in the list box are represented by the Items property. The number of rows displayed in the box is specified via the Rows property value.