Ranges
- 2 minutes to read
In many cases, you may wish to visually identify specific ranges of values along scales in analog gauges (circular and linear). For instance, you may want to mark some safe or critical value ranges. This feature can easily be implemented via custom ranges.
Ranges Overview
Ranges allow you to mark certain value ranges in circular and linear gauges. Visually, they are displayed as bars along scales. These bars can be rectangular in linear gauges or rounded in circular gauges.
In the following image, a circular gauge contains two range bars (green and red), and a linear gauge contains three range bars (green, yellow and red).
Ranges belong to a scale and can be created and accessed via the scale's Ranges collection (ArcScale.Ranges or LinearScale.Ranges).
In circular gauges, ranges are represented by ArcScaleRange class objects, and in linear gauges these are represented by LinearScaleRange class objects.
To create a range at design time, do the following.
Locate the Gauge control's smart tag and click Customize Gauge Control....
Then, in the Visual Gauge Control Designer, locate the scale's smart tag and click Run Designer.
In the Scales - Element Designer, click the Ranges... button, as shown below.
The Scale Ranges editor allows you to create new, delete or customize existing ranges.
Each range provides properties that allow its visual options to be modified. The main properties are:
BaseRange.StartValue and BaseRange.EndValue - specify the starting and ending absolute values for the range along the scale;
if you prefer to specify a range's bounds as a percentage, use the ScaleRange.StartPercent and ScaleRange.EndPercent properties instead;
- BaseRange.ShapeOffset - the offset of the bar's edge from the scale axis in relative coordinates;
- BaseRange.StartThickness and BaseRange.EndThickness - the thickness of the bar at the starting and ending points;
- BaseRange.AppearanceRange - contains appearance settings for the range.