Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [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]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Collapse]Gauges
   [Expand]Getting Started
   [Collapse]Concepts
    [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]Examples
   [Expand]Product Information
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap 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]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

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.

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