Skip to content

Check Box

The CheckBox widget in Emakin provides a simple yes/no input model, commonly used for binary selections such as enabling or disabling options.

XML Fields

XPath identifies the form-data value. CheckedValue is written when the box is selected; UncheckedValue is written when it is cleared. Label/Content is the visible checkbox text. Hints provides help text and Rules contains formatting or validation conditions. Use explicit checked and unchecked values when the data model uses a code other than True and an empty value.

Value

  • Default Values:
    • Checked: True
    • Unchecked: (empty)

These default values can be customized by setting the following properties:

  • CheckedValue: Defines the value when the checkbox is selected.
  • UncheckedValue: Defines the value when the checkbox is not selected.

Remarks

  • Case-Insensitive Comparison:
    Value comparisons are case-insensitive. For example, the following values are treated as equivalent for the default checked state:

    • True
    • true
    • TRUE
    • TrUe

This flexibility ensures consistent data evaluation, regardless of capitalization or input format.

Example

1
2
3
4
5
<CheckBox XPath="Approved" CheckedValue="True" UncheckedValue="False">
    <Label><Content><![CDATA[Approved]]></Content></Label>
    <Hints><![CDATA[]]></Hints>
    <Rules />
</CheckBox>