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.
Pie Chart Plus PieChartPlus Settings | |||
|---|---|---|---|
Field | Description | ||
Use DataTable | When selected, allows 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. | ||
Data SourceDataTable | Associates the a DataTable with the chart. The columns must be named according to the table must include columns defined in Name Column, Value Column, and Color Column definitions. | Use Auto Color | Automatically defines the chart colors. |
Colors EnumerationEnum | Uses an Enumeration to associate assign colors based on values defined in ActiveColor. The association mapping is made between the Value Enumeration’s value field of the Enumeration and the column specified defined in Color Column of the DataTable linked in LinkedValue. Only enabled . Enabled only when Use Auto Color is not selected. | ||
Show Legend | When selected, displays the chart legend. | ||
Center Size | Defines the radius of the chart's central circle. Controls the inner unfilled area, creating a donut-style visualization | Show Value in Legend | When selected, displays the chart values in the legend. |
Data Items | Lists the data items to be included displayed in the chart. Items are added using with the plus (+) button and , removed using with the minus (-) button. Items can be , and reordered using the up and /down arrows. Only enabled Enabled only when Use DataTable is not selected. | ||
Field Name | Represents Specifies the name of the field associated with the data item. Available only when Use DataTable is not selected. | ||
Field Value | Specifies Defines the value linked to 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 | Determines Sets the color or brush used to display for the data item. Available only when Use DataTable is not selected. | ||
Name Column | Specifies Defines the column name in the DataTable for the data name in the DataTable linked in LinkedValuelabels. Available only when Use DataTable is selected. | ||
Value Column | Specifies Defines the column name in the DataTable for the data value in the DataTable linked in LinkedValuevalues. Available only when Use DataTable is selected. | ||
Color Column | Specifies Defines the column name in the DataTable for the data color in the DataTable linked in LinkedValuecolors. 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 | ||||
|---|---|---|---|---|
|