Skip to main content
BuyLog In
.NET Reporting Tools
Search in…
Docs > Detailed Guide to DevExpress Reporting > Use Report Controls > Use Gauges and Sparklines > Add Gauges to a Report
A newer version of this page is available. .
All docs
V19.1
Reporting
Product Information
Get Started with DevExpress Reporting
Create Popular Reports
Detailed Guide to DevExpress Reporting
Introduction to Banded Reports
Provide Data to Reports
Use Report Controls
Add Controls to a Report
Manipulate Report Controls
Use Basic Report Controls
Use Tables
Use Bar Codes
Use Charts and Pivot Grids
Use Gauges and Sparklines
Add Gauges to a Report
Add Sparklines to a Report
Draw Lines and Shapes
Use Custom and Third-Party Controls
Shape Report Data
Arrange Dynamic Report Contents
Customize Appearance
Add Navigation
Provide Interactivity
Add Extra Information
Merge Reports
Use Expressions
Store and Distribute Reports
Reporting API
Visual Studio Report Designer
Create End-User Reporting Applications
Reporting in .NET Core 3 (CTP)
API Reference
ASP.NET Core API Reference
Client API Reference
Client API Reference (WebForms & MVC)
Download CHM

Add Gauges to a Report

  • 2 minutes to read

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

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:19.1: Report Controls Toolbox tab and drop it onto the report.

report-control-gauge-1

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

      XR_Gauge_Circular

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

    • Linear

      XR_Gauge_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.

    report-control-gauge-5

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.

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.

report-control-gauge-6

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 Bind Report Controls to Data topic to learn more about available data binding modes and creating data-aware controls.