ucheckbox (CheckBox)
The ucheckbox widget enables the user to set a Boolean value in a form component. Uniface provides a logical widget called CheckBox, which is mapped to ucheckbox.
For more information, see Specifying a Widget for a Field or Entity.
| Logical widget name: | CheckBox |
| Maps to physical widget: |
|
| Default definition: | CheckBox=ucheckbox(font=label;fittotext=true)
|
| Use for: | Boolean fields |
| Supported triggers: | See Triggers |
| Supported properties: | See Widget Properties |
Supported in egrid(Grid) widget? |
Yes. Some properties may not be
applicable. For more information, see egrid (Grid) and Widgets and Properties Supported in Grid Widget. |
| Supports MSAA? : | Yes, for testing purposes only. For more information, see Accessibility. |
Description
The Tri-state property
determines whether the allowed check box values can be boolean (two states allowed), or tri-state
(three states allowed). The possible values of a check box are True or
False, and a third state that you can attribute any meaning to (for example, default
or undetermined). You can also attribute any meaning you want to the values on and
off.
You can test for the following values of a check box.
|
Value |
Description |
|---|---|
|
|
Cleared, meaning |
|
|
Selected, meaning |
|
|
Tri-state only: |
Triggers
- trigger detail—activated for a two-state check box if the Use Detail Trigger property is set.
- trigger valueChanged—activated when a user clicks the check box.
Widget Properties
|
Property |
Technical Name |
Dynamic? |
|---|---|---|
|
3D |
No |
|
|
Attach |
Yes |
|
|
BackColor |
Yes |
|
|
ForeColor |
Yes |
|
|
FocusIndicator |
Yes |
|
|
FitToText |
No |
|
|
InheritColors |
Yes |
|
|
Font |
Yes |
|
|
Cursor |
Yes |
|
|
PopupRect |
Yes |
|
|
ToolTipText |
Yes |
|
|
Transparency |
Yes |
|
|
TriState |
Yes No for CHUI |
|
|
V52 |
Yes No for CHUI |
|
|
Alignment (CHUI only) |
Alignment |
No |
|
Decoration (CHUI only) |
Decoration |
No |
