Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Collapse]Reporting
 [Expand]Product Information
 [Expand]Getting Started
 [Expand]Fundamental Concepts
 [Collapse]Concepts
  [Expand]Report Types
  [Collapse]Report Controls
   [Expand]Bar Code
    Character Comb
    Chart
    Check Box
    Cross-Band Controls
   [Expand]Custom Controls
    Gauge
    Label
    Line
    Page Break
    Page Info
    Panel
    Picture Box
    Pivot Grid
    Rich Text
   [Expand]Shape
    Sparkline
    Subreport
    Table
    Table of Contents
   [Expand]Third Party Controls
    Zip Code
  [Expand]Platform-Specific Reporting
  [Expand]Creating Reports
  [Expand]Storing Reports
  [Expand]Publishing Reports
  [Expand]End-User Reporting
  [Expand]Application Appearance
  [Expand]Migration to XtraReports
 [Expand]Design-Time Features
 [Expand]Examples
  End-User Capabilities
 [Expand]Localization
 [Expand]Redistribution and Deployment
 [Expand]API Reference
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
[Expand]End-User Documentation

Gauge

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:17.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 Data Bindings drop-down list for the ActualValue property and select the required data field.

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

How would you rate this topic?​​​​​​​