Configuring Needles (UltraRadialGauge)

Purpose

This topic provides a conceptual overview of needles with the UltraRadialGauge™ control. It describes the properties of the needles and also provides an example of how to configure them.

Required background

The following topics are prerequisites to understanding this topic:

Topic	Purpose
UltraRadialGauge	This section gives you an overview of the UltraRadialGauge™ control and its main features.
Adding UltraRadialGauge	This topic explains using a code example how to add the UltraRadialGauge™ control to a Windows Forms application.

In this topic

This topic contains the following sections:

Needles Overview
Preview
Needle Properties
Configuring the Needle
Configuring the Highlight Value Needle
Related Content

Needles Overview

Needles overview

A gauge needle is a visual element used to signify a gauge set value and consists of needle cap overlays or underlays; the gauge needle’s pivot point. The supported needle shapes and caps are set using the NeedleShape and NeedlePivotShape properties. For a visual representation of the different needle shape and the pivot shape refer to the needle sample

Preview

The following image is a preview of the UltraRadialGauge control with the needle’s Value property set to 60.

Needle Properties

Needle properties summary

The following table summarizes the properties the UltraRadialGauge control related to the needle.

Property Name	Property Type	Description
Value	`double`	Determines the value on the gauge to which the needle points.
NeedleStartExtent	`double`	Determines the beginning position of the needle, measured from the center of the gauge. The value of this property should be between -1 and 1.
NeedleEndExtent	`double`	Determines the ending position of the needle , measured from the center of the gauge. The value of this property should be between -1 and 1.
NeedleStartWidthRatio	`double`	Determines the width of the needle at its point. The value of this property should be between 0 and 1.
NeedleEndWidthRatio	`double`	Determines the width of the needle at its base. The value of this property should be between 0 and 1. This has no effect unless the NeedleShape property is set to any of the following values: Rectangle RectangleWithBulb Trapezoid TrapezoidWithBulb
NeedleShape		Determines which of the predefined needle shapes to use. It can be set to: Rectangle RectangleWithBulb Triangle TriangleWithBulb Trapezoid TrapezoidWithBulb Needle NeedleWithBulb None
NeedlePivotShape		Determines the pivot shape to use for the needle. It can be set to: Circle CircleWithHole CircleOverlay CircleOverlayWithHole CircleUnderlay CircleUnderlayWithHole None
NeedleBrush	`Brush`	Determines the brush of the gauge needle.
NeedleOutline	`Brush`	Determines the brush to use for the outline needle.
NeedlePivotBrush	`Brush`	Determines the fill brush for the needle pivot shape. This pivot brush only applies to the pivot shapes that draw an overlay or an underlay. Otherwise, this setting has no effect on the pivot shape.
NeedlePivotOutline	`Brush`	Determines the brush of the outlines of the needle pivot shape. This pivot brush only applies to the pivot shapes that draw an overlay or an underlay. Otherwise, this setting has no effect on the pivot shape.

Configuring the Needle

Example

The following screenshot demonstrates how the UltraRadialGauge control with the properties of the needle looks as a result of the following setting:

Property	Value
Value	60
NeedleEndExtent	0.5
NeedleShape	Rectangle
PivotShape	CircleWithHole

Following is the code that implements this example

In C#:

var radialGauge = new UltraRadialGauge();
radialGauge.Value = 60;
radialGauge.NeedleEndExtent = 0.5;
radialGauge.NeedleShape = RadialGaugeNeedleShape.Rectangle;
radialGauge.NeedlePivotShape = RadialGaugePivotShape.CircleWithHole;

In Visual Basic:

Dim radialGauge As UltraRadialGauge = New UltraRadialGauge
radialGauge.Value = 60
radialGauge.NeedleEndExtent = 0.5
radialGauge.NeedleShape = RadialGaugeNeedleShape.Rectangle
radialGauge.NeedlePivotShape = RadialGaugePivotShape.CircleWithHole

[[Highlight Needle Example]] == Configuring the Highlight Value Needle

Highlight Example

The following screenshot demonstrates how the UltraRadialGauge control with the highlight needle enabled looks as a result of the following settings:

Property	Property Type
HighlightValue	Double
IsHighlightNeedleDraggingEnabled	Bool
HighlightValueDisplayMode	Enum

Related Content

The following topics provide additional information related to this topic:

Topic	Purpose
Adding UltraRadialGauge	This topic explains using a code example how to add the UltraRadialGauge™ control to a Windows Forms application.
Configuring the Background (UltraRadialGauge)	This topic provides a conceptual overview of the UltraRadialGauge™ control’s backing feature. It describes the properties of the backing area and provides an example of its implementation.
Configuring Labels (UltraRadialGauge)	This topic provides a conceptual overview of labels with the UltraRadialGauge™ control. It describes the properties of the labels and also provides an example of how to configure the labels.
Configuring Ranges (UltraRadialGauge)	This topic provides a conceptual overview of the UltraRadialGauge™ control’s ranges. It describes the properties of the ranges and provides an example of how to add ranges to the radial gauge.
Configuring the Scale (UltraRadialGauge)	This topic provides a conceptual overview of the UltraRadialGauge™ control’s scale. It describes the properties of the scale and also provides an example of how to implement it.
Configuring the Tick Marks (UltraRadialGauge)	This topic provides a conceptual overview of tick marks with the UltraRadialGauge™ control. It describes the tick marks’ properties and provides an example of how to implement them.

Windows Forms | Help Topics