Chart

Definition

A control to visualize data in annotated diagrams.

axisMaxVal

Used to calculate the annotation and scaling of the chart. 'axisMaxVal' specifies the maximum value the axis is annotated with. If 'axisMaxVal' is not specified or a value is specified that is less than the maximum value provided by he model, 'axisMaxVal' is set to the maximum value of the model.
axisMinVal

Used to calculate the annotation and scaling of the chart. 'axisMinVal' specifies the minimum value of the axis. If 'axisMinVal' is not specified or a value is specified that is greater than the minimum value provided by he model, 'axisMinVal' is set to 0.
chartType

Controls the style in which the data is displayed.
- AREA
- AREA3D
- AREA_STACKED
- AREA_STACKED_3D
- BARS
- BARS_3D
- BARS_STACKED
- BARS_STACKED_3D
- BITMAP
- COLUMNS
- COLUMNS_3D
- COLUMNS_STACKED
- COLUMNS_STACKED_3D
- LINES
- LINES_3D
- PIE
- PIE_3D
- PIE_EX
- PIE_EX_3D
- PIE_SPLIT
- PYRAMID
- TREND
colorOrder

The various types of the chart control all use the same set of colors to visualize the values of a data set, but explore the space of possible colors on different paths. The following pictures show the three predefined color schemes and the chart types using them.
- STRAIGHT
  
  This color scheme is used by the various area, column and bar chart graphs.
- SNAKE
  
  This color scheme is used by the pie chart graphs.
- REVERSE
  
  This color scheme is used by the line chart graphs.
displayObjectValues

A boolean value that controls if the values is displayed with the object.

displayObjectValues="false"

displayObjectValues="true"

Not all 'ChartType' settings support the display of values. The example pictures in the 'chartType' attribute description show which types support the display of values.
height

Defines the overall height of the chart. The height includes the 'title', 'titleValues' and 'legendPosition'.
id

Identification name of the chart.
legendPosition

Controls the position of the legend.
- EAST
  
  Places the legend on the right side of the chart.
- NONE
  
  The legend will be suppressed.
- NORTH
  
  Places the legend on top of the chart.
- SOUTH
  
  Places the legend under the chart.
- WEST
  
  Places the legend left of the chart.
model

Defines the model which provides the chart with data. How to work with the IChartModel.
title

Specifies the headline of the chart.
titleCategories

Specifies the axis title for the categories.
titleValues

Specifies the axis title for the values.
visible

A boolean value that defines if the chart is visible.
voidValue

Defines a value that will not be drawn in the chart. Is a "voidValue" set, for example to 0, chart objects with the according voidValue will not be drawn.

Note
Line charts do not support this option.
voidValueSet

Switches the "voidValue" function on and off.
width

Defines the width of the chart. The width include 'titleCategories' and the 'legendPosition'.

Attributes	M	Values	Usage
axisMaxVal		Numeric	Taglib `axisMaxVal="2000"` Classlib `setAxisMaxVal(2000)`
axisMinVal		Numeric	Taglib `axisMinVal="100"` Classlib `setAxisMinVal(100)`
chartType		AREA AREA_3D AREA_STACKED AREA_STACKED_3D BARS BARS_3D (d) BARS_STACKED BARS_STACKED_3D BITMAP COLUMNS COLUMNS_3D COLUMNS_STACKED COLUMNS_STACKED_3D LINES LINES_3D PIE PIE_3D PIE_EX PIE_EX_3D PIE_SPLIT PYRAMID TREND	Taglib `chartType="PIE"` Classlib `setChartType(ChartType.PIE)`
colorOrder		DEFAULT (d) STRAIGHT REVERSE SNAKE	Taglib `colorOrder="SNAKE"` Classlib `setColorOrder (ChartColorOrder.SNAKE)`
displayObjectValues		FALSE (d) TRUE	Taglib `displayObjectValues="TRUE"` Classlib `setDisplayObjectValues(true)`
height		Unit (200)	Taglib `height="300"` Classlib `setHeight("300")`
id	*	String (cs)	Taglib `id="VacationPlanner"` Classlib `setId("VacationPlanner")`
legendPosition		EAST NONE NORTH SOUTH WEST	Taglib `legendPosition="SOUTH"` Classlib `setLegendPosition` `(ChartLegendPosition.SOUTH)`
model		Component	Taglib `model="` myBean.model `"` Classlib `setModel((` IChartModel `) model)`
title		String	Taglib `title="Bill board chart"` Classlib `setTitle("Bill board chart")`
titleCategories		String	Taglib `titleCategories="Brand"` Classlib `setTitleCategories("Brand")`
titleValues		String	Taglib `titleValues("Overview")` Classlib `setTitleValues("Overview")`
visible		FALSE TRUE (d)	Taglib `visible="FALSE"` Classlib `setVisible(false)`
voidValue		Numeric - Double	Taglib no tag available Classlib `setVoidValue(10.5)`
voidValueSet		FALSE TRUE (d)	Taglib no tag available Classlib `setVoidValueSet(false)`
width		Unit (500)	Taglib `width="400"` Classlib `setWidth("400")`

Example

using the taglib

    <hbj:chart
           id="myChart1"
           model="myChartBean.model"
           visible="true"
           displayObjectValues="true"
           titleCategories="Company"
           titleValues="Turnover"
           title="Washers by Companies!"
           chartType="BARS_3D"
           legendPosition="EAST"
           colorOrder="STRAIGHT"
    />

using the classlib. For information about setting up the bean, see " IChartModel ".

    Form form = (Form)this.getForm();
    Chart myChart = new Chart();
    myChart.setVisible(true);
    myChart.setDisplayObjectValues(true);
    myChart.setTitleCategories("Company");
    myChart.setTitleValues("Turnover");
    myChart.setTitle("Washers by Companies!");
    myChart.setChartType(ChartType.BARS_3D);
    myChart.setLegendPosition(ChartLegendPosition.EAST);
    myChart.setColorOrder(ChartColorOrder.STRAIGHT);

    MyVecBean myVecBean = new MyVecBean();
    IChartModel chartModel = myVecBean.getModel();
    myChart.setModel(chartModel);
    form.addComponent(myChart);

Result