menu

MAUI

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

    Show / Hide Table of Contents

    Class CircularSeries

    CircularSeries is the base class for pie and doughnut charts.

    Inheritance
    System.Object
    ChartSeries
    CircularSeries
    PieSeries
    RadialBarSeries
    Inherited Members
    ChartSeries.CreateAnimation(Action<Double>)
    ChartSeries.CreateSegment()
    ChartSeries.DrawSeries(ICanvas, ReadOnlyObservableCollection<ChartSegment>, RectF)
    ChartSeries.EnableAnimation
    ChartSeries.EnableAnimationProperty
    ChartSeries.EnableTooltip
    ChartSeries.EnableTooltipProperty
    ChartSeries.Fill
    ChartSeries.FillProperty
    ChartSeries.GetDataPointIndex(Single, Single)
    ChartSeries.IsVisible
    ChartSeries.IsVisibleOnLegend
    ChartSeries.IsVisibleOnLegendProperty
    ChartSeries.IsVisibleProperty
    ChartSeries.ItemsSource
    ChartSeries.ItemsSourceProperty
    ChartSeries.LabelContext
    ChartSeries.LabelContextProperty
    ChartSeries.LabelTemplate
    ChartSeries.LabelTemplateProperty
    ChartSeries.LegendIcon
    ChartSeries.LegendIconProperty
    ChartSeries.OnParentSet()
    ChartSeries.Opacity
    ChartSeries.OpacityProperty
    ChartSeries.PaletteBrushes
    ChartSeries.PaletteBrushesProperty
    ChartSeries.SelectionBehavior
    ChartSeries.SelectionBehaviorProperty
    ChartSeries.ShowDataLabels
    ChartSeries.ShowDataLabelsProperty
    ChartSeries.TooltipTemplate
    ChartSeries.TooltipTemplateProperty
    ChartSeries.XBindingPath
    ChartSeries.XBindingPathProperty
    ChartSeries.XRange
    ChartSeries.YRange
    Namespace: Syncfusion.Maui.Charts
    Assembly: Syncfusion.Maui.Charts.dll
    Syntax
    public abstract class CircularSeries : ChartSeries, IDatapointSelectionDependent, ITooltipDependent, IDataTemplateDependent

    Constructors

    CircularSeries()

    Initializes a new instance of the CircularSeries class.

    Declaration
    public CircularSeries()

    Fields

    DataLabelSettingsProperty

    Identifies the DataLabelSettings bindable property.

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

    EndAngleProperty

    Identifies the EndAngle bindable property.

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

    RadiusProperty

    Identifies the Radius bindable property.

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

    StartAngleProperty

    Identifies the StartAngle bindable property.

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

    StrokeProperty

    Identifies the Stroke bindable property.

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

    StrokeWidthProperty

    Identifies the StrokeWidth bindable property.

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

    YBindingPathProperty

    Identifies the YBindingPath bindable property.

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

    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:SfCircularChart.Series>
                  <chart:PieSeries ItemsSource="{Binding Data}"
                                   XBindingPath="XValue"
                                   YBindingPath="YValue"
                                   ShowDataLabels="True">
                       <syncfusion:PieSeries.DataLabelSettings>
                             <chart:CircularDataLabelSettings LabelPlacement="Outer" />
                       <syncfusion:PieSeries.DataLabelSettings>
                  </chart:PieSeries> 
              </chart:SfCircularChart.Series>
    
        </chart:SfCircularChart>
        SfCircularChart chart = new SfCircularChart();
    
        PieSeries series = new PieSeries();
        series.ItemsSource = viewmodel.Data;
        series.XBindingPath = "XValue";
        series.YBindingPath = "YValue";
        series.ShowDataLabels = "True";
        chart.Series.Add(series);
    
        series.DataLabelSettings = new CircularDataLabelSettings(){ LabelPlacement = DataLabelPlacement.Outer };

    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);

    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 the series.

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

    It accepts Microsoft.Maui.Controls.Brush values and its default value is null.

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

    StrokeWidth

    Gets or sets a value to specify the stroke width 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.

    Remarks

    The value needs to be greater than zero.

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

    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>
    
             <chart:PieSeries ItemsSource="{Binding Data}"
                               XBindingPath="XValue"
                               YBindingPath="YValue" />
    
        </chart:SfCircularChart>
        SfCircularChart chart = new SfCircularChart();
        ViewModel viewModel = new ViewModel();
    
        PieSeries series = new PieSeries()
        {
              ItemsSource = viewModel.Data,
              XBindingPath = "XValue",
              YBindingPath = "YValue",
        };
    
        chart.Series.Add(series);

    Methods

    DrawDataLabel(ICanvas, Brush, String, PointF, Int32)

    Declaration
    protected override void DrawDataLabel(ICanvas canvas, Brush fillcolor, string label, PointF point, int index)
    Parameters
    Type Name Description
    Microsoft.Maui.Graphics.ICanvas canvas
    Microsoft.Maui.Controls.Brush fillcolor
    System.String label
    Microsoft.Maui.Graphics.PointF point
    System.Int32 index
    Overrides
    ChartSeries.DrawDataLabel(ICanvas, Brush, String, PointF, Int32)

    OnBindingContextChanged()

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