menu

Class CircularSeries - WinUI API Reference | Syncfusion

    Show / Hide Table of Contents

    Class CircularSeries

    Inheritance
    System.Object
    ChartSeries
    CircularSeries
    PieSeries
    Implements
    System.ComponentModel.INotifyPropertyChanged
    Inherited Members
    ChartSeries.ActualXAxis
    ChartSeries.ActualYAxis
    ChartSeries.AnimationDuration
    ChartSeries.AnimationDurationProperty
    ChartSeries.Chart
    ChartSeries.EnableAnimation
    ChartSeries.EnableAnimationProperty
    ChartSeries.EnableTooltip
    ChartSeries.EnableTooltipProperty
    ChartSeries.Fill
    ChartSeries.FillProperty
    ChartSeries.IsSeriesVisible
    ChartSeries.IsSeriesVisibleProperty
    ChartSeries.IsVisibleOnLegend
    ChartSeries.IsVisibleOnLegendProperty
    ChartSeries.ItemsSource
    ChartSeries.ItemsSourceProperty
    ChartSeries.Label
    ChartSeries.LabelProperty
    ChartSeries.LegendIcon
    ChartSeries.LegendIconProperty
    ChartSeries.LegendIconTemplate
    ChartSeries.LegendIconTemplateProperty
    ChartSeries.ListenPropertyChange
    ChartSeries.ListenPropertyChangeProperty
    ChartSeries.OnPointerExited(PointerRoutedEventArgs)
    ChartSeries.OnPointerMoved(PointerRoutedEventArgs)
    ChartSeries.OnPointerPressed(PointerRoutedEventArgs)
    ChartSeries.OnPointerReleased(PointerRoutedEventArgs)
    ChartSeries.OnTapped(TappedRoutedEventArgs)
    ChartSeries.PaletteBrushes
    ChartSeries.PaletteBrushesProperty
    ChartSeries.PropertyChanged
    ChartSeries.ResumeNotification()
    ChartSeries.SelectionBehavior
    ChartSeries.SelectionBehaviorProperty
    ChartSeries.ShowDataLabels
    ChartSeries.ShowDataLabelsProperty
    ChartSeries.SpacingProperty
    ChartSeries.SuspendNotification()
    ChartSeries.TooltipTemplate
    ChartSeries.TooltipTemplateProperty
    ChartSeries.TrackballLabelTemplate
    ChartSeries.TrackballLabelTemplateProperty
    ChartSeries.XBindingPath
    ChartSeries.XBindingPathProperty
    Namespace: Syncfusion.UI.Xaml.Charts
    Assembly: Syncfusion.Chart.WinUI.dll
    Syntax
    public abstract class CircularSeries : ChartSeries, INotifyPropertyChanged

    Constructors

    CircularSeries()

    Initializes a new instance of the CircularSeries class.

    Declaration
    public CircularSeries()

    Fields

    DataLabelSettingsProperty

    Identifies the DataLabelSettings dependency property.

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

    The identifier for DataLabelSettings dependency property.

    EndAngleProperty

    The DependencyProperty for EndAngle property.

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

    GroupModeProperty

    The DependencyProperty for GroupMode property.

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

    GroupToProperty

    The DependencyProperty for GroupTo property.

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

    RadiusProperty

    The DependencyProperty for Radius property.

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

    StartAngleProperty

    The DependencyProperty for StartAngle property.

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

    StrokeProperty

    The DependencyProperty for Stroke property.

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

    StrokeWidthProperty

    The DependencyProperty for StrokeWidth property.

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

    YBindingPathProperty

    The DependencyProperty for YBindingPath property.

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

    Properties

    DataLabelSettings

    Gets or sets a value to customize the appearance of the displaying data labels in the circular series.

    Declaration
    public CircularDataLabelSettings DataLabelSettings { get; set; }
    Property Value
    Type Description
    CircularDataLabelSettings

    This property takes the CircularDataLabelSettings.

    Remarks

    This allows us to change the look of the displaying labels' content, shapes, and connector lines at the data point.

    Examples
    • MainWindow.xaml
    • MainWindow.cs
        <chart:SfCircularChart>
    
           <chart:PieSeries ItemsSource="{Binding Data}"
                            XBindingPath="XValue"
                            YBindingPath="YValue"
                            ShowDataLabels="True">
               <chart:PieSeries.DataLabelSettings>
                   <chart:CircularDataLabelSettings Position ="Outside" />
               </chart:PieSeries.DataLabelSettings>
           </chart:PieSeries>
    
        </chart:SfCircularChart>
        SfCircularChart chart = new SfCircularChart();
        ViewModel viewModel = new ViewModel();
    
        PieSeries series = new PieSeries();
        series.ItemsSource = viewModel.Data;
        series.XBindingPath = "XValue";
        series.YBindingPath = "YValue";
        series.ShowDataLabels = "True";
        series.DataLabelSettings = new CircularDataLabelSettings()
        {
            Position = CircularSeriesLabelPosition.Outside,
    .    };
        chart.Series.Add(series);

    EndAngle

    Gets or sets a value that can be used to modify the series end rendering position.

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

    It accepts double values, and the default value is 360.

    Remarks

    It is used to draw a series in different shapes.

    Examples
    • Xaml
    • C#
        <chart:SfCircularChart>
    
             <chart:PieSeries ItemsSource="{Binding Data}"
                               XBindingPath="XValue"
                               YBindingPath="YValue"
                               EndAngle = "270"/>
    
        </chart:SfCircularChart>
        SfCircularChart chart = new SfCircularChart();
        ViewModel viewModel = new ViewModel();
    
        PieSeries series = new PieSeries()
        {
              ItemsSource = viewModel.Data,
              XBindingPath = "XValue",
              YBindingPath = "YValue",
              EndAngle = 270,
        };
    
        chart.Series.Add(series);

    GroupMode

    Gets or sets the group mode, which determines the type of grouping based on slice Angle, actual data point Value, or Percentage.

    Declaration
    public PieGroupMode GroupMode { get; set; }
    Property Value
    Type Description
    PieGroupMode

    It accepts PieGroupMode values and the default value is Value.

    Examples
    • Xaml
    • C#
        <chart:SfCircularChart>
    
             <chart:PieSeries ItemsSource="{Binding Data}"
                               XBindingPath="XValue"
                               YBindingPath="YValue"
                               GroupMode = "Percentage"/>
    
        </chart:SfCircularChart>
        SfCircularChart chart = new SfCircularChart();
        ViewModel viewModel = new ViewModel();
    
        PieSeries series = new PieSeries()
        {
              ItemsSource = viewModel.Data,
              XBindingPath = "XValue",
              YBindingPath = "YValue",
              GroupMode = PieGroupMode.Percentage,
        };
    
        chart.Series.Add(series);

    GroupTo

    Gets or sets the value that indicates the grouping of series segments.

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

    It accepts double values and the default value is double.NaN.

    Remarks

    It is used to limit the number of data points that can be grouped into a single slice.

    Examples
    • Xaml
    • C#
        <chart:SfCircularChart>
    
             <chart:PieSeries ItemsSource="{Binding Data}"
                               XBindingPath="XValue"
                               YBindingPath="YValue"
                               GroupTo = "1000"
                               GroupMode = "Value"/>
    
        </chart:SfCircularChart>
        SfCircularChart chart = new SfCircularChart();
        ViewModel viewModel = new ViewModel();
    
        PieSeries series = new PieSeries()
        {
              ItemsSource = viewModel.Data,
              XBindingPath = "XValue",
              YBindingPath = "YValue",
              GroupTo = 1000,
              GroupMode = PieGroupMode.Value,
        };
    
        chart.Series.Add(series);

    Radius

    Gets or sets a value that can be used to render the series size.

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

    It accepts double values, and the default value is 0.8. Here, the value is between 0 and 1.

    Examples
    • Xaml
    • C#
        <chart:SfCircularChart>
    
             <chart:PieSeries ItemsSource="{Binding Data}"
                               XBindingPath="XValue"
                               YBindingPath="YValue"
                               Radius = "0.7"/>
    
        </chart:SfCircularChart>
        SfCircularChart chart = new SfCircularChart();
        ViewModel viewModel = new ViewModel();
    
        PieSeries series = new PieSeries()
        {
              ItemsSource = viewModel.Data,
              XBindingPath = "XValue",
              YBindingPath = "YValue",
              Radius = 0.7,
        };
    
        chart.Series.Add(series);

    StartAngle

    Gets or sets a value that can be used to modify the series start rendering position.

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

    It accepts double values, and the default value is 0.

    Remarks

    It is used to draw a series in different shapes.

    Examples
    • Xaml
    • C#
        <chart:SfCircularChart>
    
             <chart:PieSeries ItemsSource="{Binding Data}"
                               XBindingPath="XValue"
                               YBindingPath="YValue"
                               StartAngle = "180"/>
    
        </chart:SfCircularChart>
        SfCircularChart chart = new SfCircularChart();
        ViewModel viewModel = new ViewModel();
    
        PieSeries series = new PieSeries()
        {
              ItemsSource = viewModel.Data,
              XBindingPath = "XValue",
              YBindingPath = "YValue",
              StartAngle = 180,
        };
    
        chart.Series.Add(series);

    Stroke

    Gets or sets a value to customize the stroke appearance of a chart series.

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

    It accepts Microsoft.UI.Xaml.Media.Brush values and its default value is null.

    Examples
    • Xaml
    • C#
        <chart:SfCircularChart>
    
        <!-- ... Eliminated for simplicity-->
    
             <chart:PieSeries ItemsSource="{Binding Data}"
                               XBindingPath="XValue"
                               YBindingPath="YValue"
                               Stroke = "Red"
                               StrokeThickness = "3"/>
    
        </chart:SfCircularChart>
        SfCircularChart chart = new SfCircularChart();
        ViewModel viewModel = new ViewModel();
    
        // Eliminated for simplicity
    
        PieSeries pieSeries = new PieSeries()
        {
              ItemsSource = viewModel.Data,
              XBindingPath = "XValue",
              YBindingPath = "YValue",
              Stroke = new SolidColorBrush(Colors.Red),
              StrokeThickness= 3,
        };
    
        chart.Series.Add(pieSeries);

    StrokeWidth

    Gets or sets a value to specify the stroke thickness of a chart series.

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

    It accepts double values and its default value is 2.

    Examples
    • Xaml
    • C#
        <chart:SfCircularChart>
    
        <!-- ... Eliminated for simplicity-->
    
             <chart:PieSeries ItemsSource="{Binding Data}"
                               XBindingPath="XValue"
                               YBindingPath="YValue"
                               Stroke = "Red"
                               StrokeThickness = "3"/>
    
        </chart:SfCircularChart>
        SfCircularChart chart = new SfCircularChart();
        ViewModel viewModel = new ViewModel();
    
        // Eliminated for simplicity
    
        PieSeries pieSeries = new PieSeries()
        {
              ItemsSource = viewModel.Data,
              XBindingPath = "XValue",
              YBindingPath = "YValue",
              Stroke = new SolidColorBrush(Colors.Red),
              StrokeThickness= 3,
        };
    
        chart.Series.Add(pieSeries);

    YBindingPath

    Gets or sets a path value on the source object to serve a y value to the series.

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

    The string that represents the property name for the y plotting data, and its default value is null.

    Examples
    • Xaml
    • C#
        <chart:SfCircularChart>
    
        <!-- ... Eliminated for simplicity-->
    
             <chart:PieSeries ItemsSource="{Binding Data}"
                               XBindingPath="XValue"
                               YBindingPath="YValue" />
    
        </chart:SfCircularChart>
        SfCircularChart chart = new SfCircularChart();
        ViewModel viewModel = new ViewModel();
    
        // Eliminated for simplicity
    
        PieSeries pieSeries = new PieSeries()
        {
              ItemsSource = viewModel.Data,
              XBindingPath = "XValue",
              YBindingPath = "YValue",
        };
    
        chart.Series.Add(pieSeries);

    Methods

    OnApplyTemplate()

    Declaration
    protected override void OnApplyTemplate()
    Overrides
    ChartSeries.OnApplyTemplate()

    Implements

    System.ComponentModel.INotifyPropertyChanged
    Back to top Generated by DocFX
    Copyright © 2001 - 2025 Syncfusion Inc. All Rights Reserved