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 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 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 defines the assigns chart colors. |
Show Legend | When selected, displays Displays the chart legend when selected. |
Show Value in Legend | When selected, displays the chart values in Displays data values within the legend when selected. |
DataTable | 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. |
Colors Enum | 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 associated DataTable. Only enabled Enabled only when Use Auto Color is not selected. |
Center Size | Specifies Defines the size radius of the chart's central circle radius of the pie chart. This value defines . Controls the inner unfilled area that remains unfilled by chart segments, enabling , creating a donut-style chart visualization. |
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 associated DataTablelabels. Available only when Use DataTable is selected. |
Value Column | Specifies Defines the column name in the DataTable for the data value in the associated DataTablevalues. Available only when Use DataTable is selected. |
Color Column | Specifies Defines the column name in the DataTable for the data color in the associated DataTablecolors. 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 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 the actual column names any columns in the associated DataTable, the component does not attempt to render chart data from the DataTabletable. Instead, it falls back defaults to rendering the chart using the Data Items defined specified in the control configuration. This behavior acts as a fail-safe to ensure fallback ensures that the chart continues to display data even when if the linked DataTable is unavailable or misconfigured or unavailable. |
In this section:
| Page Tree | ||||
|---|---|---|---|---|
|