Class NeedlePointer

Create the pointer to indicate the value with needle or arrow shape. NeedlePointer contains three parts, namely needle, knob, and tail and that can be placed on a gauge to mark the values.

Inheritance

System.Object

RadialPointer

NeedlePointer

Inherited Members

RadialPointer.AnimationDuration

RadialPointer.AnimationDurationProperty

RadialPointer.AnimationEasing

RadialPointer.AnimationEasingProperty

RadialPointer.EnableAnimation

RadialPointer.EnableAnimationProperty

RadialPointer.IsInteractive

RadialPointer.IsInteractiveProperty

RadialPointer.StepFrequency

RadialPointer.StepFrequencyProperty

RadialPointer.Value

RadialPointer.ValueChangeCompleted

RadialPointer.ValueChanged

RadialPointer.ValueChangeStarted

RadialPointer.ValueChanging

RadialPointer.ValueProperty

Namespace: Syncfusion.Maui.Gauges

Assembly: Syncfusion.Maui.Gauges.dll

Syntax

public class NeedlePointer : RadialPointer, IThemeElement

Examples

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:NeedlePointer Value="50" />
            </gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

Constructors

NeedlePointer()

Initializes a new instance of the NeedlePointer class.

Declaration

public NeedlePointer()

Fields

KnobFillProperty

Identifies the KnobFill bindable property.

Declaration

public static readonly BindableProperty KnobFillProperty

Field Value

Type	Description
Microsoft.Maui.Controls.BindableProperty	The identifier for KnobFill bindable property.

KnobRadiusProperty

Identifies the KnobRadius bindable property.

Declaration

public static readonly BindableProperty KnobRadiusProperty

Field Value

Type	Description
Microsoft.Maui.Controls.BindableProperty	The identifier for KnobRadius bindable property.

KnobSizeUnitProperty

Identifies the KnobSizeUnit bindable property.

Declaration

public static readonly BindableProperty KnobSizeUnitProperty

Field Value

Type	Description
Microsoft.Maui.Controls.BindableProperty	The identifier for KnobSizeUnit bindable property.

KnobStrokeProperty

Identifies the KnobStroke bindable property.

Declaration

public static readonly BindableProperty KnobStrokeProperty

Field Value

Type	Description
Microsoft.Maui.Controls.BindableProperty	The identifier for KnobStroke bindable property.

KnobStrokeThicknessProperty

Identifies the KnobStrokeThickness bindable property.

Declaration

public static readonly BindableProperty KnobStrokeThicknessProperty

Field Value

Type	Description
Microsoft.Maui.Controls.BindableProperty	The identifier for KnobStrokeThickness bindable property.

NeedleEndWidthProperty

Identifies the NeedleEndWidth bindable property.

Declaration

public static readonly BindableProperty NeedleEndWidthProperty

Field Value

Type	Description
Microsoft.Maui.Controls.BindableProperty	The identifier for NeedleEndWidth bindable property.

NeedleFillProperty

Identifies the NeedleFill bindable property.

Declaration

public static readonly BindableProperty NeedleFillProperty

Field Value

Type	Description
Microsoft.Maui.Controls.BindableProperty	The identifier for NeedleFill bindable property.

NeedleLengthProperty

Identifies the NeedleLength bindable property.

Declaration

public static readonly BindableProperty NeedleLengthProperty

Field Value

Type	Description
Microsoft.Maui.Controls.BindableProperty	The identifier for NeedleLength bindable property.

NeedleLengthUnitProperty

Identifies the NeedleLengthUnit bindable property.

Declaration

public static readonly BindableProperty NeedleLengthUnitProperty

Field Value

Type	Description
Microsoft.Maui.Controls.BindableProperty	The identifier for NeedleLengthUnit bindable property.

NeedleStartWidthProperty

Identifies the NeedleStartWidth bindable property.

Declaration

public static readonly BindableProperty NeedleStartWidthProperty

Field Value

Type	Description
Microsoft.Maui.Controls.BindableProperty	The identifier for NeedleStartWidth bindable property.

