ListBox
Wisej.Web.ListBox
Last updated
Wisej.Web.ListBox
Last updated
Namespace: Wisej.Web
Assembly: Wisej.Framework (3.5.0.0)
Represents a control to display a list of items.
Initializes a new instance of ListBox.
Initializes a new instance of the ListBox class with the specified settings.
| Name | Type | Description |
|---|---|---|
onSelectedIndexChanged | Optional SelectedIndexChanged handler. |
Initializes a new instance of ListBox class with the specified settings.
| Name | Type | Description |
|---|---|---|
dataSource | Initial DataSource. | |
displayMember | Initial DisplayMember. | |
valueMember | Initial ValueMember. | |
iconMember | Initial IconMember. | |
onSelectedIndexChanged | Optional SelectedIndexChanged handler. |
Initializes a new instance of the ListBox class with the specified settings.
| Name | Type | Description |
|---|---|---|
location | Initial location. | |
size | Initial size. | |
onSelectedIndexChanged | Optional SelectedIndexChanged handler. |
Initializes a new instance of the ListBox class with the specified settings.
| Name | Type | Description |
|---|---|---|
location | Initial location. | |
size | Initial size. | |
dataSource | Initial DataSource. | |
displayMember | Initial DisplayMember. | |
valueMember | Initial ValueMember. | |
iconMember | Initial IconMember. | |
onSelectedIndexChanged | Optional SelectedIndexChanged handler. |
Boolean: Returns or sets a value indicating that the control can display HTML in the Text property. (Default: False)
Boolean: Returns or sets whether a horizontal scroll bar is displayed in the control. (Default: False)
Boolean: Returns or sets whether items are selected incrementally as the user types within a timeout of 1 second. (Default: True)
Int32: Gets or sets the height of the list items. When the value is -1, uses the value set in the theme. (Default: -1)
Throws:
ArgumentOutOfRangeException The assigned value is less than -1; or the assigned value is greater than 500.
ObjectCollection: Returns the collection of the items contained in this ListBox.
LabelWrapper: Provides a label related to the control.
String: Returns or sets the localizable label associated with this control. (Default: "")
Boolean: Returns or sets whether the items in the list are send to the client when the list becomes visible the first time. (Default: False)
Orientation: Returns or sets whether the list box displays the items vertically (default) or horizontally. Since 3.1 (Default: Vertical)
Throws:
InvalidOperationException Horizontal orientation is not supported with virtual scrolling.
Boolean: Returns or sets whether the control is read-only. (Default: False)
Boolean: Returns or sets whether the item under the pointer gets selected on a right click. (Default: False)
When the right click lands outside of a selected area the selection is not changed regardless of the value of RightClickSelection.
Boolean: Returns or sets whether the vertical scroll bar is shown at all times. (Default: False)
Int32: Returns or sets the zero-based index of the currently selected item in a ListBox.
Throws:
ArgumentOutOfRangeException The assigned value is less than -1 or greater than or equal to the item count.
ArgumentException The SelectionMode property is set to None.
SelectedIndexCollection: Returns a collection that contains the zero-based indexes of all currently selected items in the ListBox.
Object: Returns or sets the currently selected item in the ListBox.
SelectedObjectCollection: Returns a collection containing the currently selected items in the ListBox.
SelectionMode: Returns or sets the method in which items are selected in the ListBox. (Default: One)
Boolean: Returns or sets whether the items in the combo box are sorted. (Default: False)
Throws:
ArgumentException An attempt was made to sort a ListBox that is attached to a data source.
ComponentToolCollection: Returns the instance of ComponentToolCollection associated with this control.
Int32: Returns or sets the index of the first visible item in the ListBox.
Not used. Kept for compatibility.
Unselects all items in the ListBox.
Not used. Kept for compatibility.
Returns the index of the first item in the ListBox beyond the specified index that contains the specified string. The search is not case sensitive.
| Parameter | Type | Description |
|---|---|---|
text | The String to search for. | |
startIndex | The zero-based index of the item before the first item to be searched. Set to -1 to search from the beginning of the control. |
Returns: Int32. The zero-based index of the first item found; returns -1 if no match is found, or 0 if the text parameter specifies Empty.
Returns the index of the first item in the ListBox that starts with the specified string.
Returns: Int32. The zero-based index of the first item found; returns -1 if no match is found.
Finds the first item in the combo box that matches the specified string.
Returns: Int32. The zero-based index of the first item found; returns -1 if no match is found, or 0 if the text parameter specifies Empty.
Finds the first item after the specified index that matches the specified string.
| Parameter | Type | Description |
|---|---|---|
text | The String to search for. | |
startIndex | The zero-based index of the item before the first item to be searched. Set to -1 to search from the beginning of the control. |
Returns: Int32. The zero-based index of the first item found; returns -1 if no match is found, or 0 if the text parameter specifies Empty.
Returns a value indicating whether the specified item is selected.
| Parameter | Type | Description |
|---|---|---|
index | The zero-based index of the item that determines whether it is selected. |
Returns: Boolean. true if the specified item is currently selected in the ListBox; otherwise, false.
Throws:
ArgumentOutOfRangeException The specified index was outside the range of valid values.
Selects all the items in the ListBox.
Selects or clears the selection for the specified item in a ListBox.
| Parameter | Type | Description |
|---|---|---|
index | The zero-based index of the item in a ListBox to select or clear the selection for. | |
selected | true to select the specified item; otherwise, false. |
Throws:
ArgumentOutOfRangeException The specified index was outside the range of valid values.
InvalidOperationException The SelectionMode property is set to None.
EventHandler Fired when the LazyLoading property is true and the ListBox is first shown.
When LazyLoading is true An application may fill the items at any time prior to the ListBox being shown, or while processing the Load event.
EventHandler Fired when the value of the ReadOnly property has changed.
EventHandler Fired when the SelectedIndex property or the SelectedIndices collection has changed.
EventHandler Fired when the Sorted property has changed.
ToolClickEventHandler Fired when a ComponentTool is clicked.
| Name | Description |
|---|---|
Displays a ListBox in which a check box is displayed to the left of each item. |
| Name | Description |
|---|---|
Bindable components implement this interface. | |
Controls that support drag & drop operations implement this interface. | |
Provides access to the LabelWrapper associated with the controls that implement this interface. | |
Provides access to the ReadOnly property for coontrols that support the read-only mode. | |
Provides access to the Modified property and ModifiedChanged event for controls that implement this interface. | |
Provides access to the validation events and properties property for controls that support validation. | |
All wisej components implement this interface. | |
All wisej controls derived from the Control class must implement this interface. | |
Allows an object to serialize itself. |
