menu

MAUI Toolkit

  • User Guide
  • Demos
  • Support
Class FastScatterSeries - MAUI-ToolKit API Reference | Syncfusion

    Show / Hide Table of Contents

    Class FastScatterSeries

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

    Inheritance
    System.Object
    ChartSeries
    CartesianSeries
    XYDataSeries
    FastScatterSeries
    Inherited Members
    CartesianSeries.ActualXAxis
    CartesianSeries.ActualYAxis
    CartesianSeries.DataLabelSettings
    CartesianSeries.DataLabelSettingsProperty
    CartesianSeries.EmptyPointMode
    CartesianSeries.EmptyPointModeProperty
    CartesianSeries.EmptyPointSettings
    CartesianSeries.EmptyPointSettingsProperty
    CartesianSeries.GetDataPoints(Double, Double, Double, Double)
    CartesianSeries.GetDataPoints(Rect)
    CartesianSeries.Label
    CartesianSeries.LabelProperty
    CartesianSeries.OnParentSet()
    CartesianSeries.ShowTrackballLabel
    CartesianSeries.ShowTrackballLabelProperty
    CartesianSeries.TrackballLabelTemplate
    CartesianSeries.TrackballLabelTemplateProperty
    CartesianSeries.XAxisName
    CartesianSeries.XAxisNameProperty
    CartesianSeries.YAxisName
    CartesianSeries.YAxisNameProperty
    ChartSeries.CreateAnimation(Action<Double>)
    ChartSeries.DrawDataLabel(ICanvas, Brush, String, PointF, Int32)
    ChartSeries.DrawSeries(ICanvas, ReadOnlyObservableCollection<ChartSegment>, RectF)
    ChartSeries.EnableAnimation
    ChartSeries.EnableAnimationProperty
    ChartSeries.EnableTooltip
    ChartSeries.EnableTooltipProperty
    ChartSeries.Fill
    ChartSeries.FillProperty
    ChartSeries.IsVisible
    ChartSeries.IsVisibleOnLegend
    ChartSeries.IsVisibleOnLegendProperty
    ChartSeries.IsVisibleProperty
    ChartSeries.ItemsSource
    ChartSeries.ItemsSourceProperty
    ChartSeries.LabelContext
    ChartSeries.LabelContextProperty
    ChartSeries.LabelTemplate
    ChartSeries.LabelTemplateProperty
    ChartSeries.LegendIcon
    ChartSeries.LegendIconProperty
    ChartSeries.ListenPropertyChange
    ChartSeries.ListenPropertyChangeProperty
    ChartSeries.Opacity
    ChartSeries.OpacityProperty
    ChartSeries.PaletteBrushes
    ChartSeries.PaletteBrushesProperty
    ChartSeries.SelectionBehavior
    ChartSeries.SelectionBehaviorProperty
    ChartSeries.ShowDataLabels
    ChartSeries.ShowDataLabelsProperty
    ChartSeries.TooltipTemplate
    ChartSeries.TooltipTemplateProperty
    ChartSeries.XBindingPath
    ChartSeries.XBindingPathProperty
    ChartSeries.XRange
    ChartSeries.YRange
    XYDataSeries.StrokeWidth
    XYDataSeries.StrokeWidthProperty
    XYDataSeries.YBindingPath
    XYDataSeries.YBindingPathProperty
    Namespace: Syncfusion.Maui.Toolkit.Charts
    Assembly: Syncfusion.Maui.Toolkit.dll
    Syntax
    public class FastScatterSeries : XYDataSeries, IDatapointSelectionDependent, ITooltipDependent, IDataTemplateDependent, IDrawCustomLegendIcon
    Remarks

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

    It provides options for Fill, StrokeWidth to customize the appearance.

    EnableTooltip - A tooltip displays information while tapping or mouse hovering above a segment. To display the tooltip on a chart, you need to set the EnableTooltip property as true in FastScatterSeries class, and also refer TooltipBehavior property.

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

    Considering performance, animation, data labels, selection, and palette brushes are currently not supported for the FastScatterSeries.

    The FastScatterSeries does not support empty points.

    Examples
    • Xaml
    • C#
    • ViewModel
        <chart:SfCartesianChart>
    
              <chart:SfCartesianChart.XAxes>
                  <chart:NumericalAxis/>
              </chart:SfCartesianChart.XAxes>
    
              <chart:SfCartesianChart.YAxes>
                  <chart:NumericalAxis/>
              </chart:SfCartesianChart.YAxes>
    
              <chart:SfCartesianChart.Series>
                  <chart:FastScatterSeries
                      ItemsSource="{Binding Data}"
                      XBindingPath="XValue"
                      YBindingPath="YValue"/>
              </chart:SfCartesianChart.Series>  
    
        </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();
    
        FastScatterSeries series = new FastScatterSeries();
        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

    FastScatterSeries()

    Initialize the constructor

    Declaration
    public FastScatterSeries()

    Fields

    PointHeightProperty

    Identifies the PointHeight bindable property.

    Declaration
    public static readonly BindableProperty PointHeightProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty
    Remarks

    The PointHeight property defines the height of the fastscatter segment size.

    PointWidthProperty

    Identifies the PointWidth bindable property.

    Declaration
    public static readonly BindableProperty PointWidthProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty
    Remarks

    The PointWidth property defines the width of the fastscatter segment size.

    StrokeProperty

    Identifies the Stroke bindable property.

    Declaration
    public static readonly BindableProperty StrokeProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty
    Remarks

    The Stroke property helps to customize the stroke appearance of the fastscatter segment.

    TypeProperty

    Identifies the Type bindable property.

    Declaration
    public static readonly BindableProperty TypeProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty
    Remarks

    The Type property indicates the shape of the fastscatter segment.

    Properties

    PointHeight

    Gets or sets a value that defines the height of the fastscatter segment size.

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

    It accepts double values and its default value is 5.

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

    PointWidth

    Gets or sets a value that defines the width of the fastscatter segment size.

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

    It accepts double values and its default value is 5.

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

    Stroke

    Gets or sets a value to customize the stroke appearance of the fastscatter segment.

    Declaration
    public Brush Stroke { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Controls.Brush

    It accepts Microsoft.Maui.Controls.Brush values and its default value is null.

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

    Type

    Gets or sets a value that indicates the shape of the fastscatter segment.

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

    It accepts ShapeType values and its default value is Circle.

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

    Methods

    CreateSegment()

    Creates and initializes a new chart segment for the chart.

    Declaration
    protected override ChartSegment CreateSegment()
    Returns
    Type
    ChartSegment
    Overrides
    ChartSeries.CreateSegment()

    GetDataPointIndex(Single, Single)

    Retrieves the index of a specific data point within a chart series, typically based on the interaction or coordinates on the chart.

    Declaration
    public override int GetDataPointIndex(float pointX, float pointY)
    Parameters
    Type Name Description
    System.Single pointX
    System.Single pointY
    Returns
    Type
    System.Int32
    Overrides
    ChartSeries.GetDataPointIndex(Single, Single)
    Back to top Generated by DocFX
    Copyright © 2001 - 2025 Syncfusion Inc. All Rights Reserved