cfgraph

Description

This tag is deprecated. Use the cfchart, cfchartdata, and cfchartseries tags instead.

Displays data graphically.

History

New in ColdFusion MX: this tag is deprecated. Do not use it in new applications. It might not work, and might cause an error, in later releases.

The incompatibilities between the ColdFusion MX implementation and earlier implementations of this tag are as follows:

cfgraph tag attribute ColdFusion MX functionality

Title
Ignored

Titlefont
Ignored

Barspacing
Ignored

Bordercolor
Color used for border, gridlines, and text displays

Colorlist

Pie chart: list of colors to use for each data point

Other chart types: ignored

Valuelabelfont
Sets value label text font. If the Valuelabelfont, Itemlabelfont, and Legendfont values differ, ColdFusion uses the last value that you specify in the tag.
Arial is not supported; it is mapped to Dialog.

Itemlabelfont
Sets item label text font. If the Valuelabelfont, Itemlabelfont, and Legendfont values differ, ColdFusion uses the last value that you specify in the tag
Arial is not supported; it is mapped to Dialog.

Legendfont
Sets legend text font. If the Valuelabelfont, Itemlabelfont, and Legendfont values differ, ColdFusion uses the last value that you specify in the tag
Arial is not supported; it is mapped to Dialog.

ShowLegend

above, below, left, right: these options cause the legend to display, but have no effect on its location.

none: prevents display of a legend

Valuelabelsize
Sets value label text size. If the Valuelabelsize and Itemlabelsize values differ, ColdFusion uses the last value that you specify in the tag

Itemlabelsize
Sets item label text size

Itemlabelorientation
Ignored. ColdFusion calculates best orientation based on label and graph size.

Borderwidth

a non-zero number: default-width border, regardless of number value

0: no border

Depth

0: displays graph with two-dimensional appearance

any other value: displays graph with threedimensional appearance

Linewidth
Ignored

Showvaluelabel

yes: displays values on mouse-click;

no: suppresses value displays

rollover: displays values on mouse-over.

Valuelocation
Ignored

url
URL of page to open if any item in the graph is clicked.
The following variables may be used within the URL; they are substituted with real values before the URL is accessed:

"$value$": selected row/column value or an empty string

"$itemlabel$": selected item (column) value or an empty string

"$serieslabel$": selected series (row) value or an empty string

"javascript:...": executes client side scripts.

Urlcolumn
Ignored.
This attribute generates a graph, but the url link is missing data that the linked page may expect. Thus, drilling-down in the graph may result in an error.

Type="HorizontalBar"
The (0,0) coordinate is located at the lower-left.

ScaleFrom
If the smallest value in the data is less than scaleFrom or the largest value in the data is greater than scaleTo, the respective data value is used as the minimum or maximum on the Y scale. Therefore, regardless of the scaleFrom or scaleTo value, all data values display.

cfgraph tag attribute	ColdFusion MX functionality
Title	Ignored
Titlefont	Ignored
Barspacing	Ignored
Bordercolor	Color used for border, gridlines, and text displays
Colorlist	Pie chart: list of colors to use for each data point Other chart types: ignored
Valuelabelfont	Sets value label text font. If the `Valuelabelfont`, `Itemlabelfont`, and `Legendfont` values differ, ColdFusion uses the last value that you specify in the tag. `Arial` is not supported; it is mapped to `Dialog`.
Itemlabelfont	Sets item label text font. If the `Valuelabelfont`, `Itemlabelfont`, and `Legendfont` values differ, ColdFusion uses the last value that you specify in the tag `Arial` is not supported; it is mapped to `Dialog`.
Legendfont	Sets legend text font. If the `Valuelabelfont`, `Itemlabelfont`, and `Legendfont` values differ, ColdFusion uses the last value that you specify in the tag `Arial` is not supported; it is mapped to `Dialog`.
ShowLegend	above, below, left, right: these options cause the legend to display, but have no effect on its location. none: prevents display of a legend
Valuelabelsize	Sets value label text size. If the `Valuelabelsize` and `Itemlabelsize` values differ, ColdFusion uses the last value that you specify in the tag
Itemlabelsize	Sets item label text size
Itemlabelorientation	Ignored. ColdFusion calculates best orientation based on label and graph size.
Borderwidth	a non-zero number: default-width border, regardless of number value 0: no border
Depth	0: displays graph with two-dimensional appearance any other value: displays graph with threedimensional appearance
Linewidth	Ignored
Showvaluelabel	yes: displays values on mouse-click; no: suppresses value displays rollover: displays values on mouse-over.
Valuelocation	Ignored
url	URL of page to open if any item in the graph is clicked. The following variables may be used within the URL; they are substituted with real values before the URL is accessed: "$value$": selected row/column value or an empty string "$itemlabel$": selected item (column) value or an empty string "$serieslabel$": selected series (row) value or an empty string "javascript:...": executes client side scripts.
Urlcolumn	Ignored. This attribute generates a graph, but the url link is missing data that the linked page may expect. Thus, drilling-down in the graph may result in an error.
Type="HorizontalBar"	The (0,0) coordinate is located at the lower-left.
ScaleFrom	If the smallest value in the data is less than scaleFrom or the largest value in the data is greater than scaleTo, the respective data value is used as the minimum or maximum on the Y scale. Therefore, regardless of the scaleFrom or scaleTo value, all data values display.

CFML Reference
ColdFusion Tags

cfgraph

Description

History

Comments