|
| The Check Box component offers a general purpose selector with two possible values: checked or not, typically representing "on" when checked, or "off" when not checked. |
Hint: The Check action logic for this component is an excellent location for code that causes other components to be active or grayed out.
Hint: When the intent is to allow a user to enter one of a limited set of values, there is a number of components that could be appropriate to facilitate this choice. If the list of possible values is "only two possible values", a Check Box might be preferrable. When the list is up to five, the Radio Button is probably the best approach. Up to a couple of dozen, the List Box or Drop Down List is the best way, and if the list is even longer, the Long List Box is to be preferred.
The events that are recognized for components of the type Checkbox are: Check, Create, Destroy, Enter, Exit, change, deselect, gotFocus, help, lostFocus and select.
The default property for a checkbox is Value.
The property list for a checkbox is:
| Property Name (MSM-Workstation) | Property Name (MWAPI) | Default Value | Value Range |
|---|---|---|---|
| Active | ACTIVE | Boolean value | |
| BackColor | BCOLOR | Color | |
| Cancel | CANCEL | Boolean value | |
| Changed | CHANGED | Boolean value | |
| Container | Free text | ||
| DataField | Field | ||
| DisplayOnly | CANCHANGE | Boolean value | |
| ForeColor | FCOLOR | Color | |
| Message | ZMESSAGE | Free text | |
| Name | Name of component (current window) | ||
| NextControl | NEXTG | Name of component | |
| Pointer | PTYPE | Pointer (extended) | |
| PosLeft | POS | Positive numeric value | |
| PosTop | POS | Positive numeric value | |
| PosUnits | POS | Unit Specification | |
| SizeHeight | SIZE | 12 | Positive numeric value |
| SizeUnits | SIZE | Unit Specification | |
| SizeWidth | SIZE | 40 | Positive numeric value |
| TFontBold | TFSTYLE | Boolean value | |
| TFontFace | TFFACE | Font face | |
| TFontItalic | TFSTYLE | Boolean value | |
| TFontSize | TFSIZE | Font size | |
| TFontUline | TFSTYLE | Boolean value | |
| Title | TITLE | [Title] | Free text |
| Type | TYPE | CHECK | Type of component |
| Units | UNITS | Unit Specification | |
| Value | VALUE | Boolean value | |
| VarName | Name of variable | ||
| VarPermanent | Boolean value | ||
| Visible | VISIBLE | Boolean value | |
Go back to the alphabetic list of components.