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 visualization. The component dynamically updates when linked to a DataTable or can be used with static data for predefined charting needs.

On this page:


Requirements

This component is WPF only. It runs only on WPF Pages.


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, double-click the object.

Pie Chart Plus Settings

Field

Description

Use DataSource

When selected, allows linking a DataTable from any source to populate the chart.

LinkedValue (DataSource)

Associates the DataTable with the chart. The columns must be named according to the Name Column, Value Column, and Color Column definitions.

Auto Color

Automatically defines the chart colors.

Color Enum

Uses an Enumeration to associate colors defined in ActiveColor. The association is made between the Value field of the Enumeration and the column specified in Color Column of the DataTable linked in LinkedValue. Only enabled when Auto Color is not selected.

Show Legend

When selected, displays the chart legend.

Show Value in Legend

When selected, displays the chart values in the legend.

Data Items

Lists the data items to be included in the chart. Items are added using the plus (+) button and removed using the minus (-) button. Items can be reordered using the up and down arrows. Only enabled when Use DataSource is not selected.

Field Name

Represents the name of the field associated with the data item. Available only when Use DataSource is not selected.

Field Value

Specifies the value linked to the field. Available only when Use DataSource is not selected.

Brush

Determines the color or brush used to display the data item. Available only when Use DataSource is not selected.

Name Column

Specifies the column name for the data name in the DataTable linked in LinkedValue. Available only when Use DataSource is selected.

Value Column

Specifies the column name for the data value in the DataTable linked in LinkedValue. Available only when Use DataSource is selected.

Color Column

Specifies the column name for the data color in the DataTable linked in LinkedValue. Available only when AutoColor is not selected and Use DataSource is selected.


Runtime Execution

The PieChartPlus supports real-time data visualization using a linked DataTable or manually entered data items.

When Use DataSource is enabled, the chart 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 data. Users can interact with the chart to analyze data distributions, track trends, and compare different categories. This functionality is useful for monitoring operational metrics, financial data, or other dynamic datasets that require continuous updates.

When Use DataSource is not selected, data can be manually entered using Data Items. Each item consists of 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.


In this section:

  • No labels