menu

WinUI

  • Code Examples
  • Upgrade Guide
  • User Guide
  • Demos
  • Support
  • Forums
  • Download
Class FastScatterBitmapSeries - WinUI API Reference | Syncfusion

    Show / Hide Table of Contents

    Class FastScatterBitmapSeries

    The FastScatterBitmapSeries is a special kind of scatter series that can render a collection with large number of data points.

    Inheritance
    System.Object
    ChartSeries
    CartesianSeries
    XyDataSeries
    FastScatterBitmapSeries
    Implements
    System.ComponentModel.INotifyPropertyChanged
    Inherited Members
    CartesianSeries.DataLabelSettings
    CartesianSeries.DataLabelSettingsProperty
    CartesianSeries.OnApplyTemplate()
    CartesianSeries.ShowTrackballLabel
    CartesianSeries.ShowTrackballLabelProperty
    CartesianSeries.XAxisName
    CartesianSeries.XAxisNameProperty
    CartesianSeries.YAxisName
    CartesianSeries.YAxisNameProperty
    ChartSeries.ActualXAxis
    ChartSeries.ActualYAxis
    ChartSeries.AnimationDuration
    ChartSeries.AnimationDurationProperty
    ChartSeries.Chart
    ChartSeries.EnableAnimation
    ChartSeries.EnableAnimationProperty
    ChartSeries.EnableTooltip
    ChartSeries.EnableTooltipProperty
    ChartSeries.Fill
    ChartSeries.FillProperty
    ChartSeries.IsSeriesVisible
    ChartSeries.IsSeriesVisibleProperty
    ChartSeries.IsVisibleOnLegend
    ChartSeries.IsVisibleOnLegendProperty
    ChartSeries.ItemsSource
    ChartSeries.ItemsSourceProperty
    ChartSeries.Label
    ChartSeries.LabelProperty
    ChartSeries.LegendIcon
    ChartSeries.LegendIconProperty
    ChartSeries.LegendIconTemplate
    ChartSeries.LegendIconTemplateProperty
    ChartSeries.ListenPropertyChange
    ChartSeries.ListenPropertyChangeProperty
    ChartSeries.OnPointerExited(PointerRoutedEventArgs)
    ChartSeries.OnPointerPressed(PointerRoutedEventArgs)
    ChartSeries.OnPointerReleased(PointerRoutedEventArgs)
    ChartSeries.OnTapped(TappedRoutedEventArgs)
    ChartSeries.PaletteBrushes
    ChartSeries.PaletteBrushesProperty
    ChartSeries.PropertyChanged
    ChartSeries.ResumeNotification()
    ChartSeries.SelectionBehavior
    ChartSeries.SelectionBehaviorProperty
    ChartSeries.ShowDataLabels
    ChartSeries.ShowDataLabelsProperty
    ChartSeries.SpacingProperty
    ChartSeries.SuspendNotification()
    ChartSeries.TooltipTemplate
    ChartSeries.TooltipTemplateProperty
    ChartSeries.TrackballLabelTemplate
    ChartSeries.TrackballLabelTemplateProperty
    ChartSeries.XBindingPath
    ChartSeries.XBindingPathProperty
    XyDataSeries.StrokeWidth
    XyDataSeries.StrokeWidthProperty
    XyDataSeries.YBindingPath
    XyDataSeries.YBindingPathProperty
    Namespace: Syncfusion.UI.Xaml.Charts
    Assembly: Syncfusion.Chart.WinUI.dll
    Syntax
    public class FastScatterBitmapSeries : XyDataSeries, INotifyPropertyChanged
    Remarks

    To render a series, create an instance of FastScatterBitmapSeries 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 FastScatterBitmapSeries 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 FastScatterBitmapSeries 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.

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

    FastScatterBitmapSeries()

    Declaration
    public FastScatterBitmapSeries()

    Fields

    PointHeightProperty

    Identifies the PointHeight dependency property.

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

    The identifier for PointHeight dependency property.

    PointWidthProperty

    Identifies the PointWidth dependency property.

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

    The identifier for PointWidth dependency property.

    StrokeProperty

    The DependencyProperty for Stroke property.

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

    TypeProperty

    Identifies the Type dependency property.

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

    The identifier for Type dependency property.

    Properties

    PointHeight

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

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

    It accepts double value and the default value is 3.

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

    PointWidth

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

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

    It accepts double value and the default value is 3.

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

    Stroke

    Gets or sets a value to customize the stroke appearance of a chart series.

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

    It accepts Microsoft.UI.Xaml.Media.Brush values and its default value is null.

    Examples
    • Xaml
    • C#
        <chart:SfCartesianChart>
    
        <!-- ... Eliminated for simplicity-->
    
             <chart:ColumnSeries ItemsSource="{Binding Data}"
                               XBindingPath="XValue"
                               YBindingPath="YValue"
                               Stroke = "Red"
                               StrokeWidth = "3"/>
    
        </chart:SfCartesianChart>
        SfCartesianChart chart = new SfCartesianChart();
        ViewModel viewModel = new ViewModel();
    
        // Eliminated for simplicity
    
        ColumnSeries columnSeries = new ColumnSeries()
        {
              ItemsSource = viewModel.Data,
              XBindingPath = "XValue",
              YBindingPath = "YValue",
              Stroke = new SolidColorBrush(Colors.Red),
              StrokeWidth= 3,
        };
    
        chart.Series.Add(columnSeries);

    Type

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

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

    This property accepts ShapeType values, and the default shape type is ellipse.

    Remarks

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

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

    Methods

    OnPointerMoved(PointerRoutedEventArgs)

    Declaration
    protected override void OnPointerMoved(PointerRoutedEventArgs e)
    Parameters
    Type Name Description
    Microsoft.UI.Xaml.Input.PointerRoutedEventArgs e
    Overrides
    ChartSeries.OnPointerMoved(PointerRoutedEventArgs)

    Implements

    System.ComponentModel.INotifyPropertyChanged

    See Also

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