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. Users can configure chart properties, define data sources, customize colors, and enable legends for enhance visualization. The component updates dynamically when linked to a DataTable or can be operate with static data for predefined charting.
On this page:
Requirements
This component is Portable, which means it will run both on Windows WPF displays and on Web Pages on any platform.
Configuration
To configure the PieChartPlus, access the Charts section in the Components Panel, select PieChartPlus, and place it in the drawing area. To edit its settings, double-click the object.
PieChartPlus Settings | |
---|---|
Field | Description |
Use DataTable | Enables linking a DataTable from any source to populate the chart. |
Use Auto Color | Automatically assigns chart colors. |
Show Legend | Displays the chart legend when selected. |
Show Value in Legend | Displays data values within the legend when selected. |
DataTable | Associates a DataTable with the chart. The table must include columns defined in Name Column, Value Column, and Color Column. |
Colors Enum | Uses an Enumeration to assign colors based on values defined in ActiveColor. The mapping is between the Enumeration’s value field and the column defined in Color Column of the DataTable. Enabled only when Use Auto Color is not selected. |
Center Size | Defines the radius of the chart's central circle. Controls the inner unfilled area, creating a donut-style visualization. |
Data Items | Lists the data items to be displayed in the chart. Items are added with the plus (+) button, removed with the minus (-) button, and reordered using the up/down arrows. Enabled only when Use DataTable is not selected. |
Field Name | Specifies the name of the field associated with the data item. Available only when Use DataTable is not selected. |
Field Value | Defines the value associated with the field. It can be set using a static number or by associating a tag with dynamic values. Available only when Use DataTable is not selected. |
Brush | Sets the color or brush used for the data item. Available only when Use DataTable is not selected. |
Name Column | Defines the column name in the DataTable for the data labels. Available only when Use DataTable is selected. |
Value Column | Defines the column name in the DataTable for the data values. Available only when Use DataTable is selected. |
Color Column | Defines the column name in the DataTable for the data colors. Available only when Use Auto Color is not selected and Use DataTable is selected. |
Runtime Execution
The PieChartPlus supports real-time data visualization through a linked DataTable or manually entered Data Items.
When Use DataSource is enabled, the chart updates dynamically based on the connected dataset. It retrieves data from the specified Name Column, Value Column, and Color Column, ensuring accurate real-time display. Users can interact with the chart to review distributions, observe trends, and compare categories. This mode is applicable for monitoring operational metrics, financial data, or other datasets that require continuous updates.
When Use DataSource is not selected, users can manually define data using Data Items. Each item includes a Field Name, Field Value, and Brush. This mode allows chart values to be defined manually, using static numbers or tags, without depending on external data sources.
DataTable Fail-Safe
If Use DataSource is enabled but the specified column names (Name Column, Value Column, Color Column) do not match any columns in the associated DataTable, the component does not render data from the table. Instead, it defaults to using the Data Items specified in the configuration. This fallback ensures that the chart continues to display data even if the linked DataTable is unavailable or misconfigured.
In this section: