You
can visually insert a ColdFusion check box into your form and set
its properties. Use check boxes to let users select more than one
option from a set of options.
Note: This enhancement is available
only if you have access to a computer running ColdFusion MX 7 or
later.
Place the insertion point inside the form outline.
In the CFForm category of the Insert bar, click the CF
Checkbox icon.
A check box appears in the ColdFusion form.
Select the check box on the page and set any of the following
options in the Property inspector:
Cfcheckbox
Lets you specify a unique name for the control.
Checked Value
Lets you specify a value to be returned by the check
box if the user checks it.
Initial State
Lets you specify whether the check box is checked when
the page first opens in a browser.
Validate
Specifies the type of validation for the check box.
Validate At
Specifies when the check box is validated: onSubmit,
onBlur, or onServer.
Label
Lets you specify a label for the check box.
Pattern
Lets you specify a JavaScript regular expression pattern
to validate input. Omit leading and trailing slashes. For more information,
see the ColdFusion documentation.
Height
Lets you specify the height of the control, in pixels.
This property is ignored by the ColdFusion server at run time.
Width
Lets you specify the width of the control, in pixels.
This property is ignored by the ColdFusion server at run time.
Size
Lets you specify the size of the control. This property
is ignored by the ColdFusion server at run time.
Required
Lets you specify whether the checkbox must be checked
before the form is submitted to the server.
Display Tag Editor
Lets you edit properties not listed in the Property inspector.
To label the check box, click next to the check box on
the page and enter text for the label.