Element Description
A WOCheckBox object displays itself in the HTML page as its
namesake, a check box user interface control. It corresponds to
the HTML element <INPUT TYPE="CHECKBOX"...>
.
If you want to create a list of check boxes, use WOCheckBoxList instead of this element.
Synopsis
WOCheckBox {value=defaultValue;
[selection=selectedValue;] [name=fieldName;] [disabled=aBoolean;]
... };
WOCheckBox {checked=aBoolean;
[name=fieldName;] [disabled=aBoolean;]
... };
Bindings
- value
- Value of this input element. If not specified, WebObjects
provides a default value.
- selection
- If selection and value are equal when the page is generated,
the check box is checked. When the page is submitted, selection
is assigned the value of the check box.
- checked
- During page generation, if checked evaluates to
true
(or YES
),
the check box appears in the checked state. During request handling,
checked reflects the state the user left the check box in: true
(or YES
)
if checked; false
(or NO
)
if not.
- name
- Name that uniquely identifies this element within the
form. You may specify a name or let WebObjects automatically assign
one at runtime.
- disabled
- If disabled evaluates to
true
(or YES
),
this element appears in the page but is not active. That is, selection
won't contain the user's selection when the page is submitted.