DoughnutChart
The DoughnutChart control displays a doughnut chart. A doughnut chart displays values as percentages of a whole, and each value is an individual slice of the whole. Doughnut charts are functionally identical to pie charts.
The DoughnutChart control does not support multiseries charts.
The DoughnutChart control supports displaying a sequence of charts when the data it receives from the data provider contains multiple data sets.
A multiseries chart is a chart that shows multiple data series. For example: conversion rate, visitors, and bounce rate.
Multiple data sets means that the data contains multiple complete and discrete data sets.
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 |
| ShowLegend | If true, the control displays a legend for the chart. | True |
| ShowValues | If true, the control displays 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 number, the control gives the chart this width in pixels.If the chart is part of a sequence of charts, 100% means each chart has the entire available width, and the chart sequence becomes a vertical sequence.If the chart is part of a sequence of charts, and you specify an integer, the control gives each chart this width in pixels, and the sequence of charts wraps horizontally. | 100% |
| Data | ||
| Data | Bind the control to the data it uses, for example: {Binding.DataProvider.Data} | |
| DataMapping | ||
| CategoryChartField | Point to a ChartField item. The control uses this field as labels for the slices. | |
| CategoryFilter | Specify one or more values like this: {value1,value2}. The control uses each of these values to filter the data column the CategoryChartField property points to. | |
| ValueChartFields | Point to a ChartField item. The control uses this field as the values of the slices. |
Configuration
You can create a configuration item for a DoughnutChart control by creating an item based on the DoughnutChart Parameters template.
The configuration item has these inherited fields:
- ShowAxis
- ValueChartFields
- SingleChartWidth
- CategoryChartField
- ShowLegend
- Data
- ShowValues
- CategoryFilter
- SingleChartHeight
- IsVisible
- AccessKey
- Tooltip
- Behaviors
- Id