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 enhance visualization. The component updates dynamically updates when linked to a DataTable or can be used operate with static data for predefined charting needs.
On this page:
| Table of Contents | ||||
|---|---|---|---|---|
|
Requirements
This component is WPF only. It runs only on WPF PagesPortable, 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 configure it, doubleedit 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 |
Use Auto Color
. |
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. |
Show Legend
When selected, displays the chart legend.
Show Value in Legend
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 using through a linked DataTable or manually entered data items Data Items.
When Use DataSource is enabled, the chart updates 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 datareal-time display. Users can interact with the chart to analyze data review distributions, track observe trends, and compare different categories. This functionality mode is useful applicable for monitoring operational metrics, financial data, or other dynamic datasets that require continuous updates.
When Use DataSource is not selected, data users can be manually entered define data using Data Items. Each item consists of includes 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.
chart values to be defined manually, using static numbers or tags, without depending on external data sources.
| Info | ||
|---|---|---|
| ||
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:
| Page Tree | ||||
|---|---|---|---|---|
|