[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
  Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
   Reporting
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Collapse]Gauge Controls
   [Expand]Getting Started
    Scales
    Value Indicators
   [Expand]Visual Elements
    Themes
   [Expand]Examples
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Printing-Exporting
  [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
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[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.

Note

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?​​​​​​​