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 3 and up. Not supported on Lucee, etc.
Discouraged: The use of tags generating UI is generally discouraged by the CFML community. See: https://static.raymondcamden.com/cfuitherightway/cfgrid/index.html
Attribute Reference
name string Required
Name of grid column element. If grid uses a query, column name must specify name of a query column.
header string
Column header text. Used only if cfgrid colHeaders = "Yes".
width numeric
Column width, in pixels.
font string
Default: arial
arial
Font of data in column.
Values:
arialtimescourierarialunicodeMS
fontsize numeric
Size of text in column.
italic boolean
Default: false
false
Yes: displays grid control text in italics
Values:
truefalse
bold boolean
Default: false
false
Yes: displays grid control text in bold
Values:
truefalse
bgcolor 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.
Values:
blackredbluemagentacyanorangedarkgraypinkwhitelightgrayyellow
textcolor 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.
Values:
blackredbluemagentacyanorangedarkgraypinkwhitelightgrayyellow
href string
URL or query column name that contains a URL to hyperlink each grid column with.
hrefkey string
The query column to use for the value appended to the href URL of each column, instead of the column's value.
target string
Frame in which to open link specified in href.
select boolean
Yes: user can select the column in grid control.
Values:
truefalse
display boolean
No: hides column
Values:
truefalse
type 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:
string_noCaseBooleannumericdatecomboboximage
headerfont string
Font of data in column.
headerfontsize numeric
Size of text in column.
headeritalic boolean
Yes: displays grid control text in italics
Values:
truefalse
headerbold boolean
Yes: displays grid control text in bold
Values:
truefalse
headertextcolor 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.
Values:
blackredbluemagentacyanorangedarkgraypinkwhitelightgrayyellow
dataalign string
Column data alignment
Values:
leftrightcenter
headeralign string
Column header text alignment
Values:
leftrightcenter
numberformat string
Format for displaying numeric data in grid. See numberFormat mask characters.
values string
Formats cells in column as drop-down list boxes; specify items in drop-down list. Example: values = "arthur, scott, charles, 1-20, mabel"
valuesdisplay string
Maps elements in values attribute to string to display in drop-down list. Delimited strings and/or numeric range(s).
valuesdelimiter string
Maps elements in values attribute to string to display in drop-down list. Delimited strings and/or numeric range(s).
mask 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
Ext.Date masks. headerIcon string
Header Icon for grid column
Links more information about cfgridcolumn
-
Ext.Date Format Masks - When using the
maskattribute with a date these are the supported date/time mask characters.
Examples Sample code using the cfgridcolumn tag
© 2012–present Foundeo, Inc. and the CFDocs contributors.
Licensed under the MIT License.
ColdFusion is a trademark of Adobe Systems Incorporated.
https://cfdocs.org/cfgridcolumn
