.netCHARTING v5.2 Documentation Send comments on this topic.
Gauge Types
Getting Started > General Tutorials > Chart Type Anatomy 101 > Gauge Types

Glossary Item Box

Introduction
A number of different gauge types are available within the gauge series type and can be specified by the Series.GaugeType property. Each series on a gauge chart can use a different gauge type setting.

[C#]

mySeries.GaugeType = GaugeType.Circular;
[Visual Basic]

mySeries.GaugeType = GaugeType.Circular
Gauges can also be used with ChartType.Multiple and ChartType.MultipleGrouped when Series.Type = SeriesTypeMultiple.Gauges.

 

Automatic Padding Feature
Generally many of these gauge types are used by themselves without a legend or other features. When the chart detects that the legend is not visible and the chart area is not drawn (by using ChartArea.ClearColors()), it will automatically get rid of additional padding around the gauge.

 

Manual Sizing and Positioning (New in v4.4)
A static size can be applied to any gauge series by using the series.GaugeBorderBox.Position property and specifying a Size object.

[C#]

mySeries.GaugeBorderBox.Position = new Size(100,100);
[Visual Basic]

mySeries.GaugeBorderBox.Position = new Size(100,100)

This feature also allows absolute positioning of each gauge when a Rectangle object is used instead.

 

[C#]

mySeries.GaugeBorderBox.Position = new Rectangle(20,20,100,100);
[Visual Basic]

mySeries.GaugeBorderBox.Position = new Rectangle(20,20,100,100)
Circular gauges height must be the same as their width, therefore, only the specified Width is used with this feature.

 

QuickStart Illustration
The following illustration shows which properties control certain aspects of gauge types.

ImageTitle
Click to EnlargeClick to Enlarge

 

Gauge type options (Series.GaugeType)

Circular
The circular type is the default gauge type used.

Custom Image Needles
This type also supports using custom images as needles along with the DynamicColor feature of ElementMarkers. For more information on using custom needles, see the Element Markers.

Supported Features

Related Properties

 

Bars
This gauge type can be useful displaying element values when an axis scale is not necessary.

Supported Features

 

Related Properties

 

 

Digital Readout
This gauge type can be used to display element values using a digital readout style.

Supported Features

 

Related Properties

 

 

IndicatorLights
These indicator LEDs can be used to convey the status of an element. If the element's value is < 0, the element's LED is grayed out, if the value is above zero, the element's color is used.

SmartPalette
Using smartPalettes with this type, the gray/colored feature based on value is deactivated. The smart palette is used to determine the element's color instead.

The size of the LEDs on a particular chart can be specified with Chart.DefaultElement.Marker.Size, however, by default the LED sizes are determined dynamically. The actual element markers however can be drawn separately on top of the LEDs when Element.ForceMarker is true as shown in sample Gallery/h018.aspx

Supported Features

 

Related Properties

 

Horizontal & Vertical (Includes Thermometers)
The horizontal and vertical gauge types are linear bar gauges with the YAxis but no XAxis. The y axis applies to both horizontal and vertical the same way, when the type is horizontal, the YAxis is the horizontal one and with vertical, the YAxis is vertical.

Normal & Thermometer styles
To use the thermometer variation use the following setting:

 

[C#]

Chart.DefaultSeries.GaugeLinearStyle = GaugeLinearStyle.Thermometer;
[Visual Basic]

Chart.DefaultSeries.GaugeLinearStyle = GaugeLinearStyle.Thermometer

 

Bar Widths
By default the element widths snap to the size of the gauge's mini chart area, however, the XAxis.SpacingPercentage or XAxis.StaticColumnWidth settings will be used if specified.

 

Supported Features

Related Properties

 

Please see the Features > Gauge Type Tweaks section in samples for examples using gauge types.

 

©2008. All Rights Reserved.