cfgridcolumn

Overview ColdFusion Open BlueDragon Lucee

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.

Attributes

Name Required Type Default Description
9
autoExpand No Boolean true On a particualr column, it lets you expand the specified column.Setting autoExpand for multiple columns results in error.By default, autoExpand is set to true for the first column and false for the remaining columns.If the attribute display is false, autoExpand cannot be true; else, it results in error.
bgcolor No String 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.
bold No Boolean false Yes: displays grid control text in bold
dataalign No String Column data alignment
display No Boolean No: hides column
font No String arial Font of data in column.
fontsize No Numeric Size of text in column.
header No String Column header text. Used only if cfgrid colHeaders = "Yes".
headeralign No String Column header text alignment
headerbold No Boolean Yes: displays grid control text in bold
headerfont No String Font of data in column.
headerfontsize No Numeric Size of text in column.
9
headerIcon No String Header Icon for grid column
headeritalic No Boolean Yes: displays grid control text in italics
9
headerMenu No Boolean true This attribute allows you to turn on/off the header menu of the grid column. Header menu is the dropdown list that appears when you hover the mouse on grid header columns.This is helpful in scenarios where you have images for grid headers.
headertextcolor No String 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.
href No String URL o r query column name that contains a URL to hyperlink each grid column with.
hrefkey No String The query column to use for the value appended to the href URL of each column, instead of the column's value.
italic No Boolean false Yes: displays grid control text in italics
mask No String 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.
name Yes String Name of grid column element. If grid uses a query, column name must specify name of a query column.
numberformat No String Format for displaying numeric data in grid. See numberFormat mask characters.
select No Boolean Yes: user can select the column in grid control.
target No String Frame in which to open link specified in href.
textcolor No String 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.
type No String 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 No String Formats cells in column as drop-down list boxes; specify items in drop-down list. Example: values = "arthur, scott, charles, 1-20, mabel"
valuesdelimiter No String Maps elements in values attribute to string to display in drop-down list. Delimited strings and/or numeric range(s).
valuesdisplay No String Maps elements in values attribute to string to display in drop-down list. Delimited strings and/or numeric range(s).
width No Numeric Column width, in pixels.