Nevron .NET Vision Documentation
Needle Indicator

Needle indicators are visualized by radial gauges and are represented by smart shapes with two anchor points – the first anchor point is the radial gauge center and the second one is the scaled value of the needle indicator.

Needle Value

The needle Value property defines how the needle is oriented in the radial gauge. The following code will change the value of a newly created needle indicator:

C#
Copy Code
nChartControl1.Panels.Clear();
NRadialGaugePanel radialGauge = new NRadialGaugePanel();
nChartControl1.Panels.Add(radialGauge); 
NNeedleValueIndicator needle = new NNeedleValueIndicator();
needle.Value = 10; 
radialGauge.Indicators.Add(needle);
nChartControl1.Refresh();
Visual Basic
Copy Code
NChartControl1.Panels.Clear() 
Dim radialGauge As New NRadialGaugePanel
NChartControl1.Panels.Add(radialGauge)
Dim needle As New NNeedleValueIndicator
needle.Value = 10
radialGauge.Indicators.Add(needle)
NChartControl1.Refresh()
Needle Shape

The needle shape is controlled through the needle Shape property accepting 1D smart shape definitions. Similar to the way you modify the marker indicator shapes if you want to modify the needle appearance you need to change its shape. One way to do this is to use the built-in N1DSmartShapeFactory class:

C#
Copy Code
nChartControl1.Panels.Clear();
NRadialGaugePanel radialGauge = new NRadialGaugePanel();
nChartControl1.Panels.Add(radialGauge);
NNeedleValueIndicator needle = new NNeedleValueIndicator();
needle.Value = 10; 
N1DSmartShapeFactory factory = new N1DSmartShapeFactory(new NColorFillStyle(Color.Red), new NStrokeStyle(Color.DarkRed), new NShadowStyle());
needle.Shape = factory.CreateShape(SmartShape1D.Arrow1);

radialGauge.Indicators.Add(needle); 
nChartControl1.Refresh();
Visual Basic
Copy Code
NChartControl1.Panels.Clear()
Dim radialGauge As New NRadialGaugePanel
NChartControl1.Panels.Add(radialGauge)
Dim needle As New NNeedleValueIndicator
needle.Value = 10
Dim factory As New N1DSmartShapeFactory(New NColorFillStyle(Color.Red), New NStrokeStyle(Color.DarkRed), New NShadowStyle)
needle.Shape = factory.CreateShape(SmartShape1D.Arrow1) 
radialGauge.Indicators.Add(needle) 
NChartControl1.Refresh()
Needle Appearance

Needle appearance is controlled through the smart shape FillStyle, StrokeStyle and ShadowStyle properties. The following code snippet will change the needle filling and stroke to dark green:

C#
Copy Code
nChartControl1.Panels.Clear();
NRadialGaugePanel radialGauge = new NRadialGaugePanel();
nChartControl1.Panels.Add(radialGauge); 
NNeedleValueIndicator needle = new NNeedleValueIndicator();
needle.Value = 10;
needle.Shape.FillStyle = new NColorFillStyle(Color.DarkGreen);
needle.Shape.StrokeStyle = new NStrokeStyle(Color.DarkGreen); 
radialGauge.Indicators.Add(needle); 
nChartControl1.Refresh();
Visual Basic
Copy Code
NChartControl1.Panels.Clear()
Dim radialGauge As New NRadialGaugePanel
NChartControl1.Panels.Add(radialGauge) 
Dim needle As New NNeedleValueIndicator
needle.Value = 10
needle.Shape.FillStyle = New NColorFillStyle(Color.DarkGreen)
needle.Shape.StrokeStyle = New NStrokeStyle(Color.DarkGreen)
radialGauge.Indicators.Add(needle) 
NChartControl1.Refresh()
Needle Width

The width of the needle is controlled through the Width property of the NNeedleValueIndicator class:

C#
Copy Code
nChartControl1.Panels.Clear();
NRadialGaugePanel radialGauge = new NRadialGaugePanel();
nChartControl1.Panels.Add(radialGauge); 
NNeedleValueIndicator needle = new NNeedleValueIndicator();
needle.Value = 10;
needle.Width = new NLength(10); 
radialGauge.Indicators.Add(needle); 
nChartControl1.Refresh();
Visual Basic
Copy Code
NChartControl1.Panels.Clear()
Dim radialGauge As New NRadialGaugePanel
NChartControl1.Panels.Add(radialGauge) 
Dim needle As New NNeedleValueIndicator
needle.Value = 10
needle.Width = New NLength(10) 
radialGauge.Indicators.Add(needle) 
NChartControl1.Refresh()
Related Examples

Windows forms: Gauge Gallery\Gauges\Indicators

Web forms: Gauge Gallery\Gauges\Indicators

 

See Also

NMarkerValueIndicator | NSmartShape | N2DSmartShapeFactory | Smart Shapes

See Also

 

 


©2017. Nevron Software LLC.

Send Feedback