ListControl

Wisej.Web.ListControl

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Control
- ListControl

Provides a common implementation of members for the ListBox and ComboBox classes.

public class ListControl : Control

Public Class ListControl
    Inherits Control

Properties

AllowHtml

Boolean: Returns or sets a value indicating that the control can display html in the Text property.

BorderStyle

BorderStyle: Returns or sets the type of border that is drawn around the ListControl.

DataSource

Object: Returns or sets the data source for this ListControl.

Throws:

ArgumentException The assigned value does not implement the IList or IListSource interfaces.

DisplayMember

String: Returns or sets the property to display for this ListControl.

FormatString

String: Returns or sets the format-specifier characters that indicate how a value is to be displayed.

FormattingEnabled

Boolean: Returns or sets whether formatting is applied to the DisplayMember property of the ListControl.

IconMember

String: Returns or sets the property to use as the icon for the items in the ListControl.

Invalid

Boolean: Returns or sets a value that indicates that the control is invalid.

InvalidMessage

String: Returns or sets the invalid message that is shown in the invalid tooltip.

Modified

Boolean: Returns or sets a value that indicates that the control has been modified by the user since the control was created or its contents were last set.

PrefetchItems

Int32: Returns or sets the number of items to prefetch outside of the visible area when VirtualScroll is set to true. The default is 0 (disabled).

SelectedIndex

Int32: When overridden in a derived class, gets or sets the zero-based index of the currently selected item.

SelectedValue

Object: Returns or sets the value of the member property specified by the ValueMember property.

Throws:

InvalidOperationException The assigned value is null or the empty string ("").

ShowToolTips

Boolean: Returns or sets whether to show tooltips (set using ToolTipMember) for the list items.

ToolTipMember

String: Returns or sets the property to use as the tooltip for the items in the ListControl, when the property ShowToolTips is set to true.

ValueMember

String: Returns or sets the property to use as the actual value for the items in the ListControl.

Throws:

ArgumentException The specified property cannot be found on the object specified by the DataSource property.

VirtualScroll

Boolean: Enables or disables virtual scrolling for the ListControl. When virtual scrolling is enabled, only the visible items are rendered in the browser allowing the ListControl to host virtually unlimited items without any performance loss.

When VirtualScroll is set to true, all the items must be of the same height, limiting the more flexible HTML rendering available when VirtualScroll is off (default). Setting the property PrefetchItems to a value greater than 0 allows the virtual view to prefetch the specified number of items outside of the visible area to enable smoother scrolling.

Methods

Append(data)

Populates the ListControl from the data appending the items to the existing items.

Parameter

Type

Description

data

Object

The object that contains data for the ListControl to display.

Returns: Int32. Numbers of items appended.

Use this method to fill a ListControl without binding it to the data source.

Fill(data)

Populates the ListControl from the data .

Parameter

Type

Description

data

Object

The object that contains data for the ListControl to display.

Returns: Int32. Numbers of items added.

Use this method to fill a ListControl without binding it to the data source.

GetItemIcon(item)

Returns the icon object, either an instance of Image or a String representing the icon name or URL, of the specified item.

Parameter

Type

Description

item

Object

The object from which to get the icon to display for the list item.

Returns: Object. If the IconMember property is not specified, the value returned by GetItemIcon is null. Otherwise, the method returns the object value of the member specified in the IconMember property for the object specified in the item parameter.

GetItemText(item)

Returns the text representation of the specified item.

Parameter

Type

Description

item

Object

The object from which to get the contents to display.

Returns: String. If the DisplayMember property is not specified, the value returned by GetItemText is the value of the item's ToString method. Otherwise, the method returns the string value of the member specified in the DisplayMember property for the object specified in the item parameter.

GetItemToolTip(item)

Returns the tooltip text related to the object.

Parameter

Type

Description

item

Object

The object from which to get the tooltip text to display for the list item.

Returns: String. If the ToolTipMember property is not specified, the value returned by GetItemToolTip is null. Otherwise, the method returns the value of the member specified in the ToolTipMember property for the object specified in the item parameter.