[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
 [Expand]What's Installed
 [Expand].NET Core 3 Support
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Collapse]Gauge Controls
   [Expand]Getting Started
    Value Indicators
   [Expand]Visual Elements
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Gantt Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Value Indicators

This document gives the definition of a value indicator and also explains what types of value indicators exist and how they should be used in a Gauge control.

A Value Indicator is a dynamic gauge element that is used to track the changing of a data value or a data range on a scale. This value can be accessible via the ValueIndicatorBase.Value property of the ValueIndicatorBase class.


The ValueIndicatorBase.Value property of the value indicator can be changed not only programmatically, but also by end-users via mouse-clicks. This capability becomes available after setting the ValueIndicatorBase.IsInteractive property to true. For real-life examples on how this can be done, see the How to: Enable Indicator Value's Changing via a Mouse Click tutorial.

Depending on the type of a Scale, various kinds of value indicators can be used with it.

Expanded Arc Scale's Indicators

The following value indicators are appropriate for the Arc Scale.

Element Description Class Collection Accessibilty
Needle A needle-like element that is used to indicate a current value in a Circular Gauge. ArcScaleNeedle ArcScaleNeedleCollection ArcScale.Needles
Marker A Marker is a small pointer that indicates a fixed value. ArcScaleMarker ArcScaleMarkerCollection ArcScale.Markers
Range Bar A Range Bar is a filled sector that represents a specific interval (e.g. working hours). ArcScaleRangeBar ArcScaleRangeBarCollection ArcScale.RangeBars

Value indicators for the circular scale are shown in the image below:

Expanded Linear Scale's Indicators

In the Linear Scale three types of value indicators are available.

Element Description Class Collection Accessibilty
Level Bar A Level Bar performs the same function as a conventional thermometer (e.g. the current temperature). LinearScaleLevelBar LinearScaleLevelBarCollection LinearScale.LevelBars
Marker A Marker is a scale pointer that indicates a certain value along a scale (e.g. an average temperature in a thermometer). LinearScaleMarker LinearScaleMarkerCollection LinearScale.Markers
Range Bar A Range Bar is a filled rectangle that represents some data range along a scale. LinearScaleRangeBar LinearScaleRangeBarCollection LinearScale.RangeBars

Value indicators for linear scale are illustrated in the image below.

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