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.
Inherited Members
Namespace: Syncfusion.UI.Xaml.Charts
Assembly: Syncfusion.Chart.WinUI.dll
Syntax
public class DoughnutSeries : CircularSeries, ISegmentSelectable, INotifyPropertyChanged
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, StrokeThickness, 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, and LegendIconTemplate property.
Examples
<chart:SfCircularChart>
<chart:DoughnutSeries ItemsSource="{Binding Data}"
XBindingPath="XValue"
YBindingPath="YValue"/>
</chart:SfCircularChart>
Constructors
DoughnutSeries()
Initializes a new instance of the DoughnutSeries class.
Declaration
public DoughnutSeries()
Fields
InnerRadiusProperty
The DependencyProperty for InnerRadius property
Declaration
public static readonly DependencyProperty InnerRadiusProperty
Field Value
Type | Description |
---|---|
Microsoft.UI.Xaml.DependencyProperty |
SelectionBehaviorProperty
The DependencyProperty for SelectionBehavior property. .
Declaration
public static readonly DependencyProperty SelectionBehaviorProperty
Field Value
Type | Description |
---|---|
Microsoft.UI.Xaml.DependencyProperty |
Properties
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. |
Segment
Declaration
public DoughnutSegment Segment { get; }
Property Value
Type | Description |
---|---|
DoughnutSegment |
SelectionBehavior
Gets or sets a selection behavior that enables you to select or highlight a segment in a series.
Declaration
public DataPointSelectionBehavior SelectionBehavior { get; set; }
Property Value
Type | Description |
---|---|
DataPointSelectionBehavior | This property takes the DataPointSelectionBehavior instance as value and its default value is null. |
Remarks
To highlight the selected data point, set the value for the SelectionBrush property in the DataPointSelectionBehavior class.
Examples
<chart:SfCircularChart>
<chart:DoughnutSeries ItemsSource="{Binding Data}"
XBindingPath="XValue"
YBindingPath="YValue">
<chart:DoughnutSeries.SelectionBehavior>
<chart:DataPointSelectionBehavior SelectionBrush = "Red" />
</chart:DoughnutSeries.SelectionBehavior>
</chart:DoughnutSeries>
</chart:SfCircularChart>