Class FastScatterBitmapSeries

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

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

FastScatterBitmapSeries 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:FastScatterBitmapSeries
              ItemsSource="{Binding Data}"
              XBindingPath="XValue"
              YBindingPath="YValue"/>

    </chart:SfChart>

Constructors

FastScatterBitmapSeries()

Declaration
public FastScatterBitmapSeries()

Fields

ScatterHeightProperty

Identifies the ScatterHeight dependency property.

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

The identifier for ScatterHeight dependency property.

ScatterWidthProperty

Identifies the ScatterWidth dependency property.

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

The identifier for ScatterWidth dependency property.

SegmentSelectionBrushProperty

The DependencyProperty for SegmentSelectionBrush property.

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

SelectedIndexProperty

The DependencyProperty for SelectedIndex property.

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

ShapeTypeProperty

Identifies the ShapeType dependency property.

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

The identifier for ShapeType dependency property.

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

ScatterHeight

Gets or sets a value that specifies the height of the FastScatterBitmap segment.

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

The default value is 3.

ScatterWidth

Gets or sets a value that specifies the width of the FastScatterBitmap segment.

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

The default value is 3.

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

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 the list of ChartSegment.
Overrides

ShapeType

Gets or sets different types of shapes in a fast scatter bitmap series.

Declaration
public ChartSymbol ShapeType { get; set; }
Property Value
Type Description
ChartSymbol

This property takes fast scatter shape value, and its default shape type is ellipse.
Remarks

Fast scatter bitmap series does not support Custom, HorizontalLine and VerticalLine shapes. By using the above shapes for fast scatter bitmap series, you can render only the default type, which is ellipse.

Methods

CloneSeries(DependencyObject)

Returns the instance of FastScatterBitmapSeries 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 FastScatterBitmapSeries.

Declaration
public override void CreateSegments()
Overrides

OnMouseMove(MouseEventArgs)

Called when pointer or mouse move 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

OnVisibleRangeChanged(VisibleRangeChangedEventArgs)

Invoked when VisibleRange property changed.

Declaration
protected override void OnVisibleRangeChanged(VisibleRangeChangedEventArgs e)
Parameters
Type Name Description
VisibleRangeChangedEventArgs e

VisibleRangeChangedEventArgs 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

Implements

See Also