CFML Reference
ColdFusion Tags

cfchartseries

Description

Used with the cfchart tag. This tag defines the style in which chart data displays: bar, line, pie, and so on.

Category

Data output tags, Extensibility tags

Syntax

<cfchartseries 
  type="type"
  query="queryName"
  itemColumn="queryColumn"
  valueColumn="queryColumn"
  seriesLabel="Label Text"
  seriesColor="Hex value or Web color" 
  paintStyle="plain, raise, shade, light"
  markerStyle="style"
  colorlist = "list">
</cfchartseries> 

See also

cfchart, cfchartdata

History

New in ColdFusion MX: This tag is new.

Attributes

Attribute	Req/Opt	Default	Description
type	Required		Sets the chart display style: bar line pyramid area cone curve cylinder step scatter pie
query	Optional		Name of ColdFusion query from which to get data.
itemColumn	Required if query attribute is specified		Name of a column in the query specified in the query attribute; contains the item label for a data point to graph.
valueColumn	Required if query attribute is specified		Name of a column in the query specified in the query attribute; contains data values to graph.
seriesLabel	Optional		Text of data series label
seriesColor	Optional		Color of the main element (such as the bars) of a chart. For a pie chart, the color of the first slice. Hex value or supported named color; see name list in the cfchart Usage section. For a hex value, use the form "##xxxxxx", where x = 0-9 or A-F; use two pound signs or none.
paintStyle	Optional	plain	Sets the paint display style of the data series. plain: solid color raise: the appearance of a button shade: gradient fill, darker at the edges light: a lighter shade of color; gradient fill
markerStyle	Optional	rectangle	Applies to chartseries type attribute values line, curve and scatter, and show3D attribute value no. Sets the icon that marks a data point: rectangle triangle diamond circle letter mcross snow rcross
colorlist	Optional		Applies if chartseries type attribute = "pie". Sets pie slice colors. Comma-delimited list of hex values or supported, named web colors; see name list in the cfchart Usage section. For a hex value, use the form "##xxxxxx", where x = 0-9 or A-F; use two pound signs or none.

Usage

For a pie chart, ColdFusion sets pie slice colors as follows:

• If the seriesColor attribute is omitted, ColdFusion automatically colors the slices
• If the seriesColor attribute is specified, ColdFusion automatically colors the slices after the first one, starting with the specified color for the first slice
• If the colorList attribute is specified, ColdFusion colors the slices after the first one, according to the list

Copyright © 2002, Macromedia Inc. All rights reserved.

Comments