Class GaugePointer

Base class of GaugePointer that properties for customizing gauge pointers.

Inheritance

System.Object

GaugePointer

MarkerPointer

NeedlePointer

RangePointer

Namespace: Syncfusion.UI.Xaml.Gauges

Assembly: Syncfusion.Gauge.WinUI.dll

Syntax

public abstract class GaugePointer : Control

Constructors

GaugePointer()

Declaration

protected GaugePointer()

Fields

AnimationDurationProperty

Identifies the AnimationDuration dependency property.

Declaration

public static readonly DependencyProperty AnimationDurationProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty	The identifier for AnimationDuration dependency property.

AnimationEasingFunctionProperty

Identifies the AnimationEasingFunction dependency property.

Declaration

public static readonly DependencyProperty AnimationEasingFunctionProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty	The identifier for AnimationEasingFunction dependency property.

EnableAnimationProperty

Identifies the EnableAnimation dependency property.

Declaration

public static readonly DependencyProperty EnableAnimationProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty	The identifier for EnableAnimation dependency property.

IsInteractiveProperty

Identifies the IsInteractive dependency property.

Declaration

public static readonly DependencyProperty IsInteractiveProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty	The identifier for IsInteractive dependency property.

ValueProperty

Identifies the Value dependency property.

Declaration

public static readonly DependencyProperty ValueProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty	The identifier for Value dependency property.

Properties

AnimationDuration

Gets or sets a value that specifies the pointer animation duration in milliseconds.

Declaration

public double AnimationDuration { get; set; }

Property Value

Type	Description
System.Double	The default value is `1500` milliseconds.

Remarks

It specifies how long the pointer animation will take to reach from old value to new value.

Examples

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:MarkerPointer AnimationDuration="1500" />
                <gauge:NeedlePointer AnimationDuration="1500" />
                <gauge:RangePointer AnimationDuration="1500" />
            </ gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

AnimationEasingFunction

Gets or sets easing function to apply for pointer animation when the value changes.

Declaration

public EasingFunctionBase AnimationEasingFunction { get; set; }

Property Value

Type	Description
Microsoft.UI.Xaml.Media.Animation.EasingFunctionBase	Its default value is `null`.

Remarks

A custom animation easing function can be defined as required, when any of the build-in double animation is not sufficient.

Examples

Specifies the different Microsoft.UI.Xaml.Media.Animation.EasingFunctionBase for pointer. Different type of animation provides visually appealing way when the pointer moves from one value to another. Defaults to null.

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:NeedlePointer EnableAnimation="True">
                    <gauge:NeedlePointer.AnimationEasingFunction>
                        <BackEase EasingMode="EaseIn" />
                    </gauge:NeedlePointer.AnimationEasingFunction>
                </gauge:NeedlePointer>
            </ gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

EnableAnimation

Gets or sets a value indicating whether enables or disables the pointer animation.

Declaration

public bool EnableAnimation { get; set; }

Property Value

Type	Description
System.Boolean	true if animation is enabled; otherwise, false.The default value is false.

Remarks

EnableAnimation decides whether the pointer will be animated or not while its value get changed. If EnableAnimation is true, then it will be animated, otherwise not.

Examples

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:MarkerPointer EnableAnimation="True" />
                <gauge:NeedlePointer EnableAnimation="True" />
                <gauge:RangePointer EnableAnimation="True" />
            </ gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

IsInteractive

Gets or sets a value indicating whether the control accepts changing its Value through interaction.

Declaration

public bool IsInteractive { get; set; }

Property Value

Type	Description
System.Boolean	true if pointer interaction is enabled; otherwise, false.The default value is false.

Remarks

It decides whether the gauge pointer will be interactive or not. If IsInteractive is true, the gauge pointer will be interactive, otherwise not.

Examples

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:MarkerPointer IsInteractive="True" />
                <gauge:NeedlePointer IsInteractive="True" />
                <gauge:RangePointer IsInteractive="True" />
            </ gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

Value

Gets or sets the value that specifies the value of the pointer.

Declaration

public double Value { get; set; }

Property Value

Type	Description
System.Double	The default value is `0`.

