Class StackedColumnSeries

    Show / Hide Table of Contents

    Class StackedColumnSeries

    The StackedColumnSeries is a special kind of column series which is similar to the regular column series except that the Y-values stack on top of each other.

    Inheritance
    System.Object
    ChartSeries
    CartesianSeries
    XyDataSeries
    StackedSeriesBase
    StackedColumnSeries
    StackedColumn100Series
    Implements
    ISegmentSpacing
    Inherited Members
    StackedSeriesBase.GroupNameProperty
    StackedSeriesBase.GroupName
    XyDataSeries.YBindingPathProperty
    XyDataSeries.StrokeWidthProperty
    XyDataSeries.YBindingPath
    XyDataSeries.StrokeWidth
    CartesianSeries.DataLabelSettingsProperty
    CartesianSeries.ShowTrackballLabelProperty
    CartesianSeries.XAxisNameProperty
    CartesianSeries.YAxisNameProperty
    CartesianSeries.OnApplyTemplate()
    CartesianSeries.DataLabelSettings
    CartesianSeries.XAxisName
    CartesianSeries.YAxisName
    CartesianSeries.ShowTrackballLabel
    ChartSeries.SelectionBehaviorProperty
    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.ShowDataLabelsProperty
    ChartSeries.SuspendNotification()
    ChartSeries.ResumeNotification()
    ChartSeries.OnPointerPressed(PointerRoutedEventArgs)
    ChartSeries.OnPointerMoved(PointerRoutedEventArgs)
    ChartSeries.OnTapped(TappedRoutedEventArgs)
    ChartSeries.OnPointerExited(PointerRoutedEventArgs)
    ChartSeries.OnPointerReleased(PointerRoutedEventArgs)
    ChartSeries.SelectionBehavior
    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.Chart
    ChartSeries.ShowDataLabels
    ChartSeries.PropertyChanged
    Namespace: Syncfusion.UI.Xaml.Charts
    Assembly: Syncfusion.Chart.WinUI.dll
    Syntax
    public class StackedColumnSeries : StackedSeriesBase, ISegmentSpacing
    Remarks

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

    It provides options for Fill, PaletteBrushes, Stroke, , and opacity to customize the appearance.

    EnableTooltip - A tooltip displays information while tapping or mouse hovering over a segment. To display the tooltip on chart, need to set the EnableTooltip property as true in StackedColumnSeries class, and also refer 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 property as true in StackedColumnSeries class. To customize the chart data labels alignment, placement, and label styles, you need to create an instance of CartesianDataLabelSettings and set to the DataLabelSettings property.

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

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

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

    Examples
    • Xaml
    • C#
    • ViewModel
        <chart:SfCartesianChart>
    
              <chart:SfCartesianChart.XAxes>
                  <chart:NumericalAxis/>
              </chart:SfCartesianChart.XAxes>
    
              <chart:SfCartesianChart.YAxes>
                  <chart:NumericalAxis/>
              </chart:SfCartesianChart.YAxes>
    
              <chart:StackedColumnSeries ItemsSource="{Binding Data}"
                                         XBindingPath="XValue"
                                         YBindingPath="YValue"/>
    
              <chart:StackedColumnSeries ItemsSource="{Binding Data}"
                                         XBindingPath="XValue"
                                         YBindingPath="YValue1"/>
    
        </chart:SfCartesianChart>
        SfCartesianChart chart = new SfCartesianChart();
    
        NumericalAxis xAxis = new NumericalAxis();
        NumericalAxis yAxis = new NumericalAxis();
    
        chart.XAxes.Add(xAxis);
        chart.YAxes.Add(yAxis);
    
        ViewModel viewModel = new ViewModel();
    
        StackedColumnSeries series = new StackedColumnSeries();
        series.ItemsSource = viewModel.Data;
        series.XBindingPath = "XValue";
        series.YBindingPath = "YValue";
        chart.Series.Add(series);
    
        StackedColumnSeries series1 = new StackedColumnSeries();
        series1.ItemsSource = viewModel.Data;
        series1.XBindingPath = "XValue";
        series1.YBindingPath = "YValue1";
        chart.Series.Add(series1); 
        public ObservableCollection<Model> Data { get; set; }
    
        public ViewModel()
        {
           Data = new ObservableCollection<Model>();
           Data.Add(new Model() { XValue = 10, YValue = 100, YValue1 = 110 });
           Data.Add(new Model() { XValue = 20, YValue = 150, YValue1 = 100 });
           Data.Add(new Model() { XValue = 30, YValue = 110, YValue1 = 130 });
           Data.Add(new Model() { XValue = 40, YValue = 230, YValue1 = 180 });
        }

    Constructors

    StackedColumnSeries()

    Declaration
    public StackedColumnSeries()

    Fields

    CustomTemplateProperty

    Identifies the CustomTemplate dependency property.

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

    The identifier for CustomTemplate dependency property.

    SegmentSpacingProperty

    Identifies the SegmentSpacing dependency property.

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

    The identifier for SegmentSpacing dependency property.

    StrokeProperty

    The DependencyProperty for Stroke property.

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

    Properties

    CustomTemplate

    Gets or sets the DataTemplate that can be used to customize the appearence of coulum shape.

    Declaration
    public DataTemplate CustomTemplate { get; set; }
    Property Value
    Type Description
    Microsoft.UI.Xaml.DataTemplate

    The template that specifies the shape inside the canvas. The default is null.

    Examples
    • Xaml
        <chart:SfCartesianChart>
    
             <!-- ... Eliminated for simplicity-->
             <chart:StackedColumnSeries ItemsSource="{Binding Data}"
                                        XBindingPath="XValue"
                                        YBindingPath="YValue">
                 <chart:StackedColumnSeries.CustomTemplate>
                     <DataTemplate>
                         <Canvas>
                             <Rectangle Fill = "{Binding Fill}" Width="{Binding Width}" Height="{Binding Height}"  
                                        Canvas.Left="{Binding RectX}" Canvas.Top="{Binding RectY}" Stroke="{Binding Stroke}"/>
                         </Canvas>
                     </DataTemplate>
                 </chart:StackedColumnSeries.CustomTemplate>
             </chart:StackedColumnSeries>
    
        </chart:SfCartesianChart>

    SegmentSpacing

    Gets or sets a value that can be used to change the spacing between two segments.

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

    It accepts double values and the default value is 0. Here, the value ranges from 0 to 1.

    Examples
    • Xaml
    • C#
        <chart:SfCartesianChart>
    
        <!-- ... Eliminated for simplicity-->
    
             <chart:StackedColumnSeries ItemsSource="{Binding Data}"
                                        XBindingPath="XValue"
                                        YBindingPath="YValue"
                                        SegmentSpacing = "0.3"/>
    
        </chart:SfCartesianChart>
        SfCartesianChart chart = new SfCartesianChart();
        ViewModel viewModel = new ViewModel();
    
        // Eliminated for simplicity
    
        StackedColumnSeries series = new StackedColumnSeries()
        {
              ItemsSource = viewModel.Data,
              XBindingPath = "XValue",
              YBindingPath = "YValue",
              SegmentSpacing = 0.3,
        };
    
        chart.Series.Add(series);

    Stroke

    Declaration
    public Brush Stroke { get; set; }
    Property Value
    Type Description
    Microsoft.UI.Xaml.Media.Brush

    Explicit Interface Implementations

    ISegmentSpacing.CalculateSegmentSpacing(Double, Double, Double)

    Method used to calculate the segment spacing.

    Declaration
    double ISegmentSpacing.CalculateSegmentSpacing(double spacing, double Right, double Left)
    Parameters
    Type Name Description
    System.Double spacing

    Segment spacing value.

    System.Double Right

    Segment right value.

    System.Double Left

    Segment left value.

    Returns
    Type Description
    System.Double

    Returns the calculated segment space.

    Implements

    ISegmentSpacing

    See Also

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