CF_GRAPH

The CF_GRAPH tag allows you to create different types of analytical graphs against the given data. Using CF_GRAPH, you can generate graphs like bar graph, line graph, pie graph, stacked bar graph in both series and non-series categories using 2D and 3D.

See also CF_GRAPHPARAM.

Syntax

<CF_GRAPH TITLE="graph_title"
    FILE="filename"
    DESTINATION="full_path_name"
    HEIGHT="height_in_pixels"
    WIDTH="width_in_pixels"
    XLABEL="x_axis_label"
    YLABEL="y_axis_label"
    SERIESLABEL="series_label"
    BACKCOLOR="background_color"
    GRIDLINES="grid_lines"
    ORIENTATION="graph_orientation"	
    ACTION="action">
</CF_GRAPH>

TITLE

Optional. This property is used to give a title to the graph.

FILE

Required. This property is the name of the image file created. The image name must be followed by its extension. Extension can be only be JPEG or BMP. The file is saved with this name in the path set using property DESTINATION. If this name is missed the image will not be saved.

DESTINATION

Required. The full path of the directory or folder where the created image is to be saved. This property must be set before making any graph. If not set or the path is not valid then the image will not be saved.

HEIGHT

Optional. The property is used to set the height of the graph in pixels. This is optional to set, if not set then the default value is used i.e. 350. A value less then the 200 is not recommended as it may not display the scale on the Y-Axis properly.

WIDTH

Optional. The property is used to set the width of the graph in pixels. This is optional to set, if not set then the default value is used i.e. 500. A value less then the 300 is not recommended as it may not display the scale on the X-Axis properly.

XLABEL

Optional. The property is used to set a label to appear on the X-Axis. This property can be used to represent unit of measurement on the X-Axis.

YLABEL

Optional. The property is used to set a label to appear on the Y-Axis. This property can be used to represent unit of measurement on the Y-Axis.

SERIESLABEL

Optional. In case of multiple series graph this property is used as title for each series.

BACKCOLOR

Optional. This property enables or disable the graph back color option. The color used for background is Grey. Valid values are

• TRUE
if this value is set as TRUE then the created graph has back color
• FALSE
(default) if this value is set as FALSE then the graph does not have the back color

GRIDLINES

Optional. This property enables or disable the graph grid lines option. Valid values are

• TRUE
if this value is set as TRUE then the created graph has grid lines
• FALSE
(default) if this value is set as FALSE then the graph does not have the grid lines

ORIENTATION

Optional. This property is used to change the default orientation of the graph. The generated graph can be horizontally or vertically aligned. Valid values are

• VERTICAL
(default) if this value is set as VERTICAL then generated graph is vertically aligned. The graph originates from the horizontal axis and plots along the vertical axis. This method is useful for all the graphs that have axis displayed including series and non series graphs. Pie and 3DPie have no effect of this function
• HORIZONTAL
if this value is set as HORIZONTAL then generated graph is horizontally aligned. Instead of originating from the horizontal plane and plotting along the vertical axis, the graph originates from the vertical axis and plots along the horizontal axis. This method is useful for all the graphs that have axis displayed including series and non series graphs. Pie and 3DPie have no effect of this function

ACTION

Required. Specifies the action. These are possible values

• Draw3DBarGraph
draws a 3D bar graph
• Draw3DLineGraph
draws a 3D line graph
• Draw3DPieGraph
draws a 3D pie graph
• Draw3DStackedBarGraph
draws a 3D stacked bar graph
• DrawBarGraph
draws a 2D bar graph
• DrawBoxWhiskerGraph
draws a Box and Whisker graph
• DrawLineGraph
draws a 2D line graph
• DrawPieGraph
draws a 2D pie graph
• DrawStackedBarGraph
draws 2D stacked bar graph
• Draw3DBarSeriesGraph
draws a 3D bar series graph and each series is represented as a separate 3D bar
• Draw3DLineSeriesGraph
draws a 3D line series graph and each series is represented as a separate 3D line
• Draw3DPieSeriesGraph
draws a 3D pie series graph and each series is represented as a separate 3D pie
• Draw3DStackedBarSeriesGraph
draws a 3D stacked bar series graph and each series is represented as a separate 3D stacked bar
• DrawBarSeriesGraph
draws a 2D bar series graph and each series is represented as a separate bar
• DrawBoxWhiskerSeriesGraph
draws a Box and Whisker series graph and each series is represented as a separate box
• DrawLineSeriesGraph
draws a 2D line series graph and each series is represented as a separate line
• DrawPieSeriesGraph
draws a 2D pie series graph and each series is represented as a separate pie
• DrawStackedBarSeriesGraph
draws a 2D stacked bar series graph and each series is represented as a separate stacked bar

Example

<!--- This example shows the use of CF_GRAPH
to generate a 3D bar graph --->
<HTML>
<HEAD>
<TITLE>CF_GRAPH Example</TITLE>
</HEAD>
<BODY>

<H3>CF_GRAPH Example</H3>

<P>This view-only example shows the ability of CF_GRAPH
to generate a 3D bar graph.</P>

<CF_GRAPH TITLE="Monthly Salary Graph"
    	  FILE="monthlysalary.jpg"
    	  DESTINATION="c:\myfolder"
    	  XLABEL="Months"
    	  YLABEL="Salary"
    	  ACTION="Draw3DBarGraph">
    <CF_GRAPHPARAM TYPE="AddData" XVALUE="jan" YVALUE="1000">
    <CF_GRAPHPARAM TYPE="AddData" XVALUE="feb" YVALUE="1200">
    <CF_GRAPHPARAM TYPE="AddData" XVALUE="mar" YVALUE="1500">
</CF_GRAPH>

</BODY>
</HTML>