User Guide

Building Flash forms 693
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
type attribute of the cfformgroup tag. Use the following container
types to control the layout of controls and 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
cfformitem controls. As a general rule, do not use to organize cfformgroup
containers; use the
hbox attribute instead.
If you put other
cfformgroup tags inside a horizontal form group, the controls
inside the included
cfformgroup tag do not align with other controls in the
horizontal group.
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
cfformitem controls. As a general rule, do not use to organize cfformgroup
containers; use the
vbox attribute instead.
If you put other
cfformgroup tags inside a vertical form group, the controls inside
the included
cfformgroup tag do not align with other controls in the vertical group.
hbox
Arranges groups of controls horizontally. Does not apply a label. Use this attribute
value to arrange other
cfformgroup containers. This tag does not enforce
alignment of child controls that have labels, so you should 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 containers. This tag does not enforce
alignment of child controls that have labels, so you should not use it to align
individual controls.
hdividedbox
Arranges two or more children horizontally, and puts 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
hdividedbox container must be cfformgroup
tags with
type attributes other than horizontal or vertical.
vdividedbox
Arranges two or more children vertically, and puts 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 a
vdividedbox container must be cfformgroup
tags with
type attributes other than horizontal or vertical.
tile
Arranges its children in a rectangular grid in row-first order. Does not apply a label.
panel
Consists of a title bar containing the label attribute text, a border, and a content
area with vertically arranged children.
accordion
Puts 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.
tabnavigator
Puts each of its children on a tabbed page. Users click the tabs to display a
selected page. Does not apply a label.
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.