Control is used for presenting data in a simple list. It is possible to show only one value or one column of a data source. Data can also be grouped by any column in the data source. It is also possible to define the default group in case the value of a field is null.
Control can be used for displaying data and it can also serve as a parameter provider for any data source statement.
Control is very flexible and can be customized to suit the needs of the end user. It is possible to select a certain data or to just click it. Data can be grouped. By default first three groups are displayed. To access more groups use configuration buttons at the bottom of the list. The number of groups displayed can be defined in design time.
Control has many properties that define its appearance, design, behaviour etc.
Context Properties
Properties in this section define the appearance of the control in Personalization Directory and the behaviour of the control when in edit mode.
| Property | Description |
|---|---|
| Category | Define the name by which the control is displayed in Personalization Directory. |
| Entity | Defines the name of the group in which the control is located in Personalization Directory. |
| NavigationVisible | The feature is obsolete. |
| TrackDirty | Defines whether user interface can be closed while the control is in edit mode. |
Data Properties
Properties in this section define how and which data is bound to the control.
| Property | Description |
|---|---|
| Adapter | Defines the MxAdapter component from which data can be retrieved and used for any kind of manipulation. |
| DataMember | Defines the scheme field of which the value is displayed in the control. |
| DataSourceName | Defines the data source which will be used to display and manipulate data. |
| GroupMember | Defines the scheme field of which the value is used for grouping. |
| Parameters | Defines the input parameters for any desired statement; readable or writable. |
Design Properties
Properties in this section define basic properties of the control, appearance and functionality of the control.
| Property | Description |
|---|---|
| Name | Defines the name of the control or the component. |
| DefaultValue | Defines the value displayed when no other value is selected by a user. |
| Collapsible | Defines whether it is possible to collapse groups. |
| DefaultGroupName | Defines the name for the default group. |
| MaxVisibleGroups | Defines the number of visible groups in the control. |
| Selection | Defines the behaviour of items when clicked. |
| SingleGroup | Defines whether items are grouped by default. |
NOTE: Properties described here are related exclusively to Mx Controls. For the description of other properties please see Developer Express documentation.
Example (MxSpace)
To see the implementation of List control open MxSpace solution project in Visual Studio. In Solution Explorer expand node Parts and double click ArticlesPart.cs. See the List control used for filtering data.
To implement List control
- In Solution Explorer open the desired MxPart component (ArticlesPart) and add List control from the Toolbox on the canvas to a desired location.
- Select the control and open Property Window.
- In Adapter property of the control select the adapter used that contains the desired data source.
- In DataSourceName property select the data source containing the data to display.
- In DataMember property select the field whose value will be displayed in the list.
- In GroupMember property select the field by which the data will be grouped in the list.
- In Collapsible property select False value.
- In DefaultGroupName property enter value Undefined.
- In MaxVisibleGroups property enter value 2.