[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
 [Expand]Product Information
 [Expand]Getting Started with DevExpress Reporting
 [Expand]Creating Popular Reports
 [Collapse]Detailed Guide to DevExpress Reporting
   Introduction to Banded Reports
  [Expand]Providing Data to Reports
  [Collapse]Using Report Controls
    Adding Controls to a Report
    Manipulating Report Controls
   [Expand]Using Basic Report Controls
   [Expand]Using Tables
   [Expand]Using Bar Codes
   [Expand]Using Charts and Pivot Grids
   [Collapse]Using Gauges and Sparklines
     Adding Gauges to a Report
     Adding Sparklines to a Report
   [Expand]Drawing Lines and Shapes
   [Expand]Using Custom and Third-Party Controls
  [Expand]Shaping Report Data
   Laying out Dynamic Report Contents
  [Expand]Customizing Appearance
  [Expand]Adding Navigation
  [Expand]Providing Interactivity
  [Expand]Adding Customary Information
  [Expand]Merging Reports
  [Expand]Using Expressions
  [Expand]Storing and Distributing Reports
  [Expand]Reporting API
 [Expand]Visual Studio Report Designer
 [Expand]Creating End-User Reporting Applications
 [Expand]API Reference
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
This documentation page describes implementations made in our v17.2 release cycle. To learn about functionality shipping with v18.1, navigate to our updated help file experience at docs.devexpress.com. Learn More

Adding Gauges to a Report

This topic explains XRGauge control basics and describes its main features.

The document consists of the following sections.

Expanded Gauge Overview

The XRGauge control provides you with the capability to embed graphical gauges into your report.

To add this control to the report, drag the XRGauge item from the DX:18.1: Report Controls Toolbox tab and drop it onto the report.

The following properties determine XRGauge appearance.

  • View Type

    Specifies the type of the displayed gauge. Each view type supports different View Styles. The following XRGauge view types are available.

    • Circular

      Supports view styles: Full, Half, Quarter Left, Quarter Right and Three Fourth.

    • Linear

      Supports view styles: Horizontal and Vertical.

  • View Theme

    Specifies the color theme of the displayed gauge. The FlatLight and FlatDark view themes are supported.

The following properties allow you to customize the gauge scale and specify its displayed values.

  • Actual Value

    Specifies the value displayed by a gauge.

  • Target Value

    Specifies the position of the target value marker.

  • Maximum

    Specifies the gauge's maximum value.

  • Minimum

    Specifies the gauge's minimum value.

These properties can be bound to a numeric data field obtained from the report's data source.

Expanded Bind a Gauge to Data

To bind the displayed value of an XRGauge to data, click the control's smart tag and in the invoked actions list, expand the Expression drop-down list for the ActualValue property and select the required data field.

In the same way, you can bind the Target Value, Minimum and Maximum properties to data. To do this, expand the Expression drop-down list for corresponding property and select the required data field.

Clicking the Expression option's ellipsis button invokes the Expression Editor, in which you can construct a complex binding expression involving two or more data fields.

See the Binding Report Controls to Data topic to learn more about available data binding modes and creating data-aware controls.

Is this topic helpful?​​​​​​​