menu

UWP

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

    Show / Hide Table of Contents

    Class DoughnutSeries

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

    Inheritance
    System.Object
    ChartSeriesBase
    ChartSeries
    AdornmentSeries
    AccumulationSeriesBase
    CircularSeriesBase
    DoughnutSeries
    Implements
    ICloneable
    ISegmentSelectable
    System.ComponentModel.INotifyPropertyChanged
    Inherited Members
    AccumulationSeriesBase.ExplodeAll
    AccumulationSeriesBase.ExplodeAllProperty
    AccumulationSeriesBase.ExplodeIndex
    AccumulationSeriesBase.ExplodeIndexProperty
    AccumulationSeriesBase.ExplodeOnMouseClick
    AccumulationSeriesBase.ExplodeOnMouseClickProperty
    AccumulationSeriesBase.GeneratePoints()
    AccumulationSeriesBase.OnBindingPathChanged(DependencyPropertyChangedEventArgs)
    AccumulationSeriesBase.OnSeriesMouseDown(Object, Point)
    AccumulationSeriesBase.OnSeriesMouseUp(Object, Point)
    AccumulationSeriesBase.SegmentSelectionBrush
    AccumulationSeriesBase.SegmentSelectionBrushProperty
    AccumulationSeriesBase.SelectedIndex
    AccumulationSeriesBase.SelectedIndexChanged(Int32, Int32)
    AccumulationSeriesBase.SelectedIndexProperty
    AccumulationSeriesBase.SelectedSegment
    AccumulationSeriesBase.SelectedSegments
    AccumulationSeriesBase.YBindingPath
    AccumulationSeriesBase.YBindingPathProperty
    AccumulationSeriesBase.YValues
    AdornmentSeries.AddAdornmentAtXY(Double, Double, Int32)
    AdornmentSeries.AddAreaAdornments(IList<Double>[])
    AdornmentSeries.AddColumnAdornments(Double[])
    AdornmentSeries.AdornmentLabelCreated
    AdornmentSeries.AdornmentsInfo
    AdornmentSeries.AdornmentsInfoProperty
    AdornmentSeries.ClearUnUsedAdornments(Int32)
    AdornmentSeries.OnApplyTemplate()
    ChartSeries.Area
    ChartSeries.GetDataPointIndex(Double, Double)
    ChartSeries.Stroke
    ChartSeries.StrokeProperty
    ChartSeries.StrokeThickness
    ChartSeries.StrokeThicknessProperty
    ChartSeriesBase.ActualXAxis
    ChartSeriesBase.ActualXValues
    ChartSeriesBase.ActualYAxis
    ChartSeriesBase.Adornments
    ChartSeriesBase.AnimationDuration
    ChartSeriesBase.AnimationDurationProperty
    ChartSeriesBase.ChartTransformer
    ChartSeriesBase.ClearUnUsedSegments(Int32)
    ChartSeriesBase.Clone()
    ChartSeriesBase.ColorModel
    ChartSeriesBase.ColorModelProperty
    ChartSeriesBase.ColorValues
    ChartSeriesBase.CreateEmptyPointSegments(IList<Double>, List<List<Double>>, List<List<Double>>)
    ChartSeriesBase.DataCount
    ChartSeriesBase.EmptyPointInterior
    ChartSeriesBase.EmptyPointInteriorProperty
    ChartSeriesBase.EmptyPointStyle
    ChartSeriesBase.EmptyPointStyleProperty
    ChartSeriesBase.EmptyPointSymbolTemplate
    ChartSeriesBase.EmptyPointSymbolTemplateProperty
    ChartSeriesBase.EmptyPointValue
    ChartSeriesBase.EmptyPointValueProperty
    ChartSeriesBase.EnableAnimation
    ChartSeriesBase.EnableAnimationProperty
    ChartSeriesBase.FindNearestChartPoint(Point, Double, Double, Double)
    ChartSeriesBase.GeneratePoints(String[], IList<Double>[])
    ChartSeriesBase.GetAvailableSize()
    ChartSeriesBase.GetPreviousSeries(ChartSeriesBase)
    ChartSeriesBase.GetSideBySideInfo(ChartSeriesBase)
    ChartSeriesBase.GetSpacing(DependencyObject)
    ChartSeriesBase.GetXValues()
    ChartSeriesBase.InitialDelayTimer
    ChartSeriesBase.Interior
    ChartSeriesBase.InteriorProperty
    ChartSeriesBase.Invalidate()
    ChartSeriesBase.IsAreaTypeSeries
    ChartSeriesBase.IsBitmapSeries
    ChartSeriesBase.IsColorPathSeries
    ChartSeriesBase.IsIndexed
    ChartSeriesBase.IsLinear
    ChartSeriesBase.IsSeriesVisible
    ChartSeriesBase.IsSeriesVisibleProperty
    ChartSeriesBase.IsSideBySide
    ChartSeriesBase.IsSortData
    ChartSeriesBase.IsSortDataProperty
    ChartSeriesBase.IsStacked
    ChartSeriesBase.IsTooltipAvailable(Canvas)
    ChartSeriesBase.ItemsSource
    ChartSeriesBase.ItemsSourceProperty
    ChartSeriesBase.Label
    ChartSeriesBase.LabelProperty
    ChartSeriesBase.LegendIcon
    ChartSeriesBase.LegendIconProperty
    ChartSeriesBase.LegendIconTemplate
    ChartSeriesBase.LegendIconTemplateProperty
    ChartSeriesBase.ListenPropertyChange
    ChartSeriesBase.ListenPropertyChangeProperty
    ChartSeriesBase.OnDataSourceChanged(DependencyPropertyChangedEventArgs)
    ChartSeriesBase.OnPointerExited(PointerRoutedEventArgs)
    ChartSeriesBase.OnPointerMoved(PointerRoutedEventArgs)
    ChartSeriesBase.OnPointerPressed(PointerRoutedEventArgs)
    ChartSeriesBase.OnPointerReleased(PointerRoutedEventArgs)
    ChartSeriesBase.OnTapped(TappedRoutedEventArgs)
    ChartSeriesBase.Palette
    ChartSeriesBase.PaletteProperty
    ChartSeriesBase.Position(Point, ChartTooltip)
    ChartSeriesBase.PropertyChanged
    ChartSeriesBase.ResumeNotification()
    ChartSeriesBase.SegmentColorPath
    ChartSeriesBase.SegmentColorPathProperty
    ChartSeriesBase.Segments
    ChartSeriesBase.SelectedSegmentsIndexes
    ChartSeriesBase.SeriesSelectionBrush
    ChartSeriesBase.SeriesSelectionBrushProperty
    ChartSeriesBase.SetDoubleAnimation(ChartTooltip)
    ChartSeriesBase.SetIndividualDataTablePoint(Int32, Object, Boolean)
    ChartSeriesBase.SetIndividualPoint(Int32, Object, Boolean)
    ChartSeriesBase.SetSpacing(DependencyObject, Double)
    ChartSeriesBase.SetTooltipDuration()
    ChartSeriesBase.ShowEmptyPoints
    ChartSeriesBase.ShowEmptyPointsProperty
    ChartSeriesBase.ShowTooltip
    ChartSeriesBase.ShowTooltipProperty
    ChartSeriesBase.SortBy
    ChartSeriesBase.SortByProperty
    ChartSeriesBase.SortDirection
    ChartSeriesBase.SortDirectionProperty
    ChartSeriesBase.SpacingProperty
    ChartSeriesBase.SuspendNotification()
    ChartSeriesBase.Timer
    ChartSeriesBase.TooltipTemplate
    ChartSeriesBase.TooltipTemplateProperty
    ChartSeriesBase.TrackBallLabelTemplate
    ChartSeriesBase.TrackBallLabelTemplateProperty
    ChartSeriesBase.UpdateArea()
    ChartSeriesBase.UpdateSegments(Int32, NotifyCollectionChangedAction)
    ChartSeriesBase.VisibilityOnLegend
    ChartSeriesBase.VisibilityOnLegendProperty
    ChartSeriesBase.XBindingPath
    ChartSeriesBase.XBindingPathProperty
    ChartSeriesBase.YPaths
    CircularSeriesBase.ConnectorLinePosition
    CircularSeriesBase.ConnectorLinePositionProperty
    CircularSeriesBase.ConnectorType
    CircularSeriesBase.ConnectorTypeProperty
    CircularSeriesBase.DegreeToRadianConverter(Double)
    CircularSeriesBase.EnableSmartLabels
    CircularSeriesBase.EnableSmartLabelsProperty
    CircularSeriesBase.EndAngle
    CircularSeriesBase.EndAngleProperty
    CircularSeriesBase.ExplodeRadius
    CircularSeriesBase.ExplodeRadiusProperty
    CircularSeriesBase.GroupMode
    CircularSeriesBase.GroupModeProperty
    CircularSeriesBase.GroupTo
    CircularSeriesBase.GroupToProperty
    CircularSeriesBase.LabelPosition
    CircularSeriesBase.LabelPositionProperty
    CircularSeriesBase.ShowMarkerAtLineEnd
    CircularSeriesBase.ShowMarkerAtLineEndProperty
    CircularSeriesBase.StartAngle
    CircularSeriesBase.StartAngleProperty
    Namespace: Syncfusion.UI.Xaml.Charts
    Assembly: Syncfusion.SfChart.UWP.dll
    Syntax
    public class DoughnutSeries : CircularSeriesBase, ICloneable, ISegmentSelectable, INotifyPropertyChanged
    Examples
          <syncfusion:DoughnutSeries ItemsSource="{Binding Data}" XBindingPath="Year" YBindingPath="Value">
          </syncfusion:DoughnutSeries>
          DoughnutSeries series1 = new DoughnutSeries();
          series1.ItemsSource = viewmodel.Data;
          series1.XBindingPath = "Year";
          series1.YBindingPath = "Value";
          chart.Series.Add(series1);

    Constructors

    DoughnutSeries()

    Called when instance created for DoughnutSeries

    Declaration
    public DoughnutSeries()

    Fields

    CapStyleProperty

    Using a DependencyProperty as the backing store for CapStyle. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty CapStyleProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty

    CenterViewProperty

    The DependencyProperty for CenterView property

    Declaration
    public static readonly DependencyProperty CenterViewProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty

    DoughnutCoefficientProperty

    The DependencyProperty for DoughnutCoefficient property.

    Declaration
    public static readonly DependencyProperty DoughnutCoefficientProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty

    DoughnutHoleSizeProperty

    Using a DependencyProperty as the backing store for DoughnutHoleSize. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty DoughnutHoleSizeProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty

    DoughnutSizeProperty

    The DependencyProperty for DoughnutSize property.

    Declaration
    public static readonly DependencyProperty DoughnutSizeProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty

    IsStackedDoughnutProperty

    Using a DependencyProperty as the backing store for IsStackedDoughnut. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty IsStackedDoughnutProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty

    MaximumValueProperty

    Using a DependencyProperty as the backing store for MaximumValue. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty MaximumValueProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty

    SegmentSpacingProperty

    Using a DependencyProperty as the backing store for GapRatio.This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty SegmentSpacingProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty

    TrackBorderColorProperty

    Using a DependencyProperty as the backing store for brushTrackBorderColor. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty TrackBorderColorProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty

    TrackBorderWidthProperty

    Using a DependencyProperty as the backing store for TrackBorderWidth. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty TrackBorderWidthProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty

    TrackColorProperty

    Using a DependencyProperty as the backing store for RimColor. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty TrackColorProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty

    Properties

    CapStyle

    Gets or sets the capstyle that specifies the start and end points of doughtnut segment. This is a bindable property.

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

    CenterView

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

    Declaration
    public ContentControl CenterView { get; set; }
    Property Value
    Type
    Windows.UI.Xaml.Controls.ContentControl

    DoughnutCoefficient

    Gets or sets a value that specifies the inner circular radius of the DoughnutSeries. This is a bindable property.

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

    The double value ranges from 0 to 1.

    DoughnutSize

    Gets or sets the size of the DoughnutSeries.

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

    InnerRadius

    Gets the inner radius of DoughnutSeries.

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

    IsStackedDoughnut

    Gets or sets a value indicating whether to draw stacked doughnut segment.

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

    MaximumValue

    Gets or sets the maximum value for the doughnut segment when stacked doughnut is used.

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

    Segment

    Gets for internal usage

    Declaration
    public DoughnutSegment Segment { get; }
    Property Value
    Type
    DoughnutSegment

    SegmentSpacing

    Gets or sets a value that specifies the gap ratio for the doughnut segments. This is a bindable property.

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

    The double value ranges from 0 to 1.

    TrackBorderColor

    Gets or sets the brush that specifies the track area border color for stacked doughnut. This is a bindable property.

    Declaration
    public Brush TrackBorderColor { get; set; }
    Property Value
    Type
    Windows.UI.Xaml.Media.Brush

    TrackBorderWidth

    Gets or sets a value that specifies the track area border width for stacked doughnut. This is a bindable property.

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

    TrackColor

    Gets or sets the brush that specifies the track area segment color for stacked doughnut. This is a bindable property.

    Declaration
    public Brush TrackColor { get; set; }
    Property Value
    Type
    Windows.UI.Xaml.Media.Brush

    Methods

    CloneSeries(DependencyObject)

    Returns the instance of DoughnutSeries series.

    Declaration
    protected override DependencyObject CloneSeries(DependencyObject obj)
    Parameters
    Type Name Description
    Windows.UI.Xaml.DependencyObject obj

    object

    Returns
    Type
    Windows.UI.Xaml.DependencyObject
    Overrides
    CircularSeriesBase.CloneSeries(DependencyObject)

    CreateAdornment(AdornmentSeries, Double, Double, Double, Double)

    Method implementation for create Adornments.

    Declaration
    protected override ChartAdornment CreateAdornment(AdornmentSeries series, double xVal, double yVal, double angle, double radius)
    Parameters
    Type Name Description
    AdornmentSeries series
    System.Double xVal
    System.Double yVal
    System.Double angle
    System.Double radius
    Returns
    Type
    ChartAdornment
    Overrides
    AdornmentSeries.CreateAdornment(AdornmentSeries, Double, Double, Double, Double)

    CreateSegment()

    Creates an instance of series segment.

    Declaration
    protected override ChartSegment CreateSegment()
    Returns
    Type Description
    ChartSegment

    Returns the instance of corresponding series segment.

    Overrides
    ChartSeries.CreateSegment()
    Remarks

    This customization is not supported for fast type series and technical indicators.

    Examples

    This sample shows how to call the CreateSegment() method to customize the line series segments.

    public class LineSeriesExt : LineSeries
    {​ 
        protected override ChartSegment CreateSegment()
        {​
            return new LineSegmentExt();
        }​
    }​
    
    public class LineSegmentExt : LineSegment
    {​
        public override UIElement CreateVisual(Size size)
        {​
            // Write your customization code here.
        }​
    
        public override void Update(IChartTransformer transformer)
        {​
            // Write your customization code here.
        }​
    }

    CreateSegments()

    Creates the doughnut segments.

    Declaration
    public override void CreateSegments()
    Overrides
    AdornmentSeries.CreateSegments()

    CreateTransformer(Size, Boolean)

    Return IChartTransformer value from the given size.

    Declaration
    protected override IChartTransformer CreateTransformer(Size size, bool create)
    Parameters
    Type Name Description
    Windows.Foundation.Size size

    Size

    System.Boolean create

    bool

    Returns
    Type
    Syncfusion.UI.Xaml.Charts.IChartTransformer
    Overrides
    ChartSeriesBase.CreateTransformer(Size, Boolean)

    GetDoughnutHoleSize(DependencyObject)

    Returns the doughnut hole size.

    Declaration
    public static double GetDoughnutHoleSize(DependencyObject obj)
    Parameters
    Type Name Description
    Windows.UI.Xaml.DependencyObject obj

    object

    Returns
    Type
    System.Double

    OnDataSourceChanged(IEnumerable, IEnumerable)

    Called when ItemsSource property changed.

    Declaration
    protected override void OnDataSourceChanged(IEnumerable oldValue, IEnumerable newValue)
    Parameters
    Type Name Description
    System.Collections.IEnumerable oldValue

    old value

    System.Collections.IEnumerable newValue

    new value

    Overrides
    AccumulationSeriesBase.OnDataSourceChanged(IEnumerable, IEnumerable)

    SetDoughnutHoleSize(DependencyObject, Double)

    Sets the doughnut hole size.

    Declaration
    public static void SetDoughnutHoleSize(DependencyObject obj, double value)
    Parameters
    Type Name Description
    Windows.UI.Xaml.DependencyObject obj

    object

    System.Double value

    value

    SetExplodeAll()

    Virtual method for ExplodeAll.

    Declaration
    protected override void SetExplodeAll()
    Overrides
    AccumulationSeriesBase.SetExplodeAll()

    SetExplodeIndex(Int32)

    Method implementation for ExplodeIndex.

    Declaration
    protected override void SetExplodeIndex(int i)
    Parameters
    Type Name Description
    System.Int32 i
    Overrides
    AccumulationSeriesBase.SetExplodeIndex(Int32)

    SetExplodeRadius()

    Virtual Method for ExplodeRadius.

    Declaration
    protected override void SetExplodeRadius()
    Overrides
    AccumulationSeriesBase.SetExplodeRadius()

    Implements

    ICloneable
    ISegmentSelectable
    System.ComponentModel.INotifyPropertyChanged

    Extension Methods

    DateTimeExtension.ToDateTime(Object)

    See Also

    DoughnutSegment
    PieSeries
    PieSegment
    Back to top Generated by DocFX
    Copyright © 2001 - 2025 Syncfusion Inc. All Rights Reserved