Class DoughnutSeries

The DoughnutSeries displays data as a proportion of the whole. Its most commonly used to make comparisons among a set of given data.

Inheritance
System.Object
ChartSeries
CircularSeries
PieSeries
DoughnutSeries
Inherited Members
Namespace: Syncfusion.Maui.Toolkit.Charts
Assembly: Syncfusion.Maui.Toolkit.dll
Syntax
public class DoughnutSeries : PieSeries, IDatapointSelectionDependent, ITooltipDependent, IDataTemplateDependent, IDrawCustomLegendIcon
Remarks

It is similar to the PieSeries. To render a series, create an instance of the doughnut series class, and add it to the Series collection.

It Provides options for PaletteBrushes, Fill, Stroke, StrokeWidth, and InnerRadius to customize the appearance.

EnableTooltip - The tooltip displays information while tapping or mouse hovering on the segment. To display the tooltip on the chart, you need to set the EnableTooltip property as true in DoughnutSeries and refer to the TooltipBehavior property.

Data Label - Data labels are used to display values related to a chart segment. To render the data labels, you need to set the ShowDataLabels property as true in the DoughnutSeries class. To customize the chart data labels’ alignment, placement, and label styles, you need to create an instance of CircularDataLabelSettings and set it to the DataLabelSettings property.

Animation - To animate the series, set True to the EnableAnimation property.

Selection - To enable the data point selection in the series, create an instance of the DataPointSelectionBehavior and set it to the SelectionBehavior property of the doughnut series. To highlight the selected segment, set the value for the SelectionBrush property in the DataPointSelectionBehavior class.

LegendIcon - To customize the legend icon using the LegendIcon property.

Examples
    <chart:SfCircularChart>

          <chart:SfCircularChart.Series>
              <chart:DoughnutSeries
                  ItemsSource="{Binding Data}"
                  XBindingPath="XValue"
                  YBindingPath="YValue"/>
          </chart:SfCircularChart.Series>

    </chart:SfCircularChart>

Constructors

DoughnutSeries()

Initializes a new instance of the DoughnutSeries class.

Declaration
public DoughnutSeries()

Fields

CapStyleProperty

Identifies the CapStyle bindable property.

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

The CapStyle property represents the shape of the start and end points of a doughnut segment.

CenterViewProperty

Identifies the CenterView bindable property.

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

Represents the view at the center of the doughnut series.

GapRatioProperty

Identifies the GapRatio bindable property.

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

The GapRatio property defines the space between segments

InnerRadiusProperty

Identifies the InnerRadius bindable property.

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

Represents the inner radius of the doughnut series, defining the size of the hole in the center.

Properties

CapStyle

Gets or sets the CapStyle value, that represents the shape of the start and end points of a doughnut segment.

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

It accepts CapStyle values, and its default value is BothFlat
Examples
<chart:SfCircularChart>

    <chart:SfCircularChart.BindingContext>
        <local:ViewModel/>
    </chart:SfCircularChart.BindingContext>

    <chart:DoughnutSeries ItemsSource="{Binding Data}"
                          XBindingPath="XValue"
                          YBindingPath="YValue"
                          CapStyle="BothCurve"/>  

</chart:SfCircularChart>

CenterHoleSize

Gets the size of the doughnut center hole.

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

Default value is 1.

CenterView

Gets or sets the view to be added to the center of the doughnut.

Declaration
public View CenterView { get; set; }
Property Value
Type Description
Microsoft.Maui.Controls.View

It accepts the Microsoft.Maui.Controls.View values and its defaults is null.

GapRatio

Gets or sets a value to adjust spacing between segments

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

It accepts double values, and the default value is 0. Here, the value is between 0 and 1.
Examples
<chart:SfCircularChart>

    <chart:DoughnutSeries ItemsSource = "{Binding Data}"
                          XBindingPath = "XValue"
                          YBindingPath = "YValue"
                          GapRatio = "0.5"/>

</chart:SfCircularChart>

InnerRadius

Gets or sets a value that can be used to define the inner circle.

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

It accepts double values, and the default value is 0.4. Here, the value is between 0 and 1.
Examples
    <chart:SfCircularChart>

         <chart:DoughnutSeries ItemsSource="{Binding Data}"
                               XBindingPath="XValue"
                               YBindingPath="YValue"
                               InnerRadius = "0.5"/>

    </chart:SfCircularChart>

Methods

CreateSegment()

Creates and initializes a new chart segment for the chart.

Declaration
protected override ChartSegment CreateSegment()
Returns
Type
ChartSegment
Overrides