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:

  • No labels