ColumnChart
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