Instrumentation / Gauges / Indicators / Range Indicator
In This Topic
    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);