Programming ColdFusion MX, 2nd Edition

Name

cfgrid

Synopsis

<cfform>
  <cfgrid> 
    [<cfgridcolumn>]
    [<cfgridrow>]
    ...
  </cfgrid>
  ...
</cfform>

Provides a Java-based grid control for displaying and editing tabular data. Used within a cfform block.

Attributes

name=" name "

The form-field name for the grid control. Required.

align=" alignment "

Alignment for the grid control. Valid entries are Left, Right, Top, TextTop, Bottom, AbsBottom, Baseline, Middle, and AbsMiddle. Optional.

appendkey="Yes|No"

Whether or not to pass the cfgridkey variable along with the value of the selected grid item in the URL to the template specified in the cfform tag. Optional. The default is Yes.

autowidth="Yes|No"

Whether or not the grid should adjust the width of each column automatically so that all columns appear within the grid without having to scroll horizontally. Optional. The default is No. New as of ColdFusion 5.0.

bgcolor=" color "

Background color for the grid control. For color choices, see the textcolor attribute. Optional. The default is White.

bold="Yes|No"

If Yes, displays all grid data in bold. Optional. The default is No.

colheaders="Yes|No"

Whether or not to display column headers on the grid. Optional. The default is Yes.

colheaderalign=" alignment "

Alignment for the column headers. Valid entries are Left, Right, and Center. Optional. The default is Left.

colheaderbold="Yes|No"

Whether or not to display the column header text in bold. Optional. The default is No.

colheaderfont=" font_name "

The font to use for the column ...