Examples

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:MarkerPointer Value="50" />
                <gauge:NeedlePointer Value="30" />
                <gauge:RangePointer Value="80" />
            </ gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

Methods

OnCreateAutomationPeer()

Declaration

protected override AutomationPeer OnCreateAutomationPeer()

Returns

Type	Description
Microsoft.UI.Xaml.Automation.Peers.AutomationPeer

OnPointerReleased(PointerRoutedEventArgs)

Called when the pointer get released.

Declaration

protected override void OnPointerReleased(PointerRoutedEventArgs e)

Parameters

Type	Name	Description
Microsoft.UI.Xaml.Input.PointerRoutedEventArgs	e	The pointer routed event arguments.

Events

ValueChangeCompleted

Called when the user is done selecting a new value of the pointer by dragging.

Declaration

public event EventHandler<ValueChangedEventArgs> ValueChangeCompleted

Event Type

Type	Description
System.EventHandler<ValueChangedEventArgs>

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:MarkerPointer ValueChangeCompleted="MarkerPointer_ValueChangeCompleted" />
            </gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

private void MarkerPointer_ValueChangeCompleted(object sender, ValueChangedEventArgs e)
{
   var value = e.Value;
}

ValueChanged

Called when the user is selecting a new value for the pointers by dragging.

Declaration

public event EventHandler<ValueChangedEventArgs> ValueChanged

Event Type

Type	Description
System.EventHandler<ValueChangedEventArgs>

Examples

XAML
C#

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:MarkerPointer ValueChanged="MarkerPointer_ValueChanged" />
            </gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

using Syncfusion.UI.Xaml.Gauges;
...
private void MarkerPointer_ValueChanged(object sender, ValueChangedEventArgs e)
{
   var value = e.Value;
}

ValueChangeStarted

Called when the user starts selecting a new value of pointer by dragging.

Declaration

public event EventHandler<ValueChangedEventArgs> ValueChangeStarted

Event Type

Type	Description
System.EventHandler<ValueChangedEventArgs>

Examples

XAML
C#

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:MarkerPointer ValueChangeStarted = "MarkerPointer_ValueChangeStarted" />
            </gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

private void MarkerPointer_ValueChangeStarted(object sender, ValueChangedEventArgs e)
{
   var value = e.Value;
}

ValueChanging

Called before when the user is selecting a new value for the pointers by dragging.

Declaration

public event EventHandler<ValueChangingEventArgs> ValueChanging

Event Type

Type	Description
System.EventHandler<ValueChangingEventArgs>

Examples

XAML
C#

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:MarkerPointer ValueChanging="MarkerPointer_ValueChanging" />
            </gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

private void MarkerPointer_ValueChanging(object sender, ValueChangingEventArgs e)
{
   var oldValue = e.OldValue;
   var newValue = e.NewValue;
   var cancel = e.Cancel;
}

WinUI- v19.3.0.43

Class GaugePointer

Inheritance

Namespace: Syncfusion.UI.Xaml.Gauges

Assembly: Syncfusion.Gauge.WinUI.dll

Syntax

Constructors

GaugePointer()

Declaration

Fields

AnimationDurationProperty

Declaration

Field Value

AnimationEasingFunctionProperty

Declaration

Field Value

EnableAnimationProperty

Declaration

Field Value

IsInteractiveProperty

Declaration

Field Value

ValueProperty

Declaration

Field Value

Properties

AnimationDuration

Declaration

Property Value

Remarks

Examples

AnimationEasingFunction

Declaration

Property Value

Remarks

Examples

EnableAnimation

Declaration

Property Value

Remarks

Examples

IsInteractive

Declaration

Property Value

Remarks

Examples

Value

Declaration

Property Value

Examples

Methods

OnCreateAutomationPeer()

Declaration

Returns

OnPointerReleased(PointerRoutedEventArgs)

Declaration

Parameters

Events

ValueChangeCompleted

Declaration

Event Type

Examples

ValueChanged

Declaration

Event Type

Examples

ValueChangeStarted

Declaration

Event Type

Examples

ValueChanging

Declaration

Event Type

Examples