Configuring the Ranges (UltraLinearGauge)

Purpose

This topic explains, with code examples, how to configure ranges in the UltraLinearGauge™ control. This includes the number of ranges and their positions, lengths, widths, and formatting.

Required background

The following topics are prerequisites to understanding this topic:

Topic	Purpose
UltraLinearGauge Overview	This topic provides conceptual information about the UltraLinearGauge control including its main features, minimum requirements, and user functionality.

In this topic

This topic contains the following sections:

Configuring Comparative Ranges
Related Content

Configuring Comparative Ranges

Comparative ranges configuration summary

The UltraLinearGauge control supports multiple comparative ranges through populating its Ranges collection.

Each range can be configured individually by specifying its starting and ending value (in the measures of the scale), fill color, and border thickness and color. The size of a comparative range in the across-the-scale is configurable by adjusting its inner and outer margins.

Comparative ranges configuration summary chart

The following table explains briefly the configurable aspects of UltraLinearGauge control’s comparative ranges and maps them to properties that configure them.

Configurable aspects	Property	Default value
Number (of ranges in the graph)		Not set
Length, width, and position	LinearGraphRange.StartValue	Not set
	LinearGraphRange.EndValue	Not set
	LinearGraphRange.InnerStartExtent	Not set
	LinearGraphRange.InnerEndExtent	Not set
	LinearGraphRange.OuterStartExtent	Not set
	LinearGraphRange.OuterEndExtent	Not set
Fill color	LinearGraphRange.Brush	Defined in the default theme
Border color	LinearGraphRange.Outline	Defined in the default theme
Border thickness	LinearGraphRange.StrokeThickness	1.0

Note

Note:

If you do not explicitly provide values for the Brush and Outline properties for each range, the values are retrieved from the values of UltraLinearGauge ’s RangeBrushes and RangeOutlines collections. They can also be used to predefine a set of brushes to be used consecutively for setting each range’s color or outline fill.

Property settings

The following table maps the desired behavior to its respective property settings.

In order to configure:	Details	Use this property:	And set it to:
Range start	Position on the scale at which the range begins	LinearGraphRange.StartValue	The desired value (in the measures of the scale)
Range end	Position on the scale at which the range ends	LinearGraphRange.EndValue	The desired value (in the measures of the scale)
Inner vertex of the starting edge of the range	The position of the inner vertex of the starting edge across the scale relative to the edge of the Reserved area. (Inner vertex is the point of the starting edge that is the closest to the edge of the Reserved area.)	LinearGraphRange.InnerStartExtent	The desired value as a relative part of the height/width of the Graph area depending on the orientation (horizontal / vertical) presented as a fraction of 1 (e.g. _0.2 )
Inner vertex of the ending edge of the range	The position of the inner vertex of the ending edge across the scale relative to the edge of the Reserved area	LinearGraphRange.InnerEndExtent	The desired value as a relative part of the height/width of the Graph area depending on the orientation (horizontal / vertical) presented as a fraction of 1 (e.g. 0.3 )
Outer vertex of the starting edge of the range	The position of the outer vertex of the starting edge across the scale relative to the edge of the Reserved area. (Outer vertex is the point of the starting edge that is the closest to the edge of the Reserved area)	LinearGraphRange.OuterStartExtent	The desired value as a relative part of the height/width of the Graph area depending on the orientation (horizontal / vertical) presented as a fraction of 1 (e.g. 0.7 )
Outer vertex of the ending edge of the range	The position of the outer vertex of the ending edge across the scale relative to the edge of the Reserved area	LinearGraphRange.OuterEndExtent	The desired value as a relative part of the height/width of the Graph area depending on the orientation (horizontal / vertical) presented as a fraction of 1 (e.g. 0.8 )
Fill color	Fill color of the range	LinearGraphRange.Brush	The desired color
Border thickness	Thickness of the range’s border	LinearGraphRange.StrokeThickness	The desired value in pixels
Border color	Color of the range’s border	LinearGraphRange.Outline	The desired color

Example

The screenshot below demonstrates how a comparative range added to the UltraLinearGauge looks as a result of the following settings:

Property	Value
Brush	“Green”
StartValue	“6”
EndValue	“89”
InnerStartExtent	“0.5”
InnerEndExtent	“0.5”
OuterStartExtent	“0.8”
OuterEndExtent	“0.8”
Outline	“Black”

XamLinearGauge Configuring Ranges 1 17 1.png

Following is the code that implements this example.

In C#:

var range1 = new LinearGraphRange();
range1.Brush = new SolidColorBrush(Color.FromArgb(0, 255, 0));
range1.Caption = "range1";
range1.StartValue = 6;
range1.EndValue = 89;
range1.InnerEndExtent = .5;
range1.InnerStartExtent = .5;
range1.OuterEndExtent = .8;
range1.OuterStartExtent = .8;
range1.Outline = new SolidColorBrush(Color.FromArgb(0, 0, 0));

In Visual Basic:

Dim range1 As New LinearGraphRange
 With range1
      .Brush = New SolidColorBrush(Color.FromArgb(0, 255, 0))
      .Caption = "range1"
      .StartValue = "6"
      .EndValue = "89"
      .InnerEndExtent = ".5"
      .InnerStartExtent = ".5"
      .OuterEndExtent = ".8"
      .OuterStartExtent = ".8"
      .Outline = New SolidColorBrush(Color.FromArgb(0, 0, 0))
 End With

Topic	Purpose
Configuring the Scale ( UltraLinearGauge )	This topic explains, with examples, how to configure the scale of the UltraLinearGauge control. This includes positioning the scale inside the control and configuring the scale tick marks and labels.
Configuring the Needle (UltraLinearGauge)	This topic explains, with code examples, how to configure the needle of the UltraLinearGauge control. This includes the needle’s value, width, and formatting.
Configuring the Background ( UltraLinearGauge )	This topic explains, with code examples, how to configure a background for the linear gauge. This includes setting the background’s size, position, color, and border.

Windows Forms | Help Topics