TailFillProperty

Identifies the TailFill bindable property.

Declaration

public static readonly BindableProperty TailFillProperty

Field Value

Type	Description
Microsoft.Maui.Controls.BindableProperty	The identifier for TailFill bindable property.

TailLengthProperty

Identifies the TailLength bindable property.

Declaration

public static readonly BindableProperty TailLengthProperty

Field Value

Type	Description
Microsoft.Maui.Controls.BindableProperty	The identifier for TailLength bindable property.

TailLengthUnitProperty

Identifies the TailLengthUnit bindable property.

Declaration

public static readonly BindableProperty TailLengthUnitProperty

Field Value

Type	Description
Microsoft.Maui.Controls.BindableProperty	The identifier for TailLengthUnit bindable property.

TailWidthProperty

Identifies the TailWidth bindable property.

Declaration

public static readonly BindableProperty TailWidthProperty

Field Value

Type	Description
Microsoft.Maui.Controls.BindableProperty	The identifier for TailWidth bindable property.

Properties

KnobFill

Gets or sets the Brush that paints the interior area of the knob.

Declaration

public Brush KnobFill { get; set; }

Property Value

Type	Description
Microsoft.Maui.Controls.Brush	A Brush that specifies how the knob is painted.

Examples

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:NeedlePointer Value="50"
                                     KnobRadius="0.02"
                                     KnobFill="Red" />
            </gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

KnobRadius

Gets or sets a value that specifies the knob radius size.

Declaration

public double KnobRadius { get; set; }

Property Value

Type	Description
System.Double	It defines the radius of the knob either in pixel or factor. The default value is 0.07d.

Examples

If KnobSizeUnit is Factor, value will be given from 0 to 1. Here knob radius size is calculated by KnobRadius * axis radius value. Example: KnobRadius value is 0.2 and axis radius is 100, knob radius is 20(0.2 * 100) logical pixels. if KnobSizeUnit is Pixel, defined value is set to the knob radius.

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:NeedlePointer Value="50"
                                     KnobRadius="0.08" />
            </gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

KnobSizeUnit

Gets or sets the value that indicates to calculate the knob radius in logical pixel or radius factor.

Declaration

public SizeUnit KnobSizeUnit { get; set; }

Property Value

Type	Description
SizeUnit	One of the SizeUnit enumeration that specifies how the KnobRadius value is considered. The default mode is Factor.

Examples

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:NeedlePointer Value="50"
                                     KnobRadius="0.02"
                                     KnobFill="Red"
                                     KnobStrokeThickness="2"
                                     KnobStroke="Blue"
                                     KnobSizeUnit="Factor" />
            </gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

KnobStroke

Gets or sets a value that specifies the knob border color.

Declaration

public Color KnobStroke { get; set; }

Property Value

Type	Description
Microsoft.Maui.Graphics.Color	A Color that specifies how the knob border is painted.

Examples

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:NeedlePointer Value="50"
                                     KnobRadius="0.02"
                                     KnobFill="Red"
                                     KnobStrokeThickness="2"
                                     KnobStroke="Blue" />
            </gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

KnobStrokeThickness

Gets or sets the width of the knob stroke outline.

Declaration

public double KnobStrokeThickness { get; set; }

Property Value

Type	Description
System.Double	It defines the thickness of the knob stroke. The default value is 0.

Examples

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:NeedlePointer Value="50"
                                     KnobRadius="0.02"
                                     KnobStrokeThickness="2" />
            </gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

NeedleEndWidth

Gets or sets a value that specifies the end width of the needle pointer.

Declaration

public double NeedleEndWidth { get; set; }

Property Value

Type	Description
System.Double	It defines the width of the needle end. The default value is 8.

Examples

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:NeedlePointer Value="50"
                                     NeedleLength="0.7"
                                     NeedleLengthUnit="Factor"
                                     NeedleStartWidth="10"
                                     NeedleEndWidth="10" />
            </gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

NeedleFill

Gets or sets the Brush that paints the interior area of the needle shape.

