The PieChartPlus is a graphical component designed for visualizing data proportions in Displays/Draw. It supports both DataTable integration and manual data entry, allowing users to represent and analyze data distributions effectively. Users can configure chart properties, define data sources, customize colors, and enable legends for better visualization. The component dynamically updates when linked to a DataTable or can be used with static data for predefined charting needs.
On this page:
| Table of Contents | ||||
|---|---|---|---|---|
|
Requirements
This component is WPF only. It runs only on WPF Pages.
Configuration
To configure the PieChartPlus, access the Charts section in the Components Panel, select PieChartPlus, and place it in the drawing area. To configure it, double-click the object.
Pie Chart Plus Settings | |
|---|---|
Field | Description |
Control Name
Defines a name for the control so it can be accessed in the CodeBehind script. See Display CodeBehind.
Use DataSource | When selected, allows linking a DataTable from any source to populate the chart. |
LinkedValue (DataSource) | Associates the DataTable with the chart. The columns must be named according to the Name Column, Value Column, and Color Column definitions. |
Auto Color | Automatically defines the chart colors. |
Color Enum | Uses an Enumeration to associate colors defined in ActiveColor. The association is made between the Value field of the Enumeration and the column specified in Color Column of the DataTable linked in LinkedValue. Only enabled when Auto Color is not selected. |
Show Legend | When selected, displays the chart legend. |
Show Value in Legend | When selected, displays the chart values in the legend. |
Data Items | Lists the data items to be included in the chart. Items are added using the plus (+) button and removed using the minus (-) button. Items can be reordered using the up and down arrows. Only enabled when Use DataSource is not selected. |
Field Name | Represents the name of the field associated with the data item. Available only when Use DataSource is not selected. |
Field Value | Specifies the value linked to the field. Available only when Use DataSource is not selected. |
Brush | Determines the color or brush used to display the data item. Available only when Use DataSource is not selected. |
Name Column | Specifies the column name for the data name in the DataTable linked in LinkedValue. Available only when Use DataSource is selected. |
Value Column | Specifies the column name for the data value in the DataTable linked in LinkedValue. Available only when Use DataSource is selected. |
Color Column | Specifies the column name for the data color in the DataTable linked in LinkedValue. Available only when AutoColor is not selected and Use DataSource is selected. |
Runtime Execution
The PieChartPlus supports real-time data visualization using a linked DataTable or manually entered data items.
When Use DataSource is enabled, the chart dynamically updates based on changes in the connected dataset. It retrieves data from the specified Name Column, Value Column, and Color Column, ensuring accurate representation of live data. Users can interact with the chart to analyze data distributions, track trends, and compare different categories. This functionality is useful for monitoring operational metrics, financial data, or other dynamic datasets that require continuous updates.
When Use DataSource is not selected, data can be manually entered using Data Items. Each item consists of a Field Name, Field Value, and Brush for color selection. This mode allows for static data representation, enabling users to define chart values independently without relying on external sources.
In this section:
| Page Tree | ||||
|---|---|---|---|---|
|