KpiElement.ActualValue Property

Gets or sets a measure that provides data for calculating the actual value.

Namespace: DevExpress.DashboardCommon

Assembly: DevExpress.Dashboard.v24.1.Core.dll

NuGet Package: DevExpress.Dashboard.Core

Declaration

C#

public Measure ActualValue { get; set; }

VB.NET

Public Property ActualValue As Measure

Property Value

Type	Description
Measure	A Measure object that provides data for calculating the actual value.

Remarks

The KpiDashboardItem<TKpiElement> descendants, such as the CardDashboardItem or GaugeDashboardItem, are used to present KPI data. These dashboard items display a number of individual elements (cards and gauges respectively) that show the difference between the actual and target values of a particular parameter. To provide data for each of these elements, you need to specify a pair of measures, where one of these measures contains data used to calculate the actual value, and the other provides data for the target value.

Use the ActualValue property to specify a measure that will be used to calculate the actual value. To specify a measure for the target value, use the KpiElement.TargetValue property.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ActualValue property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-dashboard-bind-card-item-to-data-in-code/CS/DXApplication1/ViewerForm1.cs#L37

Card card = new Card();
card.ActualValue = new Measure("RevenueQTD (Sum)");
card.TargetValue = new Measure("RevenueQTDTarget (Sum)");

winforms-dashboard-apply-conditional-formatting-to-cards/CS/CardFormatRulesSample/Form1.cs#L42

CardItemFormatRule fontStyleRule = new CardItemFormatRule();
fontStyleRule.DataItem = card.ActualValue;
fontStyleRule.ApplyToLayoutElement = CardFormatRuleLayoutElement.ActualValue;

wpf-dashboard-olap-data-provider/CS/WpfDashboard_OlapDataProvider/MainWindow.xaml.cs#L41

card.LayoutTemplate = new CardStretchedLayoutTemplate();
card.ActualValue = new Measure("[Measures].[Internet Sales Amount]");
card.TargetValue = new Measure("[Measures].[Sales Amount]");

VB.NET

winforms-dashboard-bind-card-item-to-data-in-code/VB/DXApplication1/ViewerForm1.vb#L35

Dim card As New Card()
card.ActualValue = New Measure("RevenueQTD (Sum)")
card.TargetValue = New Measure("RevenueQTDTarget (Sum)")

winforms-dashboard-apply-conditional-formatting-to-cards/VB/CardFormatRulesSample/Form1.vb#L45

Dim fontStyleRule As CardItemFormatRule = New CardItemFormatRule()
fontStyleRule.DataItem = card.ActualValue
fontStyleRule.ApplyToLayoutElement = CardFormatRuleLayoutElement.ActualValue

wpf-dashboard-olap-data-provider/VB/WpfDashboard_OlapDataProvider/MainWindow.xaml.vb#L36

card.LayoutTemplate = New CardStretchedLayoutTemplate()
card.ActualValue = New Measure("[Measures].[Internet Sales Amount]")
card.TargetValue = New Measure("[Measures].[Sales Amount]")