ColumnChart

Version: 9.0

The ColumnChart control shows a column chart. A columns chart shows rectangular columns with lengths proportional to the values that they represent. The control plots the columns vertically. The BarChart control is very similar, except that this control plots the columns (“bars”) horizontally.

The ColumnChart control supports multiseries charts. When a ColumnChart control shows a multiseries chart, you can decide whether it shows the series stacked or unstacked.

The ColumnChart control supports showing a sequence of charts when the data it receives from the data provider contains multiple datasets.

Properties

Name

Description

Default

Appearance

DisableSelection

If True, the control does not allow chart items to be selected.

False

EnableAnimation

If True, the control uses animations.

False

ShowAxis

If True, the control shows axes.

True

ShowLegend

If True, the control shows a legend for the chart.

True

ShowValues

If True, the control shows the values of the data points inside the graph itself.

False

SingleChartHeight

Specify the height in pixels of the chart.

If the chart is part of a sequence of charts, the control gives each individual chart this height.

400

SingleChartWidth

If you specify 100%, the chart takes up the available width. If you specify a integer, the control gives the chart this integer as the width in pixels.

If the chart is part of sequence of charts, 100% means that each chart has the entire available width, and the chart sequence becomes a vertical sequence.

If the chart is part of sequence of charts, and you specify an integer, the control gives each chart this integer as the width in pixels, and the sequence of charts wraps horizontally.

100%

StackSeries

If True, the control stacks the distinctive series in a multiseries chart.

False

VisibleCategoriesRange

In a multiseries chart, if this number is > 0, the control shows this number of categories along the horizontal axis. If the data contains more categories than the number specified, users have to scroll horizontally.

If this number is 0, the control shows all categories, and these are scaled to the width of the chart.

0

Data

Data

Bind to the data that the control uses, for example: {Binding.DataProvider.Data}

DataMapping

CategoryChartField

Point to a ChartField item. The control uses this field as the X (horizontal) axis of the chart.

CategoryFilter

Specify one or more values like this: “{value1,value2}”. The control uses each of these values to filter the data column that the CategoryChartField property points to.

SeriesChartField

Point to a ChartField item. The control uses this field as the definition of the series that it shows.

SeriesFilter

Specify one or more values like this: {value1,value2}. The control uses each of these values as a facet of the data column that the SeriesChartField property points to.

If you do not enter anything, the control creates a facet for each distinct value in the data column.

ValueChartFields

Point to a ChartField item. The control uses this field as the Y (vertical) axis of the chart.

Configuration

You can create a configuration item for a ColumnChart control by creating an item based on the ColumnChart Parameters template.

The configuration item has these inherited fields:

  • ShowAxis

  • ValueChartFields

  • SingleChartWidth

  • CategoryChartField

  • ShowLegend

  • Data

  • ShowValues

  • CategoryFilter

  • SingleChartHeight

  • IsVisible

  • AccessKey

  • Tooltip

  • Behaviors

  • Id

  • VisibleCategoriesRange

  • SeriesChartField

  • SeriesFilter

  • StackSeries

Do you have some feedback for us?

If you have suggestions for improving this article,