Class SfRadialGauge

Represents a radial gauge control that is used to displays numerical values on a circular scale. It has a rich set of features such as axes, ranges, pointers, and annotations that are fully customizable and extendable. Use it to create speedometers, temperature monitors, dashboards, meter gauges, multi axis clocks, watches, activity gauges, compasses, and more.

Inheritance

System.Object

SfRadialGauge

Implements

System.IDisposable

Namespace: Syncfusion.UI.Xaml.Gauges

Assembly: Syncfusion.Gauge.WinUI.dll

Syntax

public class SfRadialGauge : Control, IDisposable

Examples

The below examples shows, how to initialize the radial gauge.

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:NeedlePointer Value="60"/>
            </ gauge:RadialAxis.Pointers>
            <gauge:RadialAxis.Ranges>
                <gauge:GaugeRange StartValue="0" EndValue="100">
                    <gauge:GaugeRange.GradientStops>
                        <gauge:GaugeGradientStop Value="0" Color="Green" />
                        <gauge:GaugeGradientStop Value="50" Color="Orange" />
                        <gauge:GaugeGradientStop Value="100" Color="Red" />
                    </gauge:GaugeRange.GradientStops>
                </gauge:GaugeRange>
            </gauge:RadialAxis.Ranges>
            <gauge:RadialAxis.Annotations>
                <gauge:GaugeAnnotation DirectionUnit="Angle" DirectionValue="90" PositionFactor="0.7" >
                    <gauge:GaugeAnnotation.Content>
                        <TextBlock Text="{Binding ElementName=pointer,Path=Value}" />
                    </ gauge:GaugeAnnotation.Content>
                </gauge:GaugeAnnotation>
            </gauge:RadialAxis.Annotations>
        </gauge:RadialAxis>
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

Constructors

SfRadialGauge()

Initializes a new instance of the SfRadialGauge class.

Declaration

public SfRadialGauge()

Examples

The below examples shows, how to creates a radial gauge with required axis.

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis />
    </gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

Fields

AxesProperty

Identifies the Axes dependency property.

Declaration

public static readonly DependencyProperty AxesProperty

Field Value

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

CanScaleToFitProperty

Identifies the CanScaleToFit dependency property.

Declaration

public static readonly DependencyProperty CanScaleToFitProperty

Field Value

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

Properties

Axes

Gets or sets a collection of RadialAxis.

Declaration

public ObservableCollection<RadialAxis> Axes { get; set; }

Property Value

Type	Description
System.Collections.ObjectModel.ObservableCollection<RadialAxis>	The collection of axes to display multiple axis. The default value is empty collection.

Examples

The below examples shows, how to add a collection of radial axis to the gauge and customize each axis by adding it to the axes collection.

<gauge:SfRadialGauge>
    <gauge:SfRadialGauge.Axes>
        <gauge:RadialAxis>
            <gauge:RadialAxis.Pointers>
                <gauge:NeedlePointer Value = "60" />
            </ gauge:RadialAxis.Pointers>
        </gauge:RadialAxis>
        <gauge:RadialAxis RadiusFactor = "0.5" />
    </ gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>

CanScaleToFit

Gets or sets a value indicating whether to adjust the half or quarter gauge to fit the axis boundary. If CanScaleToFit true, the center and radius position of the axis will be modified on the basis of the angle value.

Declaration

public bool CanScaleToFit { get; set; }

Property Value

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

Examples

The below examples shows, how to set CanScaleToFit property.

<gauge:SfRadialGauge CanScaleToFit="True" />

Methods

Dispose()

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resource in SfRadialGauge.

Declaration

public void Dispose()

Dispose(Boolean)

Disposing linear gauge objects.

Declaration

protected virtual void Dispose(bool disposing)

Parameters

Type	Name	Description
System.Boolean	disposing	Used to indicate perform dispose or not.

MeasureOverride(Size)

Measures the size in layout required for child elements.

Declaration

protected override Size MeasureOverride(Size availableSize)

Parameters

Type	Name	Description
Windows.Foundation.Size	availableSize	This size give to child elements.

Returns

Type	Description
Windows.Foundation.Size	Return child element size.

OnCreateAutomationPeer()

Declaration

protected override AutomationPeer OnCreateAutomationPeer()

Returns

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

OnPointerMoved(PointerRoutedEventArgs)

Called when the pointer get moved.

Declaration

protected override void OnPointerMoved(PointerRoutedEventArgs e)

Parameters

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

OnPointerPressed(PointerRoutedEventArgs)

Called when the pointer get pressed.

Declaration

protected override void OnPointerPressed(PointerRoutedEventArgs e)

Parameters

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

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.

OnTapped(TappedRoutedEventArgs)

Called when the gauge is tapped.

Declaration

protected override void OnTapped(TappedRoutedEventArgs e)

Parameters

Type	Name	Description
Microsoft.UI.Xaml.Input.TappedRoutedEventArgs	e	The tapped routed event arguments.

Implements

System.IDisposable