Class ColumnSeries

ColumnSeries displays its data points using a set of vertical bars. Its height is proportional to the data points being plotted.

Inheritance
System.Object
ChartSeriesBase
ChartSeries
DataMarkerSeries
CartesianSeries
XyDataSeries
XySegmentDraggingBase
ColumnSeries
Inherited Members
Namespace: Syncfusion.UI.Xaml.Charts
Assembly: Syncfusion.Chart.WinUI.dll
Syntax
public class ColumnSeries : XySegmentDraggingBase, ISupportAxes2D, ISupportAxes, ISegmentSelectable, ISegmentSpacing
Examples
      <syncfusion:ColumnSeries ItemsSource="{Binding Data}" XBindingPath="Year" YBindingPath="Value">
      </syncfusion:ColumnSeries>
      ColumnSeries series1 = new ColumnSeries();
      series1.ItemsSource = viewmodel.Data;
      series1.XBindingPath = "Year";
      series1.YBindingPath = "Value";
      chart.Series.Add(series1);

Constructors

ColumnSeries()

Declaration
public ColumnSeries()

Fields

CustomTemplateProperty

The DependencyProperty for CustomTemplate property.

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

SegmentSpacingProperty

The DependencyProperty for SegmentSpacing property.

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

SelectedIndexProperty

The DependencyProperty for SelectedIndex property.

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

SelectionBrushProperty

The DependencyProperty for SelectionBrush property.

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

Properties

CustomTemplate

Gets or sets the custom template for this series.

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

Microsoft.UI.Xaml.DataTemplate
Examples

This example, we are using ScatterSeries.

    <syncfusion:ScatterSeries ItemsSource="{Binding Demands}" XBindingPath="Demand" YBindingPath="Year2010" 
                   ScatterHeight="40" ScatterWidth="40">
       <syncfusion:ScatterSeries.CustomTemplate>
            <DataTemplate>
                <Canvas>
                   <Path Data="M20.125,32l0.5,12.375L10.3125,12.375L10.3125,0.5L29.9375,0.5L29.9375,12.375L39.75,12.375Z" 
                    Stretch="Fill" Fill="{Binding Interior}" Height="{Binding ScatterHeight}" Width="{Binding ScatterWidth}" 
                    Canvas.Left="{Binding RectX}" Canvas.Top="{Binding RectY}"/>
                </Canvas>
            </DataTemplate>
        </syncfusion:ScatterSeries.CustomTemplate>
    </syncfusion:ScatterSeries>

SegmentSpacing

Gets or sets the spacing between the segments across the series in cluster mode.

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

The value ranges from 0 to 1.

SelectedIndex

Gets or sets the index of the selected segment.

Declaration
public int SelectedIndex { get; set; }
Property Value
Type Description
System.Int32

Int value represents the index of the data point(or segment) to be selected and its default value is -1.

SelectionBrush

Gets or sets the interior (brush) for the selected segment(s).

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

The Microsoft.UI.Xaml.Media.Brush value.

Methods

CalculateSegmentSpacing(Double, Double, Double)

Method used to calculate the segment spacing.

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

Spacing
System.Double Right

Right
System.Double Left

Left
Returns
Type Description
System.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
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 segments of ColumnSeries.

Declaration
public override void CreateSegments()
Overrides

OnChartDragDelta(Point, Object)

Called when dragging series.

Declaration
protected override void OnChartDragDelta(Point mousePos, object originalSource)
Parameters
Type Name Description
Windows.Foundation.Point mousePos

mouse position
System.Object originalSource

original source
Overrides

OnChartDragEnd(Point, Object)

Called when dragging end.

Declaration
protected override void OnChartDragEnd(Point mousePos, object originalSource)
Parameters
Type Name Description
Windows.Foundation.Point mousePos

mouse position
System.Object originalSource

original source
Overrides

OnChartDragEntered(Point, Object)

Called when dragging entered.

Declaration
protected override void OnChartDragEntered(Point mousePos, object originalSource)
Parameters
Type Name Description
Windows.Foundation.Point mousePos

mouse position
System.Object originalSource

original source
Overrides

OnChartDragStart(Point, Object)

Called when dragging started.

Declaration
protected override void OnChartDragStart(Point mousePos, object originalSource)
Parameters
Type Name Description
Windows.Foundation.Point mousePos

mouse position
System.Object originalSource

original source
Overrides

ResetDraggingElements(String, Boolean)

Resets the dragging elements.

Declaration
protected override void ResetDraggingElements(string reason, bool dragEndEvent)
Parameters
Type Name Description
System.String reason

The reason.
System.Boolean dragEndEvent

if set to true, DragEndEvent will raise .
Overrides

Explicit Interface Implementations

ISegmentSpacing.CalculateSegmentSpacing(Double, Double, Double)

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

Implements

See Also

Syncfusion.UI.Xaml.Charts.RangeColumnSeries