[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)

Linear Gauges

This document provides you with information on what Linear Gauge types are exist in XtraGauges Suite and explains how you can use these gauges in your application.

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

Expanded Linear Gauges Overview

Linear Gauge is a component that represents visual elements on a linear scale.

You can use this control in different applications for creating thermometers, indicators.

The XtraGauges Suite provides Linear Gauges of two types: vertical and horizontal.

A full set of linear gauge shapes is available at design time in the gauge Preset Manager.

Expanded LinearGauge Class

Linear Gauge is represented by an instance of the LinearGauge 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 Linear Gauge control either at design time within Visual Studio or programmatically at runtime. The following examples demonstrate how it can be done:

Expanded Linear Gauge Elements

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

A Linear Gauge allows to add numerous elements, each of which is intended to perform a specific task.

The following image demonstrates a Linear Gauge containing a full set of elements.

A Scale is the main element of a linear gauge, as the scale defines the axis, along which other elements (level bar, marker, background layer, etc) are arranged. A linear gauge can have one or more scales displaying tickmarks.

A scale within linear gauges is represented by the LinearScaleComponent class. It provides the following main display options:

The Level Bar indicates the current value by filling a bar along the scale's axis. Typically, there is only one level bar in a linear gauge, and it indicates the current value. The level bar must be associated with a particular scale. Once it has been associated with a scale, it automatically fills a bar along that scale, starting at the scale's minimum value and extending to the scale's current value.

A level bar is represented by the LinearScaleLevelComponent class. It provides the following main display options:

A Background Layer represents the background of the gauge. It is represented by the LinearScaleBackgroundLayerComponent class. This visual element provides the following main options:

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

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