cfgridcolumn

Used with the cfgrid tag in a cfform. Use this tag to specify
column data in a cfgrid control. The font and alignment
attributes used in cfgridcolumn override global font or
alignment settings defined in cfgrid.

 <cfgridcolumn name="">

 cfgridcolumn(name="");

This tag requires Adobe ColdFusion. Not supported on Lucee, OpenBD, etc.

cfgridcolumn Attribute Reference

name
Required

Name of grid column element. If grid uses a query, column
name must specify name of a query column.

header

Column header text. Used only if cfgrid colHeaders = "Yes".

width

Column width, in pixels.

font
Default: arial

Font of data in column. Values:
  • arial
  • times
  • courier
  • arialunicodeMS

fontsize

Size of text in column.

italic
Default: NO

Yes: displays grid control text in italics

bold
Default: NO

Yes: displays grid control text in bold

bgcolor

Background color of control. For a hex value, use the form:
textColor = "##xxxxxx", where x = 0-9 or A-F; use two hash
signs or none. Values:
  • black
  • red
  • blue
  • magenta
  • cyan
  • orange
  • darkgray
  • pink
  • white
  • lightgray
  • yellow

textcolor

Text color for control. For a hex value, use the form:
textColor = "##xxxxxx", where x = 0-9 or A-F; use two hash
signs or none. Values:
  • black
  • red
  • blue
  • magenta
  • cyan
  • orange
  • darkgray
  • pink
  • white
  • lightgray
  • yellow

href

URL o r query column name that contains a URL to hyperlink
each grid column with.

hrefkey

The query column to use for the value appended to the href
URL of each column, instead of the column's value.

target

Frame in which to open link specified in href.

select

Yes: user can select the column in grid control.

display

No: hides column

type

image: grid displays image that corresponds to value in
column (a built-in CFML image name, or an image in
cfide\classes directory or subdirectory referenced with
relative URL). If image is larger than column cell, it is
clipped to fit. Built-in image names Values:
  • string_noCase
  • Boolean
  • numeric
  • date
  • combobox
  • image

headerfont

Font of data in column.

headerfontsize

Size of text in column.

headeritalic

Yes: displays grid control text in italics

headerbold

Yes: displays grid control text in bold

headertextcolor

Text color for control. For a hex value, use the form:
textColor = "##xxxxxx", where x = 0-9 or A-F; use two hash
signs or none. Values:
  • black
  • red
  • blue
  • magenta
  • cyan
  • orange
  • darkgray
  • pink
  • white
  • lightgray
  • yellow

dataalign

Column data alignment Values:
  • left
  • right
  • center

headeralign

Column header text alignment Values:
  • left
  • right
  • center

numberformat

Format for displaying numeric data in grid. See
numberFormat mask characters.

values

Formats cells in column as drop-down list boxes; specify
items in drop-down list. Example:
values = "arthur, scott, charles, 1-20, mabel"

valuesdisplay

Maps elements in values attribute to string to display in
drop-down list. Delimited strings and/or numeric range(s).

valuesdelimiter

Maps elements in values attribute to string to display in
drop-down list. Delimited strings and/or numeric range(s). Values:
  • ,
  • ;
  • |
  • :

mask

A mask pattern that controls the character pattern
that the form displays or allows users to input and
sends to ColdFusion.
For currency type data, use currency symbol.
For text or numeric type data use:
- A = [A-Za-z]
- X = [A-Za-z0-9]
- 9 = [0-9]
- ? = Any character
- all other = the literal character
For date type data use datetime masks.

headerIcon

Header Icon for grid column

Fork me on GitHub