Programming ColdFusion

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.

HEIGHT=" height_in_pixels "

Height in pixels for the grid’s display area. Optional.

WIDTH=" width_in_pixels "

Width in pixels for the grid’s display area. Optional.

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. Optional. The default is Yes. New as of ColdFusion 5.0.

VSPACE=" vertical_spacing_in_pixels "

Height in pixels for the padding above and below the grid control. Optional.

HSPACE=" horizontal_spacing_in_pixels "

Width in pixels for the padding to the left and right of the grid. Optional.

ALIGN=" alignment "

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

QUERY=" query_name "

The name of a query to associate with the grid control. Optional.

INSERT="Yes|No"

Whether or not to allow users to insert new data into the grid. Optional. The default is No.

DELETE="Yes|No"

Whether or not to allow users to delete data from the grid. Optional. The default is No.

SORT="Yes|No"

Whether or not to allow users to sort data in the grid using a simple text sort. Optional. The default is No.

FONT=" ...