menu

MAUI

  • User Guide
  • Demos
  • Support
  • Forums
  • Download
Class RangePointer - MAUI API Reference | Syncfusion

    Show / Hide Table of Contents

    Class RangePointer

    Create the pointer to indicate the value with rounded range bar arc. A RangePointer is used to indicate the current value relative to the start value of a axis scale.

    Inheritance
    System.Object
    RadialPointer
    RangePointer
    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 RangePointer : RadialPointer, IThemeElement
    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis>
                <gauge:RadialAxis.Pointers>
                    <gauge:RangePointer Value="50" />
                </gauge:RadialAxis.Pointers>
            </gauge:RadialAxis>
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    Constructors

    RangePointer()

    Initializes a new instance of the RangePointer class.

    Declaration
    public RangePointer()
    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis>
                <gauge:RadialAxis.Pointers>
                    <gauge:RangePointer Value="50" />
                </gauge:RadialAxis.Pointers>
            </gauge:RadialAxis>
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    Fields

    CornerStyleProperty

    Identifies the CornerStyle bindable property.

    Declaration
    public static readonly BindableProperty CornerStyleProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for CornerStyle bindable property.

    FillProperty

    Identifies the Fill bindable property.

    Declaration
    public static readonly BindableProperty FillProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for Fill bindable property.

    GradientStopsProperty

    Identifies the GradientStops bindable property.

    Declaration
    public static readonly BindableProperty GradientStopsProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for GradientStops bindable property.

    OffsetUnitProperty

    Identifies the OffsetUnit bindable property.

    Declaration
    public static readonly BindableProperty OffsetUnitProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for OffsetUnit bindable property.

    PointerOffsetProperty

    Identifies the PointerOffset bindable property.

    Declaration
    public static readonly BindableProperty PointerOffsetProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for PointerOffset bindable property.

    PointerWidthProperty

    Identifies the PointerWidth bindable property.

    Declaration
    public static readonly BindableProperty PointerWidthProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for PointerWidth bindable property.

    WidthUnitProperty

    Identifies the WidthUnit bindable property.

    Declaration
    public static readonly BindableProperty WidthUnitProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for WidthUnit bindable property.

    Properties

    CornerStyle

    Gets or sets the value that specifies the corner style of range pointer.

    Declaration
    public CornerStyle CornerStyle { get; set; }
    Property Value
    Type Description
    CornerStyle

    One of the enumeration values that specifies the corner style of range pointer in the radial gauge. The default is BothFlat.

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis>
                <gauge:RadialAxis.Pointers>
                    <gauge:RangePointer Value="50" 
                                        PointerWidth="0.2"
                                        WidthUnit="Factor"
                                        PointerOffset="0.2"
                                        OffsetUnit="Factor"
                                        CornerStyle="BothCurve" />
                </gauge:RadialAxis.Pointers>
            </gauge:RadialAxis>
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    Fill

    Gets or sets the Color that paints the interior area of the range.

    Declaration
    public Brush Fill { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Controls.Brush

    A Color that specifies how the range path is painted.

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis>
                <gauge:RadialAxis.Pointers>
                    <gauge:RangePointer Value="50"
                                        Fill="Red" />
                </gauge:RadialAxis.Pointers>
            </gauge:RadialAxis>
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    GradientStops

    Gets or sets a collection of GaugeGradientStop to fill the gradient brush to the range pointer.

    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 range pointer.

    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis>
                <gauge:RadialAxis.Pointers>
                    <gauge:RangePointer Value="80"
                                        PointerWidth="0.2"
                                        WidthUnit="Factor"
                                        PointerOffset="0.2"
                                        OffsetUnit="Factor">
                        <gauge:RangePointer.GradientStops>
                            <gauge:GaugeGradientStop Value="0"
                                                     Color="Green" />
                            <gauge:GaugeGradientStop Value="50"
                                                     Color="Yellow" />
                            <gauge:GaugeGradientStop Value="80"
                                                     Color="Red" />
                        </gauge:RangePointer.GradientStops>
                    </gauge:RangePointer>
                </gauge:RadialAxis.Pointers>
            </gauge:RadialAxis>
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    OffsetUnit

    Gets or sets the value that indicates the to calculate the range pointer offset either in logical pixel or factor.

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

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

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis>
                <gauge:RadialAxis.Pointers>
                    <gauge:RangePointer Value="50" 
                                        PointerWidth="0.2"
                                        WidthUnit="Factor"
                                        PointerOffset="0.2"
                                        OffsetUnit="Factor" />
                </gauge:RadialAxis.Pointers>
            </gauge:RadialAxis>
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    PointerOffset

    Gets or sets the value that specifies the position value for pointer. You can specify value either in logical pixel or radius factor using the OffsetUnit property.

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

    It defines the position offset of the pointer either pixel or factor. The default value is double.NaN.

    Examples

    If OffsetUnit is Factor, value will be given from 0 to 1. Here pointer placing position is calculated by PointerOffset * axis radius value. Example: PointerOffset value is 0.2 and axis radius is 100, pointer is moving 20(0.2 * 100) logical pixels from axis outer radius. If OffsetUnit is Pixel, defined value distance pointer will move from the outer radius axis. When you specify PointerOffset is negative, the pointer will be positioned outside the axis.

    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis>
                <gauge:RadialAxis.Pointers>
                    <gauge:RangePointer Value="50" 
                                        PointerWidth="0.2"
                                        WidthUnit="Factor"
                                        PointerOffset="0.2" />
                </gauge:RadialAxis.Pointers>
            </gauge:RadialAxis>
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    PointerWidth

    Gets or sets the value that specifies the pointer width. You can specify value either in logical pixel or radius factor using the WidthUnit property.

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

    It defines the width of the pointer. The default value is 10.

    Examples

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

    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis>
                <gauge:RadialAxis.Pointers>
                    <gauge:RangePointer Value="50" 
                                        PointerWidth="0.2" />
                </gauge:RadialAxis.Pointers>
            </gauge:RadialAxis>
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    WidthUnit

    Gets or sets the value that indicates to calculate the range pointer width either in logical pixel or radius factor.

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

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

    Examples
    <gauge:SfRadialGauge>
        <gauge:SfRadialGauge.Axes>
            <gauge:RadialAxis>
                <gauge:RadialAxis.Pointers>
                    <gauge:RangePointer Value="50" 
                                        PointerWidth="0.2"
                                        WidthUnit="Factor" />
                </gauge:RadialAxis.Pointers>
            </gauge:RadialAxis>
        </gauge:SfRadialGauge.Axes>
    </gauge:SfRadialGauge>

    Methods

    OnBindingContextChanged()

    Called when binding context changed.

    Declaration
    protected override void OnBindingContextChanged()
    Back to top Generated by DocFX
    Copyright © 2001 - 2025 Syncfusion Inc. All Rights Reserved