Declaration

public Brush NeedleFill { get; set; }

Property Value

Type	Description
Microsoft.Maui.Controls.Brush	A Brush that specifies how the needle is painted.

Examples

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:NeedlePointer Value="50"
                                     NeedleLength="0.7"
                                     NeedleLengthUnit="Factor"
                                     NeedleStartWidth="10"
                                     NeedleEndWidth="10"
                                     NeedleFill="Red" />
            </gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

NeedleLength

Gets or sets a value that specifies the length of the needle pointer. You can specify value either in logical pixel or radius factor using the NeedleLengthUnit property.

Declaration

public double NeedleLength { get; set; }

Property Value

Type	Description
System.Double	It defines the length of the needle either in pixel or factor. The default value is 0.75.

Examples

If NeedleLengthUnit is Factor, value will be given from 0 to 1. Here needle length is calculated by NeedleLength * axis radius value. Example: NeedleLength value is 0.2 and axis radius is 100, needle length is 20(0.2 * 100) logical pixels. if NeedleLengthUnit is Pixel, defined value is set to the needle length.

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:NeedlePointer Value="50"
                                     NeedleLength="0.7" />
            </gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

NeedleLengthUnit

Gets or sets a value that specifies to calculate the needle pointer length either in logical pixel or radius factor.

Declaration

public SizeUnit NeedleLengthUnit { get; set; }

Property Value

Type	Description
SizeUnit	One of the SizeUnit enumeration that specifies how the NeedleLength value is considered. The default mode is Factor.

Examples

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:NeedlePointer Value="50"
                                     NeedleLength="0.7"
                                     NeedleLengthUnit="Factor" />
            </gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

NeedleStartWidth

Gets or sets a value that specifies the start width of the needle pointer.

Declaration

public double NeedleStartWidth { get; set; }

Property Value

Type	Description
System.Double	It defines the width of the needle start. The default value is 2.

Examples

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:NeedlePointer Value="50"
                                     NeedleLength="0.7"
                                     NeedleLengthUnit="Factor"
                                     NeedleStartWidth="10" />
            </gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

TailFill

Gets or sets the Brush that paints the interior area of the tail shape.

Declaration

public Brush TailFill { get; set; }

Property Value

Type	Description
Microsoft.Maui.Controls.Brush	A Brush that specifies how the tail is painted.

Examples

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:NeedlePointer Value="50"
                                     TailLength="0.1"
                                     TailFill="Red" />
            </gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

TailLength

Gets or sets a value that specifies the needle pointer tail length. You can specify value either in logical pixel or radius factor using the TailLengthUnit property.

Declaration

public double TailLength { get; set; }

Property Value

Type	Description
System.Double	It defines the tail length. The default value is 0.

Examples

If TailLengthUnit is Factor, value will be given from 0 to 1. Here tail length is calculated by TailLength * axis radius value. Example: TailLength value is 0.2 and axis radius is 100, tail length is 20(0.2 * 100) logical pixels. if TailLengthUnit is Pixel, defined value is set to the tail length.

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:NeedlePointer Value="50"
                                     TailLength="0.2" />
            </gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

TailLengthUnit

Gets or sets a value that specifies to calculate the needle pointer tail length either in logical pixel or radius factor.

Declaration

public SizeUnit TailLengthUnit { get; set; }

Property Value

Type	Description
SizeUnit	One of the SizeUnit enumeration that specifies how the TailWidth value is considered. The default mode is Factor.

Examples

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:NeedlePointer Value="50"
                                     TailLength="0.1"
                                     TailFill="Red"
                                     TailLengthUnit="Factor" />
            </gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

TailWidth

Gets or sets a value that specifies the start width of the needle pointer's tail.

Declaration

public double TailWidth { get; set; }

Property Value

Type	Description
System.Double	It defines the width of the tail. The default value is 8.

Examples

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:NeedlePointer Value="50"
                                     TailLength="0.1"
                                     TailFill="Red"
                                     TailLengthUnit="Factor"
                                     TailWidth="20" />
            </gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>