78
Chapter 2: ColdFusion Tags
cfcol
Description
Defines table column header, width, alignment, and text. Used within a
cftable
tag.
Category
Data output tags
Syntax
<cfcol
header = "column_header_text"
width = "number_indicating_width_of_column"
align = "Left" or "Right" or "Center"
text = "column_text">
See also
cfcontent
,
cfoutput
,
cftable
History
ColdFusion MX: Added the ability to construct dynamic
cfcol
statements.
Usage
At least one
cfcol
tag is required within the
cftable
tag. You must put
cfcol
and
cftable
tags
adjacent in a page. The only tag that you can nest within the
cftable
tag is the
cfcol
tag. You
cannot nest
cftable
tags.
To display the
cfcol
header
text, you must specify the
cfcol
header
and the
cftable
colHeader
attribute. If you specify either attribute without the other, the header does not display.
No error is thrown.
Example
<!--- This example shows the use of cfcol and cftable to align
information returned from a query --->
<!--- query selects information from cfsnippets data source --->
<cfquery name = "GetEmployees" dataSource = "cfsnippets">
SELECT Emp_ID, FirstName, LastName, EMail, Phone, Department
Attribute
Req/Opt
Default
Description
header
Required
Column header text. To use this attribute, you must also use the
cftable
colHeaders
attribute.
width
Optional
20
Column width. If the length of data displayed exceeds this value,
data is truncated to fit. To avoid this, use an HTML
table
tag.
If the surrounding
cftable
tag includes the
htmltable
attribute,
width
specifies the percent of the table width and it does not
truncate text; otherwise,
width
specifies the number of
characters.
align
Optional
Left
Column alignment
•
Left
•
Right
•
Center
text
Required
Double-quotation mark-delimited text; determines what to
display. Rules: same as for
cfoutput
sections. You can embed
hyperlinks, image references, and input controls.
Summary of Contents for COLDFUSION MX 61-CFML
Page 1: ...CFML Reference...
Page 16: ...16 Contents...
Page 32: ...32 Chapter 1 Reserved Words and Variables...
Page 160: ...160 Chapter 2 ColdFusion Tags html...
Page 245: ...cfmail 245 p input type Submit name form...
Page 299: ...cfreturn 299 cffunction cfcomponent...
Page 354: ...354 Chapter 2 ColdFusion Tags cfoutput cfcatch cftry...
Page 357: ...cfupdate 357 cftable cfif body html...
Page 362: ...362 Chapter 2 ColdFusion Tags cfloop MyDoc cfxml cfdump var MyDoc...
Page 397: ...ASin 397 br input type Text name sinNum size 25 p input type Submit name input type RESET form...
Page 486: ...486 Chapter 3 ColdFusion Functions input type Submit NAME form...
Page 492: ...492 Chapter 3 ColdFusion Functions b http_content x content b cfoutput...
Page 504: ...504 Chapter 3 ColdFusion Functions tr table form...
Page 519: ...IIf 519 cfoutput b...
Page 534: ...534 Chapter 3 ColdFusion Functions input type Submit name form...
Page 542: ...542 Chapter 3 ColdFusion Functions cfif cfif...
Page 547: ...IsStruct 547 cfcase cfswitch...
Page 550: ...550 Chapter 3 ColdFusion Functions IsWDDX returns IsWDDX packet br cfoutput...
Page 559: ...Left 559 option value 9 9 select input type Submit name Remove characters form...
Page 620: ...620 Chapter 3 ColdFusion Functions cfoutput cfloop...
Page 681: ...SetVariable 681 p Your variable varName p The value of varName is varNameValue cfoutput cfif...
Page 724: ...724 Chapter 3 ColdFusion Functions cfelse h3 Conversion error h3 cfif...
Page 743: ...XmlNew 743 cfscript cfdump var MyDoc...
Page 786: ...786 Chapter 5 ColdFusion Java CFX Reference...
Page 798: ...798 Chapter 6 WDDX JavaScript Objects...
Page 806: ...806 Chapter 7 ColdFusion ActionScript Functions...