User Guide

192 Chapter 2: ColdFusion Tags
Usage
This tag must be in a cfform tag block.
An applet format grid requires the client to download a Java applet. Also, if the client does not
have an up-to-date Java plugin installed, the system might also have to download an updated Java
plugin to display the an applet format grid. A Flash format grid generates a Flash control, and can
be embedded in an HTML format
cfform tag. For this tag to work properly in either Flash or
applet format, the browser must also be JavaScript-enabled.
Note: If you specify Flash format for this tag in an HTML format form, and you do not specify height
and
width attributes, Flash takes up more than the remaining visible area on the screen. If any other
output follows the grid, including any form controls, users must scroll to see it. Therefore, if you follow
a Flash grid in an HTML form with additional output, specify
height and width values.
You can populate a cfgrid with data from a cfquery. If you do not specify any cfgridcolumn
tags in the
cfgrid body, ColdFusion generates a grid with the following:
• A column for each column in the query.
• A default header for each column, created by replacing hyphen or underscore characters in the
table column name with spaces. The first character, and any character after a space, are
changed to uppercase; all other characters are lowercase.
This tag requires an end tag.
colHeaderAlign Optional;
applet
Left • Left: left-aligns the column header text.
• Right: right-aligns the column header text.
• Center: centers the column header text.
notSupported Optional;
applet
(See
Description)
Text to display if the browser does not support
Java or has Java support disabled.
Default: "<b> Browser must support Java to view
ColdFusion Java Applets</b>"
pictureBar Optional;
applet
no • yes: puts images (and no text) on the Insert,
Delete, and Sort buttons.
• no: puts text (and no images) on the Insert,
Delete, and Sort buttons.
insertButton Optional;
applet
Insert Insert button text; takes effect only if
selectmode="edit".
deleteButton Optional;
applet
Delete Delete button text; takes effect only if
selectmode="edit".
sortAscendingButton Optional;
applet
A -> Z Sort button text.
sortDescendingButton Optional;
applet
Z -> A Sort button text.
Attribute Req/Opt;
Formats
Default Description