User Guide

cfformitem 169
Note: Attributes that are marked as Flash only are not handled by the skins provided with ColdFusion
MX. They are, however, included in the generated XML in all controls except text and html types.
Usage
This tag requires an end tag or a slash before the closing end character of the opening tag, as the
following example shows:
<cfformitem type="hrule" />
For more information on using this tag in Flash forms, see Chapter 29, “Creating Forms in
Macromedia Flash” in ColdFusion MX Developer’s Guide.
Example
The following example shows a simple Flash form using horizontal rules and text:
<h3>cfformitem Example</h3>
<cfform name="myform" height="450" width="500" format="Flash" >
<cfformitem type="hrule" />
<cfformitem type="text">
This simple form has two hrule cfformitem tags around the cfformitem tag
that contains this text.
</cfformitem>
<cfformitem type="hrule" />
</cfform>
For a more complex form, see cfformgroup.
width Optional;
Flash
Width of the item, in pixels. If you omit this attribute, Flash
automatically sizes the width. In ColdFusion XSL skins,
use the
style attribute, instead.
height Optional;
Flash
Height of the item, in pixels. If you omit this attribute,
Flash automatically sizes the width. In ColdFusion XSL
skins, use the
style attribute, instead.
enabled Optional;
Flash
Yes Boolean value specifying whether the control is enabled.
Disabled text appear in light gray. Has no effect on
spacers and rules.
visible Optional;
Flash
Yes Boolean value specifying whether to show the control.
Space that would be occupied by an invisible control is
blank. Has no effect on spacers.
tooltip Optional;
Flash
Text to display when the mouse pointer hovers over the
control. Has no effect on spacers.
bind Optional;
Flash
A Flash bind expression that populates the field with
information from other form fields. If you use this
attribute, ColdFusion MX ignores any text that you
specify in the body of the
cftextitem tag. This attribute
can be useful if the
cfformitem tag is in a cfformgroup
type="repeater" tag. See Usage. For details, see “Flash
form data binding” in the
cfinput tag description.
Attribute Req/Opt;
Formats
Default Description