menu

WPF

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

    Show / Hide Table of Contents

    Class CircularRange

    CircularRange is a class that denotes various qualitative ranges for a circular scale. Create an instance of CircularRange, and set required properties.

    Inheritance
    System.Object
    CircularRange
    Namespace: Syncfusion.UI.Xaml.Gauges
    Assembly: Syncfusion.SfGauge.WPF.dll
    Syntax
    public class CircularRange : Control

    Constructors

    CircularRange()

    Initializes a new instance of the CircularRange class.

    Declaration
    public CircularRange()

    Fields

    EndAngleProperty

    Declaration
    public static readonly DependencyProperty EndAngleProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    EndPointProperty

    Declaration
    public static readonly DependencyProperty EndPointProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    EndValueProperty

    Declaration
    public static readonly DependencyProperty EndValueProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    EndWidthProperty

    Declaration
    public static readonly DependencyProperty EndWidthProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    GradientStopsProperty

    Declaration
    public static readonly DependencyProperty GradientStopsProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    InnerEndOffsetProperty

    Declaration
    public static readonly DependencyProperty InnerEndOffsetProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    InnerStartOffsetProperty

    Declaration
    public static readonly DependencyProperty InnerStartOffsetProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    IsLogarithmicProperty

    Declaration
    public static readonly DependencyProperty IsLogarithmicProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    OffsetProperty

    Declaration
    public static readonly DependencyProperty OffsetProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    OuterEndOffsetProperty

    Declaration
    public static readonly DependencyProperty OuterEndOffsetProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    OuterStartOffsetProperty

    Declaration
    public static readonly DependencyProperty OuterStartOffsetProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    RangeSegProperty

    Declaration
    public static readonly DependencyProperty RangeSegProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    SizeProperty

    Declaration
    public static readonly DependencyProperty SizeProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    StartPointProperty

    Declaration
    public static readonly DependencyProperty StartPointProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    StartValueProperty

    Declaration
    public static readonly DependencyProperty StartValueProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    StartWidthProperty

    Declaration
    public static readonly DependencyProperty StartWidthProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    StrokeProperty

    Declaration
    public static readonly DependencyProperty StrokeProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    StrokeThicknessProperty

    Declaration
    public static readonly DependencyProperty StrokeThicknessProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    Properties

    EndAngle

    Gets value of the CircularRange's EndAngle.

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

    double

    Remarks

    EndAngle is a read only property used to get the value of the range's EndAngle.

    EndPoint

    Gets pointvalue of the CircularRange's EndPoint.

    Declaration
    public Point EndPoint { get; }
    Property Value
    Type Description
    System.Windows.Point

    Point

    Remarks

    EndPoint is a read only property used to get the value of the EndPoint.

    EndValue

    Gets or sets the Value of the CircularRange's EndValue.

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

    double

    Remarks

    A range is a visual element which begins and ends at specified values within a scale. These start and end values are set by the StartValue and EndValue properties of Range

    Examples
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    using Common;
    using Syncfusion.UI.Xaml.Gauges;
    
    namespace GaugeWinRTSamples
    {
        public sealed partial class GaugePosition :SampleView
        {
            public GaugePosition()
            {
               InitializeComponent();
               SfCircularGauge gauge = new SfCircularGauge();
               CircularRange range1 = new CircularRange();
               range1.StartValue = 0;
               range1.EndValue = 40;
               range1.Stroke = new SolidColorBrush(Colors.Green);
               range1.StrokeThickness = 10;            
               gauge.MainScale.Ranges.Add(range1);            
            }
        }
    }

    EndWidth

    Gets or sets the End Width of the CircularRange.

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

    double

    Examples
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    using Common;
    using Syncfusion.UI.Xaml.Gauges;
    
    namespace GaugeWinRTSamples
    {
        public sealed partial class GaugePosition :SampleView
        {
            public GaugePosition()
            {
               InitializeComponent();
               SfCircularGauge gauge = new SfCircularGauge();
               CircularRange range1 = new CircularRange();
               range1.StartValue = 0;
               range1.EndValue = 40;
               range1.Stroke = new SolidColorBrush(Colors.Green);
               range1.EndWidth = 10;            
               gauge.MainScale.Ranges.Add(range1);            
            }
        }
    }

    GradientStops

    Get or set the collection of gradientstop to the circular ranges.

    Declaration
    public GaugeGradientStopCollection GradientStops { get; set; }
    Property Value
    Type Description
    GaugeGradientStopCollection

    GaugeGradientStopCollection

    Examples
    using Syncfusion.UI.Xaml.Gauges;
    using System;
    using System.Collections.Generi c;
    using System.Collections.ObjectModel;
    using System.Linq;
    using System.Text;
    using System.Threading.Tasks;
    using System.Windows;
    using System.Windows.Controls;
    using System.Windows.Data;
    using System.Windows.Documents;
    using System.Windows.Input;
    using System.Windows.Media;
    using System.Windows.Media.Imaging;
    using System.Windows.Navigation;
    using System.Windows.Shapes;
    namespace GaugeWinRTSamples
    {
       public sealed partial class GaugePosition :SampleView
       {
           public GaugePosition()
           {
               InitializeComponent();
               SfCircularGauge gauge = new SfCircularGauge();
               CircularRange range1 = new CircularRange();
               range1.StartValue = 0;
               range1.EndValue = 40;
               GaugeGradientStop gaugeGradientStop = new GaugeGradientStop();
               gaugeGradientStop.Color = Colors.Red;
               gaugeGradientStop.Value = 25;
               range1.GradientStops.Add(gaugeGradientStop);
               GaugeGradientStop gaugeGradientStop1 = new GaugeGradientStop();
               gaugeGradientStop1.Color = Colors.GreenYellow;
               gaugeGradientStop1.Value = 30;
               range1.GradientStops.Add(gaugeGradientStop1);
           }
       }           

    InnerEndOffset

    Gets or sets the inner end offset position of the range. Its range is from 0 to 1. Set RangePosition as custom to enable offset behavior.

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

    InnerStartOffset

    Gets or sets the inner start offset position of the range. Its range is from 0 to 1. Set RangePosition as custom to enable offset behavior.

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

    IsLogarithmic

    Gets or sets a value indicating whether the label values should be logarithm

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

    bool

    Offset

    Gets or sets Offset value. It is used to customize the position of the ranges.

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

    OuterEndOffset

    Gets or sets the outer end offset position of the range. Its range is from 0 to 1. Set RangePosition as custom to enable offset behavior.

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

    OuterStartOffset

    Gets or sets the outer start offset position of the range. Its range is from 0 to 1. Set RangePosition as custom to enable offset behavior.

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

    RangeSeg

    Declaration
    public PathSegmentCollection RangeSeg { get; set; }
    Property Value
    Type
    System.Windows.Media.PathSegmentCollection

    Size

    Gets Size of the CircularRange which helps to position the CircularRange.

    Declaration
    public Size Size { get; }
    Property Value
    Type Description
    System.Windows.Size

    Size

    Remarks

    Size is a read only property used to get the value of the Size.

    StartPoint

    Gets Pointvalue of the CircularRange's StartPoint.

    Declaration
    public Point StartPoint { get; }
    Property Value
    Type Description
    System.Windows.Point

    Point

    Remarks

    StartPoint is a read only property used to get the value of the StartPoint.

    StartValue

    Gets or sets the Value of the CircularRange's StartValue.

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

    double

    Remarks

    A range is a visual element which begins and ends at specified values within a scale. These start and end values are set by the StartValue and EndValue properties of Range

    Examples
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    using Common;
    using Syncfusion.UI.Xaml.Gauges;
    
    namespace GaugeWinRTSamples
    {
        public sealed partial class GaugePosition :SampleView
        {
            public GaugePosition()
            {
               InitializeComponent();
               SfCircularGauge gauge = new SfCircularGauge();
               CircularRange range1 = new CircularRange();
               range1.StartValue = 0;
               range1.EndValue = 40;
               range1.Stroke = new SolidColorBrush(Colors.Green);
               range1.StrokeThickness = 10;            
               gauge.MainScale.Ranges.Add(range1);            
            }
        }
    }

    StartWidth

    Gets or sets the Start Width of the CircularRange.

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

    double

    Examples
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    using Common;
    using Syncfusion.UI.Xaml.Gauges;
    
    namespace GaugeWinRTSamples
    {
        public sealed partial class GaugePosition :SampleView
        {
            public GaugePosition()
            {
               InitializeComponent();
               SfCircularGauge gauge = new SfCircularGauge();
               CircularRange range1 = new CircularRange();
               range1.StartValue = 0;
               range1.EndValue = 40;
               range1.Stroke = new SolidColorBrush(Colors.Green);
               range1.StartWidth = 10;            
               gauge.MainScale.Ranges.Add(range1);            
            }
        }
    }

    Stroke

    Gets or sets the brush that describes the Stroke value of the CircularRange.

    Declaration
    public Brush Stroke { get; set; }
    Property Value
    Type Description
    System.Windows.Media.Brush

    Brush

    Examples
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    using Common;
    using Syncfusion.UI.Xaml.Gauges;
    
    namespace GaugeWinRTSamples
    {
        public sealed partial class GaugePosition :SampleView
        {
            public GaugePosition()
            {
               InitializeComponent();
               SfCircularGauge gauge = new SfCircularGauge();
               CircularRange range1 = new CircularRange();
               range1.StartValue = 0;
               range1.EndValue = 40;
               range1.Stroke = new SolidColorBrush(Colors.Green);
               range1.StrokeThickness = 10;            
               gauge.MainScale.Ranges.Add(range1);            
            }
        }
    }

    StrokeThickness

    Gets or sets thickness of the RangeStroke.

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

    double

    Examples
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    using Common;
    using Syncfusion.UI.Xaml.Gauges;
    
    namespace GaugeWinRTSamples
    {
        public sealed partial class GaugePosition :SampleView
        {
            public GaugePosition()
            {
               InitializeComponent();
               SfCircularGauge gauge = new SfCircularGauge();
               CircularRange range1 = new CircularRange();
               range1.StartValue = 0;
               range1.EndValue = 40;
               range1.Stroke = new SolidColorBrush(Colors.Green);
               range1.StrokeThickness = 10;            
               gauge.MainScale.Ranges.Add(range1);            
            }
        }
    }

    Methods

    OnApplyTemplate()

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