dashboard-devexpress-dot-dashboardcommon-dot-kpielement.md
Gets or sets a measure that provides data for calculating the actual value.
Namespace : DevExpress.DashboardCommon
Assembly : DevExpress.Dashboard.v25.2.Core.dll
NuGet Package : DevExpress.Dashboard.Core
public Measure ActualValue { get; set; }
Public Property ActualValue As Measure
| Type | Description |
|---|---|
| Measure |
A Measure object that provides data for calculating the actual value.
|
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.
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.
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]");
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]")
See Also