menu

WinUI

  • Code Examples
  • Upgrade Guide
  • User Guide
  • Demos
  • Support
  • Forums
  • Download
Class GaugeAxis - WinUI API Reference | Syncfusion

    Show / Hide Table of Contents

    Class GaugeAxis

    Base class of RadialAxis. It contains common logic of ranges, pointers, labels, and ticks that help to visualize the data.

    Inheritance
    System.Object
    GaugeAxis
    RadialAxis
    Namespace: Syncfusion.UI.Xaml.Gauges
    Assembly: Syncfusion.Gauge.WinUI.dll
    Syntax
    public abstract class GaugeAxis : Control

    Constructors

    GaugeAxis()

    Initializes a new instance of the GaugeAxis class.

    Declaration
    public GaugeAxis()

    Fields

    AnnotationsProperty

    Identifies the Annotations dependency property.

    Declaration
    public static readonly DependencyProperty AnnotationsProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for Annotations dependency property.

    AxisLineFillProperty

    Identifies the AxisLineFill dependency property.

    Declaration
    public static readonly DependencyProperty AxisLineFillProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for AxisLineFill dependency property.

    AxisLineWidthProperty

    Identifies the AxisLineWidth dependency property.

    Declaration
    public static readonly DependencyProperty AxisLineWidthProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for AxisLineWidth dependency property.

    AxisLineWidthUnitProperty

    Identifies the AxisLineWidthUnit dependency property.

    Declaration
    public static readonly DependencyProperty AxisLineWidthUnitProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for AxisLineWidthUnit dependency property.

    GradientStopsProperty

    Identifies the GradientStops dependency property.

    Declaration
    public static readonly DependencyProperty GradientStopsProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for GradientStops dependency property.

    IntervalProperty

    Identifies the Interval dependency property.

    Declaration
    public static readonly DependencyProperty IntervalProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for Interval dependency property.

    IsInversedProperty

    Identifies the IsInversed dependency property.

    Declaration
    public static readonly DependencyProperty IsInversedProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for IsInversed dependency property.

    LabelFormatProperty

    Identifies the LabelFormat dependency property.

    Declaration
    public static readonly DependencyProperty LabelFormatProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for LabelFormat dependency property.

    LabelPositionProperty

    Identifies the LabelPosition dependency property.

    Declaration
    public static readonly DependencyProperty LabelPositionProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for LabelPosition dependency property.

    LabelTemplateProperty

    Identifies the LabelTemplate dependency property.

    Declaration
    public static readonly DependencyProperty LabelTemplateProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for LabelTemplate dependency property.

    MajorTickLengthProperty

    Identifies the MajorTickLength dependency property.

    Declaration
    public static readonly DependencyProperty MajorTickLengthProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for MajorTickLength dependency property.

    MajorTickStyleProperty

    Identifies the MajorTickStyle dependency property.

    Declaration
    public static readonly DependencyProperty MajorTickStyleProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for MajorTickStyle dependency property.

    MaximumLabelsCountProperty

    Identifies the MaximumLabelsCount dependency property.

    Declaration
    public static readonly DependencyProperty MaximumLabelsCountProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for MaximumLabelsCount dependency property.

    MaximumProperty

    Identifies the Maximum dependency property.

    Declaration
    public static readonly DependencyProperty MaximumProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for Maximum dependency property.

    MinimumProperty

    Identifies the Minimum dependency property.

    Declaration
    public static readonly DependencyProperty MinimumProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for Minimum dependency property.

    MinorTickLengthProperty

    Identifies the MinorTickLength dependency property.

    Declaration
    public static readonly DependencyProperty MinorTickLengthProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for MinorTickLength dependency property.

    MinorTicksPerIntervalProperty

    Identifies the MinorTicksPerInterval dependency property.

    Declaration
    public static readonly DependencyProperty MinorTicksPerIntervalProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for MinorTicksPerInterval dependency property.

    MinorTickStyleProperty

    Identifies the MinorTickStyle dependency property.

    Declaration
    public static readonly DependencyProperty MinorTickStyleProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for MinorTickStyle dependency property.

    PointersProperty

    Identifies the Pointers dependency property.

    Declaration
    public static readonly DependencyProperty PointersProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for Pointers dependency property.

    RangesProperty

    Identifies the Ranges dependency property.

    Declaration
    public static readonly DependencyProperty RangesProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for Ranges dependency property.

    ShowAxisLineProperty

    Identifies the ShowAxisLine dependency property.

    Declaration
    public static readonly DependencyProperty ShowAxisLineProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for ShowAxisLine dependency property.

    ShowLabelsProperty

    Identifies the ShowLabels dependency property.

    Declaration
    public static readonly DependencyProperty ShowLabelsProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for ShowLabels dependency property.

    ShowTicksProperty

    Identifies the ShowTicks dependency property.

    Declaration
    public static readonly DependencyProperty ShowTicksProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for ShowTicks dependency property.

    TickLengthUnitProperty

    Identifies the TickLengthUnit dependency property.

    Declaration
    public static readonly DependencyProperty TickLengthUnitProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for TickLengthUnit dependency property.

    TickPositionProperty

    Identifies the TickPosition dependency property.

    Declaration
    public static readonly DependencyProperty TickPositionProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for TickPosition dependency property.

    UseRangeColorForAxisProperty

    Identifies the UseRangeColorForAxis dependency property.

    Declaration
    public static readonly DependencyProperty UseRangeColorForAxisProperty
    Field Value
    Type Description
    Microsoft.UI.Xaml.DependencyProperty

    The identifier for UseRangeColorForAxis dependency property.

    Properties

    Annotations

    Gets or sets a collection of GaugeAnnotation to the axis.

    Declaration
    public ObservableCollection<GaugeAnnotation> Annotations { get; set; }
    Property Value
    Type Description
    System.Collections.ObjectModel.ObservableCollection<GaugeAnnotation>

    The collection of GaugeAnnotation to display the specific point of interest in the radial gauge. The default value is empty collection.

    Examples

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

    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis>
                <gauge:RadialAxis.Annotations>
                    <gauge:GaugeAnnotation DirectionUnit="Angle"
                                           DirectionValue="90"
                                           PositionFactor="0.6">
                            <gauge:GaugeAnnotation.Content>
                                <Grid Background = "Pink" >
                                    <TextBlock Text="GaugeAnnotation"
                                               Foreground="Black" />
                                </Grid>
                            </gauge:GaugeAnnotation.Content>
                    </gauge:GaugeAnnotation>
                </gauge:RadialAxis.Annotations>
            </gauge:RadialAxis>
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    AxisLineFill

    Gets or sets the AxisLineFill of axis.

    Declaration
    public Brush AxisLineFill { get; set; }
    Property Value
    Type Description
    Microsoft.UI.Xaml.Media.Brush

    A Brush that specifies how the axis line is painted.

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis AxisLineFill="Gray" />
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    AxisLineWidth

    Gets or sets a value to customize the axis line width.

    Declaration
    public double AxisLineWidth { get; set; }
    Property Value
    Type Description
    System.Double

    It defines the width of the axis line. The default value is 10.

    Examples

    If AxisLineWidthUnit is Factor, value must be given from 0 to 1. Here width is calculated by AxisLineWidth * axis radius value. Example: AxisLineWidth value is 0.2 and axis outer radius is 100, thickness is 20(0.2 * 100) logical pixels.If AxisLineWidthUnit is Pixel, the defined value for axis line AxisLineWidth is set.

    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis AxisLineWidth="10" />
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    AxisLineWidthUnit

    Gets or sets the value that indicates to calculate the axis line width either in logical pixel or factor.

    Declaration
    public SizeUnit AxisLineWidthUnit { get; set; }
    Property Value
    Type Description
    SizeUnit

    One of the SizeUnit enumeration that specifies how the AxisLineWidth value is considered. The default mode is Pixel.

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis AxisLineWidthUnit="Factor" />
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    GradientStops

    Gets or sets a collection of GaugeGradientStop to fill the gradient brush to the axis line.

    Declaration
    public ObservableCollection<GaugeGradientStop> GradientStops { get; set; }
    Property Value
    Type Description
    System.Collections.ObjectModel.ObservableCollection<GaugeGradientStop>

    A collection of the GaugeGradientStop objects associated with the brush, each of which specifies a color and an offset along the axis. The default is an empty collection.

    Examples

    The below examples shows, how to add a collection of gradient stop to the radial axis.

    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis Minimum="0"
                              Maximum="100">
                <gauge:RadialAxis.GradientStops>
                    <gauge:GaugeGradientStop Value="0"
                                             Color="Green" />
                    <gauge:GaugeGradientStop Value="50"
                                             Color="Yellow" />
                    <gauge:GaugeGradientStop Value="100"
                                             Color="Red" />
                </gauge:RadialAxis.GradientStops>
            </gauge:RadialAxis>
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    Interval

    Gets or sets the interval value of the axis. Using this, the axis labels can be displayed after a certain interval value.

    Declaration
    public double Interval { get; set; }
    Property Value
    Type Description
    System.Double

    It defines the interval of the RadialAxis. The default value is double.NaN.

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis Interval="10" />
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    IsInversed

    Gets or sets a value indicating whether inverts the axis from right to left.

    Declaration
    public bool IsInversed { get; set; }
    Property Value
    Type Description
    System.Boolean

    true if axis is inversed; otherwise, false.The default value is false.

    Remarks

    IsInversed decides whether the axis will be inversed or not. If IsInversed is true, the axis will be inversed, otherwise not inversed.

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis IsInversed="True" />
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    LabelFormat

    Gets or sets a value to formats the axis labels with globalized string formats.

    Declaration
    public string LabelFormat { get; set; }
    Property Value
    Type Description
    System.String

    The string that specifies the globalized string formats for the axis labels. Its default value is string.Empty.

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis LabelFormat="c" />
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    LabelPosition

    Gets or sets the value that indicates the position of the axis labels inside or outside the axis line.

    Declaration
    public GaugeLabelsPosition LabelPosition { get; set; }
    Property Value
    Type Description
    GaugeLabelsPosition

    One of the enumeration values that specifies the position of labels in the radial gauge. The registered default is Inside.

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis LabelPosition="Outside" />
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    LabelTemplate

    Gets or sets the data template to customizes the axis label.

    Declaration
    public DataTemplate LabelTemplate { get; set; }
    Property Value
    Type Description
    Microsoft.UI.Xaml.DataTemplate

    The template for the axis labels. The default value is null.

    Remarks

    Its DataContext is AxisLabelData.

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis>
                <gauge:RadialAxis.LabelTemplate>
                    <DataTemplate>
                        <Grid Background="LightBlue"
                              BorderThickness="1"
                              BorderBrush="Red">
                            <TextBlock Text = "{Binding Text}"
                                       Foreground="Red"
                                       FontSize="30" />
                        </Grid>
                    </DataTemplate>
                </gauge:RadialAxis.LabelTemplate>
            </gauge:RadialAxis>
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    MajorTickLength

    Gets or sets the value to customize the major tick line size.

    Declaration
    public double MajorTickLength { get; set; }
    Property Value
    Type Description
    System.Double

    The length of the major tick line. The default value is 10.

    Examples

    If TickLengthUnit is Factor, value must be given from 0 to 1. Here thickness is calculated by MajorTickLength * axis radius value. Example: MajorTickLength value is 0.2 and axis radius is 100, thickness is 20(0.2 * 100) logical pixels.If TickLengthUnit is Pixel, the defined value for major tick length is set.

    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis MajorTickLength="15" />
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    MajorTickStyle

    Gets or sets the style to customizes the major tick line.

    Declaration
    public Style MajorTickStyle { get; set; }
    Property Value
    Type Description
    Microsoft.UI.Xaml.Style

    The style that is applied to major tick line in RadialAxis.

    Remarks

    To define a Microsoft.UI.Xaml.Style for major ticks, specify a TargetType of Line.

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis>
                <gauge:RadialAxis.MajorTickStyle>
                    <Style TargetType = "Line" >
                        < Setter Property="Stroke"
                                Value="#999999"></Setter>
                        <Setter Property = "StrokeThickness"
                                Value="1.5"></Setter>
                    </Style>
                </gauge:RadialAxis.MajorTickStyle>
            </gauge:RadialAxis>
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    Maximum

    Gets or sets the maximum value of the axis. The axis ends at this value.

    Declaration
    public double Maximum { get; set; }
    Property Value
    Type Description
    System.Double

    It defines the maximum value of the RadialAxis. The default value is 100.

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis Maximum="150" />
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    MaximumLabelsCount

    Gets or sets the maximum number of labels to be displayed in an axis in 100 logical pixels.

    Declaration
    public int MaximumLabelsCount { get; set; }
    Property Value
    Type Description
    System.Int32

    Maximum number of labels to be displayed in a axis in 100 logical pixels. Its default value is 3.

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis MaximumLabelsCount="3" />
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    Minimum

    Gets or sets the minimum value of the axis. The axis starts from this value.

    Declaration
    public double Minimum { get; set; }
    Property Value
    Type Description
    System.Double

    It defines the minimum values of the RadialAxis. The default value is 0.

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis Minimum="10" />
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    MinorTickLength

    Gets or sets the value to customize the minor tick line size.

    Declaration
    public double MinorTickLength { get; set; }
    Property Value
    Type Description
    System.Double

    The length of the minor tick line. The default value is 5.

    Examples

    If TickLengthUnit is Factor, value must be given from 0 to 1. Here thickness is calculated by MinorTickLength * axis radius value. Example: MinorTickLength value is 0.2 and axis radius is 100, thickness is 20(0.2 * 100) logical pixels.If TickLengthUnit is Pixel, the defined value for minor tick length is set.

    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis MinorTickLength="10" />
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    MinorTicksPerInterval

    Gets or sets the interval of the minor ticks.

    Declaration
    public double MinorTicksPerInterval { get; set; }
    Property Value
    Type Description
    System.Double

    It defines number of minor ticks will be rendered between the major ticks. The default value is 1.

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis MinorTicksPerInterval="5" />
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    MinorTickStyle

    Gets or sets the style to customizes the minor tick line.

    Declaration
    public Style MinorTickStyle { get; set; }
    Property Value
    Type Description
    Microsoft.UI.Xaml.Style

    The style that is applied to minor tick line in RadialAxis.

    Remarks

    To define a Microsoft.UI.Xaml.Style for minor ticks, specify a TargetType of Line.

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis>
                <gauge:RadialAxis.MinorTickStyle>
                    <Style TargetType = "Line" >
                        < Setter Property="Stroke"
                                Value="#999999"></Setter>
                        <Setter Property = "StrokeThickness"
                                Value="1"></Setter>
                    </Style>
                </gauge:RadialAxis.MinorTickStyle>
            </gauge:RadialAxis>
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    Pointers

    Gets or sets a collection of GaugePointer to the axis.

    Declaration
    public ObservableCollection<GaugePointer> Pointers { get; set; }
    Property Value
    Type Description
    System.Collections.ObjectModel.ObservableCollection<GaugePointer>

    The collection of linear range to display the current value of the axis. The default value is empty collection.

    Examples

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

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

    Ranges

    Gets or sets a collection of GaugeRange to the axis.

    Declaration
    public ObservableCollection<GaugeRange> Ranges { get; set; }
    Property Value
    Type Description
    System.Collections.ObjectModel.ObservableCollection<GaugeRange>

    The collection of linear range to display the current value of the axis. The default value is empty collection.

    Examples

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

    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis>
                <gauge:RadialAxis.Ranges>
                    <gauge:GaugeRange StartValue="0" EndValue="35" Background="Green" />
                    <gauge:GaugeRange StartValue="35" EndValue="70" Background="Orange" />
                    <gauge:GaugeRange StartValue="70" EndValue="100" Background="Red" />
                </gauge:RadialAxis.Ranges>
            </gauge:RadialAxis>
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    ShowAxisLine

    Gets or sets a value indicating whether to shows or hides the axis line.

    Declaration
    public bool ShowAxisLine { get; set; }
    Property Value
    Type Description
    System.Boolean

    true if axis line is displayed; otherwise, false.The default value is true.

    Remarks

    It decides whether the axis line will be rendered or not. If ShowAxisLine is true, the axis line will be rendered, otherwise not rendered.

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis ShowAxisLine="False" />
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    ShowLabels

    Gets or sets a value indicating whether to shows or hides the axis labels.

    Declaration
    public bool ShowLabels { get; set; }
    Property Value
    Type Description
    System.Boolean

    true if axis labels are displayed; otherwise, false.The default value is true.

    Remarks

    It decides whether the axis labels will be rendered or not. If ShowLabels is true, the axis labels will be rendered, otherwise not rendered.

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis ShowLabels="False" />
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    ShowTicks

    Gets or sets a value indicating whether to shows or hides the axis tick lines.

    Declaration
    public bool ShowTicks { get; set; }
    Property Value
    Type Description
    System.Boolean

    true if axis line ticks are displayed; otherwise, false.The default value is true.

    Remarks

    It decides whether the axis ticks will be rendered or not. If ShowTicks is true, the axis ticks will be rendered, otherwise not rendered.

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis ShowTicks="False" />
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    TickLengthUnit

    Gets or sets the value that indicates to calculate the tick length either in logical pixel or factor.

    Declaration
    public SizeUnit TickLengthUnit { get; set; }
    Property Value
    Type Description
    SizeUnit

    One of the SizeUnit enumeration that specifies how the MajorTickLength and MinorTickLength values are considered. The default mode is Pixel.

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis TickLengthUnit="Factor" />
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    TickPosition

    Gets or sets the value that indicates the position of the ticks inside, center, or outside the axis line.

    Declaration
    public GaugeElementPosition TickPosition { get; set; }
    Property Value
    Type Description
    GaugeElementPosition

    One of the enumeration values that specifies the position of ticks in the radial gauge. The default is Inside.

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis TickPosition="Outside" />
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    UseRangeColorForAxis

    Gets or sets a value indicating whether to use the range color for axis elements such as labels and ticks.

    Declaration
    public bool UseRangeColorForAxis { get; set; }
    Property Value
    Type Description
    System.Boolean

    true if use range color is enabled; otherwise, false.The default value is false.

    Remarks

    It decides whether the corresponding range color will be applied to the axis elements like labels and ticks or not. If UseRangeColorForAxis is true, the corresponding range colors will be applied, otherwise not.

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis UseRangeColorForAxis="True" />
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    Events

    LabelPrepared

    Called when an axis label is created

    Declaration
    public event EventHandler<LabelPreparedEventArgs> LabelPrepared
    Event Type
    Type
    System.EventHandler<LabelPreparedEventArgs>
    Examples
    • XAML
    • C#
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis LabelPrepared="RadialAxis_LabelPrepared" />
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>
    private void RadialAxis_LabelPrepared(object sender, LabelPreparedEventArgs e)
    {
        e.LabelText += "%";
    }
    Back to top Generated by DocFX
    Copyright © 2001 - 2025 Syncfusion Inc. All Rights Reserved