Class FastColumnBitmapSeries

Represents a special kind of column series which uses writeablebitmap for rendering chart points. FastColumnBitmapSeries allows to render a collection with large number of data points.

Inheritance
System.Object
ChartSeriesBase
ChartSeries
AdornmentSeries
CartesianSeries
XyDataSeries
FastColumnBitmapSeries
Inherited Members
Namespace: Syncfusion.UI.Xaml.Charts
Assembly: Syncfusion.SfChart.WPF.dll
Syntax
public class FastColumnBitmapSeries : XyDataSeries, ICloneable, ISupportAxes2D, ISupportAxes, ISegmentSpacing, ISegmentSelectable
Remarks

FastColumnBitmapSeries renders large quantity of data in fraction of milliseconds using writeablebitmap.

Examples
    <chart:SfChart>

          <chart:SfChart.PrimaryAxis>
              <chart:NumericalAxis/>
          </chart:SfChart.PrimaryAxis>

          <chart:SfChart.SecondaryAxis>
              <chart:NumericalAxis/>
          </chart:SfChart.SecondaryAxis>

          <chart:FastColumnBitmapSeries
              ItemsSource="{Binding Data}"
              XBindingPath="XValue"
              YBindingPath="YValue"/>

    </chart:SfChart>

Constructors

FastColumnBitmapSeries()

Declaration
public FastColumnBitmapSeries()

Fields

SegmentSelectionBrushProperty

The DependencyProperty for SegmentSelectionBrush property.

Declaration
public static readonly DependencyProperty SegmentSelectionBrushProperty
Field Value
Type
System.Windows.DependencyProperty

SegmentSpacingProperty

Identifies the SegmentSpacing dependency property.

Declaration
public static readonly DependencyProperty SegmentSpacingProperty
Field Value
Type Description
System.Windows.DependencyProperty

The identifier for SegmentSpacing dependency property.

SelectedIndexProperty

The DependencyProperty for SelectedIndex property.

Declaration
public static readonly DependencyProperty SelectedIndexProperty
Field Value
Type
System.Windows.DependencyProperty

Properties

IsBitmapSeries

Gets whether this series is a bitmap series or not.

Declaration
protected override bool IsBitmapSeries { get; }
Property Value
Type Description
System.Boolean

Returns the bool value.
Overrides

IsSideBySide

Gets a value indicating whether this series is placed side by side.

Declaration
protected override bool IsSideBySide { get; }
Property Value
Type Description
System.Boolean

It returns true, if the series is placed side by side [cluster mode].
Overrides

SegmentSelectionBrush

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

Declaration
public Brush SegmentSelectionBrush { get; set; }
Property Value
Type Description
System.Windows.Media.Brush

The System.Windows.Media.Brush value.
See Also

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

Default value is 0 and its 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.
See Also

SelectedSegments

Gets the selected segments in this series, when we enable the multiple selection.

Declaration
protected override List<ChartSegment> SelectedSegments { get; }
Property Value
Type Description
System.Collections.Generic.List<ChartSegment>

It returns list of ChartSegment.
Overrides

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

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.

CloneSeries(DependencyObject)

Returns the instance of FastColumnBitmapSeries series.

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

object
Returns
Type
System.Windows.DependencyObject
Overrides

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()

Used to create the segment of FastColumnBitmapSeries.

Declaration
public override void CreateSegments()
Overrides

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

ItemsSource old value.
System.Collections.IEnumerable newValue

ItemsSource new value
Overrides
See Also

OnMouseMove(MouseEventArgs)

Called when pointer or mouse moves on chart area.

Declaration
protected override void OnMouseMove(MouseEventArgs e)
Parameters
Type Name Description
System.Windows.Input.MouseEventArgs e

Event args that contains the event data.
Overrides

SelectedIndexChanged(Int32, Int32)

Method used to set SegmentSelectionBrush to SelectedIndex segment.

Declaration
protected override void SelectedIndexChanged(int newIndex, int oldIndex)
Parameters
Type Name Description
System.Int32 newIndex

new index
System.Int32 oldIndex

old index
Overrides

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

See Also