CHART

The CHART control allows you to present statistics information in a graph. You can choose among several different chart types. Additionally, you can choose the rendering format: SVG or JPEG.

The following topics are covered below:


About the SVG and JPEG Formats

When to use which format?

  • SVG
    SVG is a vector format. You can use it in printable documents because the quality of rendering is scalable.

  • JPEG
    JPEG is a format for pixel images. It has limited printing quality.

Example

The appearance of the chart can be customized statically at design time or dynamically at runtime. The Natural for Ajax demos contain the following examples, including layouts and corresponding Natural source code:

  • ctrlgraph
    Shows the settings for the static appearance.

  • ctrlgraph2
    Shows the settings for the dynamic appearance.

Chart

CHART Properties

Basic
height

Height of the chart. Use pixel definitions only, not percentage definitions.

Optional

1

2

3

int-value

width

Width of chart. Use pixel definitions only, not percentage definitions.

Optional

1

2

3

int-value

charttype

Type of chart - i.e. whether the output should be rendered as a set of lines, a set of bars, etc.

Optional

bar

3dbar

line

dotline

dashedline

area

point

stacked

stacked100

pie

pie2

pieexploded

pie2exploded

outputformat

Output format: SVG as default. Creation of various image types is supprted as well - please open valid values for seeing the list of supported types.

Optional

svg

jpeg

colors

Comma seperated list of colors. Example: #FF6060;#60FF60;#6060FF. A color is used to render a line. The first color is used for the first line, the second color for the second line and so on. If more lines exist than colors, the colors are used in turns. If no colors are specified a set of default colors is used.

Optional  
comment

Comment without any effect on rendering and behaviour. The comment is shown in the layout editor's tree view.

Optional  

CHARTCOLUMN Properties

Basic
property

Each item of a chart represents one line. Each line holds as information (1) the text of the line and (2) multiple key figures that are the values to be rendered as line. E.g. a line may have the values "region,revenue,cost,profit". In this case the "region" is the element passing the text of the line, whereas the other elements are passing the key figure information. For each element you maintain one CHARTCOLUMN item, each one pointing to the data element that passes the value at runtime.

Obligatory  
xaxisproperty

This is an indicator of the attribute "PROPERTY" is holding a text value (then "true") or a key figure value (then "false"). In the example of a line "region,revenue,cost,profit" the corresponding XAXISPROPERTY would be "true,false,false,false".

Optional

true

false

title

The text shown for this item as corresponding title on the xaxis. If no title is specified then the property name (see property above) is used as xaxis title.

Optional  
comment

Comment without any effect on rendering and behaviour. The comment is shown in the layout editor's tree view.

Optional