CFCHART (New in MX)

"-->

 <cfchart          format = "flash, jpg, png"          chartHeight = "integer number of pixels"          chartWidth = "integer number of pixels"          scaleFrom = "integer minimum value"          scaleTo = "integer maximum value"          showXGridlines = "yes" or "no"          showYGridlines = "yes" or "no"          gridlines = "integer number of lines"          seriesPlacement = "default,cluster, stacked, percent"          foregroundColor = "Hex value or Web color"          dataBackgroundColor = "Hex value or Web color"          borderBackgroundColor = "Hex value or Web color"          showBorder = "yes" or "no"          font = "font name"          fontSize = "integer font size"          fontBold = "yes" or "no"          fontItalic = "yes" or "no"          labelFormat = "number, currency, percent, date"          xAxisTitle = "title text"          yAxisTitle = "title text"          sortXAxis = "yes/no"          show3D = "yes" or "no"          xOffset = "number between -1 and 1"          yOffset = "number between -1 and 1"          rotated = "yes/no"          showLegend = "yes/no"          tipStyle = "MouseDown, MouseOver, Off"          tipBGColor = "hex value or web color"          showMarkers = "yes" or "no"          markerSize = "integer number of pixels"          pieSliceStyle = "solid, sliced"          url = "onClick destination page"          name = "String"  </cfchart> 

Description

This tag creates a user-defined graph that is stored as an HTML object or as an image tag, depending on the chosen attribute.

Attributes

format

Default: flash. File format in which to save graph. Format options include flash, jpg, and png.

chartHeight

Default: 240. Chart height in pixels.

chartWidth

Default: 320. Chart width in pixels.

scaleFrom

Determined by data. Y-axis minimum value.

scaleTo

Determined by data. Y-axis maximum value.

showXGridlines

Default: No.

• Yes. Displays X-axis gridlines.

• No. Hides X-axis gridlines.

showYGridlines

Default: yes.

• Yes. Display Y-axis gridlines.

• No. Hide Y-axis gridlines.

gridlines

Default: 3 (top, bottom, and zero). Number of grid lines to display on value axis, including axis; This should be a positive number. 0= hides gridlines.

seriesPlacement

Default: Default

Applies to charts that have more than one data series and is the relative positions of series.

Default: ColdFusion determines relative positions based on graph types. Other options include cluster, stacked, percent.

foregroundColor

Default: Black. Color of text, gridlines, and labels. Hex value or web color.

dataBackgroundColor

Default: White. Color of area around chart data. Hex value or web color.

borderBackgroundColor

Default: White. Color of area between data background and border, around labels, and around legend.

showBorder

Default: No

font

Default: Arial. Name of text font.

fontSize

Default: 11. Font size.

fontBold

Default: No

fontItalic

Default: No

labelFormat

Default: Number. This is the format for Y-axis labels. Other options include number, currency, percent, and date.

xAxisTitle

Title for the X-axis.

yAxisTitle

Title for the Y-axis.

sortXAxis

Default: No. If Yes, displays column labels in alphabetic order along X-axis.

show3D

Default: No. If Yes, displays chart with three-dimensional appearance.

xOffset

Default: 0.1

Only applies if show3D="yes". The number of units by which to horizontally angle the chart when it is displayed. A number in the range -1 to 1, where -1 specifies 90 degrees left and 1 specifies 90 degrees right.

yOffset

Default: 0.1

Applies if show3D="yes". The number of units by which to vertically angle the chart when it is displayed. A number in the range -1 to 1, where -1 specifies 90 degrees down, and 1 specifies 90 degrees up.

rotated

Default: No. If Yes, rotate chart 90 degrees. Use this option for a horizontal bar chart.

showLegend

Default: Yes; the legend is displayed if the chart contains more than one data series.

tipStyle

Default: mouseOver

• mouseDown. This option only works on Flash graphs and displays when the mouse is clicked. For other formats,this option works the same as mouseOver.

• mouseOver. Displays if the user positions the cursor over the element.

• off. Suppresses display.

tipBGColor

Default: White; applies only to Flash graphs. Hex value or web color.

showMarkers

Default: Yes, which displays markers at data points.

markerSize (Automatic)

Size of data point marker.

pieSliceStyle

This attribute only works with pie charts.

Default: sliced

• solid. Displays pie as if unsliced.

• sliced. Displays pie as if sliced.

url

The URL to open if an item is clicked. Variables may be specified within the URL, and ColdFusion passes the current values of the variables.

• $VALUE$. Value of selected row. If none, the value is an empty string.

• $ITEMLABEL$. Label of selected item. If none, the value is an empty string.

• $SERIESLABEL$. Label of selected series. If none, the value is an empty string.