WinUI

Code Examples Upgrade Guide User Guide Demos Support Forums Download
  • Code Examples
  • Upgrade Guide
  • User Guide
  • Demos
  • Support
  • Forums
  • Download
Class SfRadialGauge

    Show / Hide Table of Contents

    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
    Back to top Generated by DocFX
    Copyright © 2001 - 2023 Syncfusion Inc. All Rights Reserved