Adobe 38043740 - ColdFusion Standard - Mac Development Manual page 775

DEVELOPING COLDFUSION 9 APPLICATIONS
Requesting and Presenting Information
Using the cfformgroup tag to structure forms
ColdFusion provides form group container types that provide basic structure to a Flash form. You specify these types
in the attribute of the cfformgroup tag. Use the following container types to control the layout of controls and
type
groups of controls:
Type Description
horizontal Arranges individual controls horizontally, and optionally applies a label to the left of the controls. Use only for
arranging ColdFusion form controls, including
cfformgroup
If you put other
cfformgroup
vertical Arranges individual controls vertically, and optionally applies a label to the left (not top) of the controls. Use only
for groups of ColdFusion form controls, including
cfformgroup
If you put other
cfformgroup
Arranges groups of controls horizontally. Does not apply a label. Use this attribute value to arrange other
hbox
cfformgroup
not use it to align individual controls.
vbox Arranges groups of controls vertically. Does not apply a label. Use this attribute value to arrange other
cfformgroup
to align individual controls.
hdividedbox Arranges two or more children horizontally, and places divider handles between the children that users can drag
to change the relative sizes of the children. Does not apply a label. The direct children of an
container must be
Arranges two or more children vertically, and places divider handles between the children that users can drag to
vdividedbox
change the relative sizes of the children. Does not apply a label. The direct children of a
must be
tile Arranges its children in a rectangular grid in row-first order. Does not apply a label.
Consists of a title bar containing the
panel
children.
accordion Places each of its child pages in an accordion pleat with a label bar. Displays the contents of one pleat at a time.
Users click the labels to expand or contract the pleat pages. Does not apply a label.
Places each of its children on a tabbed page. Users click the tabs to display a selected page. Does not apply a label.
tabnavigator
page The immediate child of an accordion or tab navigator container. Specifies the label on the pleat bar or tab, and
arranges its child containers and controls vertically.
For more information on using the
forms with accordion and tab navigator
Example: structuring with the cfformgroup tag
The following example shows a form with an
container to arrange two radio buttons. The right box uses a
horizontal
You can drag the divider handle to resize the two boxes. When you submit the form, the ColdFusion page dumps the
Form scope to show the submitted data.
containers; use the hbox attribute instead.
cfformgroup tags inside a
tag do not align with other controls in the horizontal group.
containers; use the vbox attribute instead.
cfformgroup tags inside a
tag do not align with other controls in the vertical group.
containers. This tag does not enforce alignment of child controls that have labels, so you should
containers. This tag does not enforce alignment of child controls that have labels, so do not use it
cfformgroup tags with
tags with attributes other than
cfformgroup type
label
,
accordion tabnavigator
containers" on page 773.
hdividedbox
Last updated 1/20/2012
cfformitem controls. As a general rule, do not use to organize
horizontal form group, the controls inside the included
cfformitem controls. As a general rule, do not use to organize
vertical form group, the controls inside the included
type attributes other than horizontal
or
horizontal vertical
attribute text, a border, and a content area with vertically arranged
, and types, see
pagecfformgroup
container with two containers. The left box uses a
vbox
container to lay out its check boxes.
tile
770
hdividedbox
or vertical .
container
vdividedbox
.
"Creating complex