Linear Gauges

  • 3 minutes to read

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.

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.

LinearGaugeExamples

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

LinearGaugeSet

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

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:


LinearGauge gauge1 =  gaugeControl1.Gauges[0] as LinearGauge;

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:

Linear Gauge Elements

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

A Linear Gauge allows you 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.

LinearGaugeElements1

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.