[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gantt Control
  [Expand]Chart Control
   [Expand]Getting Started
    [Collapse]Gauge Types
      Circular Gauges
      Linear Gauges
      Digital Gauges
      State Indicator Gauges
    [Expand]Visual Elements
    [Expand]Appearance Customization
     Coordinate System
     Data Binding
     Saving and Restoring Gauge Layout and Style Settings
   [Expand]Design-Time Features
   [Expand]Product Information
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[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]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)

State Indicator Gauges

This document gives the detailed information on State Indicator Gauge types shipped with the XtraGauges Suite, as well as explains how they should be used in your application.

For details on other gauge types, refer to the corresponding topics of the Gauge Types section.

Expanded State Indicator Gauges Overview

A state indicator gauge is a container of state indicators - objects that have states and vector images associated with them.

Visually, a state indicator displays nothing but an image associated with the current state. When a state indicator's state changes, a corresponding image is automatically displayed. So, a state indicator gauge is appropriate for imitating static visual objects that have a fixed set of states (for instance, bulbs, traffic lights, arrows, etc).

The following image shows three gauges, each of which displays a static indicator having a specific state:

State indicators display images according to their states. A set of images for state indicators is predefined.

All images for state indicators can be grouped into the following categories:

  • Arrows;
  • Currency Symbols;
  • Flags;
  • Car lcons;
  • Electric Lights;
  • Smiles;
  • Traffic Lights.

Some of the images from these categories are shown below:

A full set of indicator's images is available at design time in the gauge Preset Manager.

Expanded StateIndicatorGauge Class

A State Indicator Gauge is represented by an instance of the StateIndicatorGauge class. This object can be accessed as an item of the GaugeCollection object returned by the GaugeControlBase.Gauges property of the GaugeControl object.

See the following code:

You can create a State Indicator Gauge control either at design time within Visual Studio or programmatically at runtime. The following examples demonstrate how it can be done:

Expanded State Indicator Elements

This section describes state indicator gauge elements, as well as gives a brief overview of their properties.

A state indicator gauge consists of base Indicator element.

The following image shows a sample state indicator gauge indicating gauge elements:

A state indicator gauge can display one or more state indicators, and each can have its own set of states. In the image above, the gauge contains two state indicators.

It provides the following main display options:

For more information on gauge elements, see the Visual Elements section.

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