WinUI

Code Examples Upgrade Guide User Guide Demos Support Forums Download
  • Code Examples
  • Upgrade Guide
  • User Guide
  • Demos
  • Support
  • Forums
  • Download
Class PieSeries

    Show / Hide Table of Contents

    Class PieSeries

    The PieSeries 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
    DataMarkerSeries
    CircularSeries
    PieSeries
    Implements
    ISegmentSelectable
    Inherited Members
    CircularSeries.StartAngleProperty
    CircularSeries.EndAngleProperty
    CircularSeries.ExplodeRadiusProperty
    CircularSeries.GroupModeProperty
    CircularSeries.GroupToProperty
    CircularSeries.DataLabelSettingsProperty
    CircularSeries.RadiusProperty
    CircularSeries.YBindingPathProperty
    CircularSeries.ExplodeIndexProperty
    CircularSeries.ExplodeAllProperty
    CircularSeries.ExplodeOnTapProperty
    CircularSeries.DataLabelSettings
    CircularSeries.StartAngle
    CircularSeries.EndAngle
    CircularSeries.ExplodeRadius
    CircularSeries.GroupMode
    CircularSeries.GroupTo
    CircularSeries.Radius
    CircularSeries.YBindingPath
    CircularSeries.ExplodeIndex
    CircularSeries.ExplodeAll
    CircularSeries.ExplodeOnTap
    DataMarkerSeries.ShowDataLabelsProperty
    DataMarkerSeries.OnApplyTemplate()
    DataMarkerSeries.ShowDataLabels
    ChartSeries.SpacingProperty
    ChartSeries.TooltipTemplateProperty
    ChartSeries.EnableTooltipProperty
    ChartSeries.ListenPropertyChangeProperty
    ChartSeries.IsSeriesVisibleProperty
    ChartSeries.XBindingPathProperty
    ChartSeries.ItemsSourceProperty
    ChartSeries.TrackballLabelTemplateProperty
    ChartSeries.FillProperty
    ChartSeries.LabelProperty
    ChartSeries.LegendIconProperty
    ChartSeries.LegendIconTemplateProperty
    ChartSeries.IsVisibleOnLegendProperty
    ChartSeries.EnableAnimationProperty
    ChartSeries.AnimationDurationProperty
    ChartSeries.PaletteBrushesProperty
    ChartSeries.StrokeProperty
    ChartSeries.StrokeThicknessProperty
    ChartSeries.SuspendNotification()
    ChartSeries.ResumeNotification()
    ChartSeries.OnPointerPressed(PointerRoutedEventArgs)
    ChartSeries.OnPointerMoved(PointerRoutedEventArgs)
    ChartSeries.OnTapped(TappedRoutedEventArgs)
    ChartSeries.OnPointerExited(PointerRoutedEventArgs)
    ChartSeries.OnPointerReleased(PointerRoutedEventArgs)
    ChartSeries.PaletteBrushes
    ChartSeries.TooltipTemplate
    ChartSeries.EnableTooltip
    ChartSeries.ListenPropertyChange
    ChartSeries.IsSeriesVisible
    ChartSeries.ItemsSource
    ChartSeries.TrackballLabelTemplate
    ChartSeries.Fill
    ChartSeries.Label
    ChartSeries.LegendIcon
    ChartSeries.LegendIconTemplate
    ChartSeries.IsVisibleOnLegend
    ChartSeries.XBindingPath
    ChartSeries.EnableAnimation
    ChartSeries.AnimationDuration
    ChartSeries.StrokeThickness
    ChartSeries.Chart
    ChartSeries.Stroke
    ChartSeries.PropertyChanged
    Namespace: Syncfusion.UI.Xaml.Charts
    Assembly: Syncfusion.Chart.WinUI.dll
    Syntax
    public class PieSeries : CircularSeries, ISegmentSelectable
    Remarks

    To render a series, create an instance of the pie series class, and add it to the Series collection.

    It Provides options for PaletteBrushes, Fill, Stroke, StrokeThickness, and Radius to customize the appearance.

    EnableTooltip - Tooltips display information while tapping or mouse hovering over the segment. To display the tooltip on the chart, you need to set the EnableTooltip property as true in the PieSeries, and also 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 PieSeries class. To customize the chart data labels alignment, placement and label styles, need to create an instance of CircularDataLabelSettings and set 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 pie 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 properties.

    Examples
    • Xaml
    • C#
    • ViewModel
        <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();
        series.ItemsSource = viewModel.Data;
        series.XBindingPath = "XValue";
        series.YBindingPath = "YValue";
        chart.Series.Add(series);
        public ObservableCollection<Model> Data { get; set; }
    
        public ViewModel()
        {
           Data = new ObservableCollection<Model>();
           Data.Add(new Model() { XValue = 10, YValue = 100 });
           Data.Add(new Model() { XValue = 20, YValue = 150 });
           Data.Add(new Model() { XValue = 30, YValue = 110 });
           Data.Add(new Model() { XValue = 40, YValue = 230 });
        }

    Constructors

    PieSeries()

    Initializes a new instance of the PieSeries class.

    Declaration
    public PieSeries()

    Fields

    SelectionBehaviorProperty

    The DependencyProperty for SelectionBehavior property. .

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

    Properties

    Segment

    Declaration
    public PieSegment Segment { get; }
    Property Value
    Type Description
    PieSegment

    SelectionBehavior

    Gets or sets a selection behavior that enables you to select or highlight a segment in the series.

    Declaration
    public DataPointSelectionBehavior SelectionBehavior { get; set; }
    Property Value
    Type Description
    DataPointSelectionBehavior

    This property takes the aDataPointSelectionBehavior instance as a 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
    • Xaml
    • C#
        <chart:SfCircularChart>
    
             <chart:PieSeries ItemsSource="{Binding Data}"
                              XBindingPath="XValue"
                              YBindingPath="YValue">
                 <chart:PieSeries.SelectionBehavior>
                     <chart:DataPointSelectionBehavior SelectionBrush = "Red" />
                 </chart:PieSeries.SelectionBehavior>
             </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.SelectionBehavior = new DataPointSelectionBehavior()
        {
           SelectionBrush = new SolidColorBrush(Colors.Red),
        };
        chart.Series.Add(series);
    See Also
    SelectedIndex
    SelectionBrush
    SelectionChanging
    SelectionChanged

    Implements

    ISegmentSelectable

    See Also

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