Control is used for displaying and editing boolean values. Control represents a check box edit control that allows a simple option to be selected. The Check control represents a check editor that gives the user an option, such as true/false or yes/no.
Check control consist of two regions
- Check Box - In this region it is possible to edit data within an editor by checking or un-checking the check box.
- Caption - In this region in it possible to define check box's description.
It is possible to switch between check states by clicking the editor with the mouse or by pressing the space key.
Control can be bound to an adapter and data source so it can represent a value of a certain field. Control can also be used as a parameter provider; to provide input data for a data source statement.
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. |
| Parameters | Defines the input parameters for any desired statement; readable or writable. |
| Key | Define the key by which the control is uniquely represented in the system. |
| Scope | Defines the scope for which the value is remembered. |
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. |
| AllowNullInput | Defines whether it is possible to enter null values in the control. |
| NullText | Defines the text displayed when the control has null value assigned. |
| Text | Defines the text representing the control on the user interface. |
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 Check control open MxSpace solution project in Visual Studio. In Solution Explorer expand node Parts and double click WorkOrderManagePart.cs. See the Check control in Filter section.
To implement Check control
- In Solution Explorer open MxPart component (WorkOrderManagePart) and add Check control from the Toolbox to the desired location on the canvas.
- In property Parameters define the parameter mapping in order to provide statement parameter a value which is selected in the control.
- In property DefaultValue enter the desired value (true).
- In property Text enter the string (Include Closed Work Orders) which will be displayed in the control.