Range Indicator

In This Topic

Range indicators are useful when you have to highlight important ranges of data on the gauge axis. Range indicators can also have different begin and end width that can be used to visually highlight the importance of different values within the range.

Creating a Range Indicator

In order to create a range indicator you must first create an instance of the NRangeIndicator class and then add it to the Indicators collection of the gauge. The following code snippet creates a simple range indicator:

C#	Copy Code
// Create a range indicator NRangeIndicator rangeIndicator = new NRangeIndicator(); rangeIndicator.Value = 20; someGauge.Indicators.Add(rangeIndicator);

Range

The range indicator has three properties that combined determine the scale range of the indicator. The first one is called Value and it controls either the begin or end value of the range depending of which one is bigger.

The OriginMode property allows you to anchor the range to the scale min, scale max or a custom value as shown by the following table:

Range indicator with origin set to ScaleMax and Value set to 80	Range indicator with origin set to ScaleMin and Value set to 80	Range indicator with origin set to Custom, Value set to 80 and Custom set to 20

The following code will create two range indicators – the first one spans [ScaleMin, 20] and the second one spans [80, ScaleMax]:

C#	Copy Code
// Create a range indicator annotating [ScaleMin, 20] NRangeIndicator rangeIndicator1 = new NRangeIndicator(); rangeIndicator1.OriginMode = ENRangeIndicatorOriginMode.ScaleMin; rangeIndicator1.Value = 20; someGauge.Indicators.Add(rangeIndicator1); // Create a range indicator annotating [80, ScaleMax] NRangeIndicator rangeIndicator2 = new NRangeIndicator(); rangeIndicator2.OriginMode = ENRangeIndicatorOriginMode.ScaleMax; rangeIndicator2.Value = 80; someGauge.Indicators.Add(rangeIndicator2);

Copy Code

// Create a range indicator annotating [ScaleMin, 20]
NRangeIndicator rangeIndicator1 = new NRangeIndicator();
rangeIndicator1.OriginMode = ENRangeIndicatorOriginMode.ScaleMin;
rangeIndicator1.Value = 20;
someGauge.Indicators.Add(rangeIndicator1);

// Create a range indicator annotating [80, ScaleMax]
NRangeIndicator rangeIndicator2 = new NRangeIndicator();
rangeIndicator2.OriginMode = ENRangeIndicatorOriginMode.ScaleMax;
rangeIndicator2.Value = 80;
someGauge.Indicators.Add(rangeIndicator2);