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.

Attribute Reference for the cfgridcolumn tag

name

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

header

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

width

Required: No
Column width, in pixels.

font

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

fontsize

Required: No
Size of text in column.

italic

Required: No
Default: NO
Yes: displays grid control text in italics

bold

Required: No
Default: NO
Yes: displays grid control text in bold

bgcolor

Required: No
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

Required: No
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

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

hrefkey

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

target

Required: No
Frame in which to open link specified in href.

select

Required: No
Yes: user can select the column in grid control.

display

Required: No
No: hides column

type

Required: No
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

Required: No
Font of data in column.

headerfontsize

Required: No
Size of text in column.

headeritalic

Required: No
Yes: displays grid control text in italics

headerbold

Required: No
Yes: displays grid control text in bold

headertextcolor

Required: No
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

Required: No
Column data alignment Values:
  • left
  • right
  • center

headeralign

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

numberformat

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

values

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

valuesdisplay

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

valuesdelimiter

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

mask

Required: No
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

Required: No
Header Icon for grid column


Fork me on GitHub