Class ScatterSeries

The ScatterSeries displays a collection of data points represented by a circle of equal size.

Inheritance

System.Object

ScatterSeries

Implements

ISupportAxes

ISegmentSelectable

Inherited Members

XyDataSeries.YBindingPathProperty

XyDataSeries.YBindingPath

CartesianSeries.DataLabelSettingsProperty

CartesianSeries.ShowTrackballInfoProperty

CartesianSeries.XAxisNameProperty

CartesianSeries.YAxisNameProperty

CartesianSeries.OnApplyTemplate()

CartesianSeries.DataLabelSettings

CartesianSeries.XAxisName

CartesianSeries.YAxisName

CartesianSeries.ShowTrackballInfo

CartesianSeries.ISupportAxes.ActualXAxis

CartesianSeries.ISupportAxes.ActualYAxis

CartesianSeries.ISupportAxes.VisibleXRange

CartesianSeries.ISupportAxes.VisibleYRange

DataMarkerSeries.ShowDataLabelsProperty

DataMarkerSeries.ShowDataLabels

ChartSeries.SpacingProperty

ChartSeries.TooltipTemplateProperty

ChartSeries.EnableTooltipProperty

ChartSeries.ListenPropertyChangeProperty

ChartSeries.IsSeriesVisibleProperty

ChartSeries.XBindingPathProperty

ChartSeries.ItemsSourceProperty

ChartSeries.TrackballLabelTemplateProperty

ChartSeries.FillProperty

ChartSeries.LabelProperty

ChartSeries.LegendIconProperty

ChartSeries.LegendIconTemplateProperty

ChartSeries.IsVisibleOnLegendProperty

ChartSeries.EnableAnimationProperty

ChartSeries.AnimationDurationProperty

ChartSeries.PaletteBrushesProperty

ChartSeries.StrokeProperty

ChartSeries.StrokeThicknessProperty

ChartSeries.SuspendNotification()

ChartSeries.ResumeNotification()

ChartSeries.OnPointerPressed(PointerRoutedEventArgs)

ChartSeries.OnPointerMoved(PointerRoutedEventArgs)

ChartSeries.OnTapped(TappedRoutedEventArgs)

ChartSeries.OnPointerExited(PointerRoutedEventArgs)

ChartSeries.OnPointerReleased(PointerRoutedEventArgs)

ChartSeries.PaletteBrushes

ChartSeries.TooltipTemplate

ChartSeries.EnableTooltip

ChartSeries.ListenPropertyChange

ChartSeries.IsSeriesVisible

ChartSeries.ItemsSource

ChartSeries.TrackballLabelTemplate

ChartSeries.Fill

ChartSeries.Label

ChartSeries.LegendIcon

ChartSeries.LegendIconTemplate

ChartSeries.IsVisibleOnLegend

ChartSeries.XBindingPath

ChartSeries.EnableAnimation

ChartSeries.AnimationDuration

ChartSeries.StrokeThickness

ChartSeries.Chart

ChartSeries.Stroke

ChartSeries.PropertyChanged

Namespace: Syncfusion.UI.Xaml.Charts

Assembly: Syncfusion.Chart.WinUI.dll

Syntax

public class ScatterSeries : XyDataSeries, ISupportAxes, ISegmentSelectable

Remarks

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

It provides options for Fill, PaletteBrushes, StrokeThickness, Stroke, and opacity to customize the appearance.

Size - Specify the circle size using the PointHeight, and PointWidth properties.

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 ScatterSeries 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 ShowDataLabels property as true in ScatterSeries 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

    <chart:SfCartesianChart>

          <chart:SfCartesianChart.XAxes>
              <chart:NumericalAxis/>
          </chart:SfCartesianChart.XAxes>

          <chart:SfCartesianChart.YAxes>
              <chart:NumericalAxis/>
          </chart:SfCartesianChart.YAxes>

          <chart:ScatterSeries ItemsSource="{Binding Data}"
                              XBindingPath="XValue"
                              YBindingPath="YValue"
                              PointHeight = "30"
                              PointWidth = "30"/>

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

    ScatterSeries series = new ScatterSeries();
    series.ItemsSource = viewModel.Data;
    series.XBindingPath = "XValue";
    series.YBindingPath = "YValue";
    series.PointHeight = 30;
    series.PointWidth = 30;
    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

ScatterSeries()

Declaration

public ScatterSeries()

Fields

CustomTemplateProperty

The DependencyProperty for CustomTemplate property.

Declaration

public static readonly DependencyProperty CustomTemplateProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty

PointHeightProperty

The DependencyProperty for PointHeight property.

Declaration

public static readonly DependencyProperty PointHeightProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty

PointWidthProperty

The DependencyProperty for PointWidth property.

Declaration

public static readonly DependencyProperty PointWidthProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty

SelectionBehaviorProperty

The DependencyProperty for SelectionBehavior property. .

Declaration

public static readonly DependencyProperty SelectionBehaviorProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty

Properties

CustomTemplate

Gets or sets the template to customize the appearance of scatter series.

Declaration

public DataTemplate CustomTemplate { get; set; }

Property Value

Type	Description
Microsoft.UI.Xaml.DataTemplate	It accepts Microsoft.UI.Xaml.DataTemplate value.

PointHeight

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

Declaration

public double PointHeight { get; set; }

Property Value

Type	Description
System.Double	It accepts double values and its default value is 20.

    <chart:SfCartesianChart>

    <!-- ... Eliminated for simplicity-->

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

    </chart:SfCartesianChart>

    SfCartesianChart chart = new SfCartesianChart();
    ViewModel viewModel = new ViewModel();

    // Eliminated for simplicity

    ScatterSeries series = new ScatterSeries()
    {
          ItemsSource = viewModel.Data,
          XBindingPath = "XValue",
          YBindingPath = "YValue",
          PointHeight = 30,
    };

    chart.Series.Add(series);

PointWidth

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

Declaration

public double PointWidth { get; set; }

Property Value

Type	Description
System.Double	It accepts double values and its default value is 20.

Examples

Xaml
C#

    <chart:SfCartesianChart>

    <!-- ... Eliminated for simplicity-->

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

    </chart:SfCartesianChart>

    SfCartesianChart chart = new SfCartesianChart();
    ViewModel viewModel = new ViewModel();

    // Eliminated for simplicity

    ScatterSeries series = new ScatterSeries()
    {
          ItemsSource = viewModel.Data,
          XBindingPath = "XValue",
          YBindingPath = "YValue",
          PointWidth = 30,
    };

    chart.Series.Add(series);

SelectionBehavior

Gets or sets a selection behavior that enables you to select or highlight a segment in the series.

Declaration

public DataPointSelectionBehavior SelectionBehavior { get; set; }

Property Value

Type	Description
DataPointSelectionBehavior	This property takes the DataPointSelectionBehavior instance as a value, and its default value is null.

Remarks

To highlight the selected data point, set the value for SelectionBrush property in DataPointSelectionBehavior class.

Examples

Xaml
C#

    <chart:SfCartesianChart>

    <!-- ... Eliminated for simplicity-->

         <chart:ScatterSeries ItemsSource="{Binding Data}"
                          XBindingPath="XValue"
                          YBindingPath="YValue">
             <chart:ScatterSeries.SelectionBehavior>
                 <chart:DataPointSelectionBehavior SelectionBrush = "Red" />
             </chart:ScatterSeries.SelectionBehavior>
         </chart:ScatterSeries>

    </chart:SfCartesianChart>

    SfCartesianChart chart = new SfCartesianChart();
    ViewModel viewModel = new ViewModel();

    // Eliminated for simplicity

    ScatterSeries series = new ScatterSeries();
    series.ItemsSource = viewModel.Data;
    series.XBindingPath = "XValue";
    series.YBindingPath = "YValue";
    series.SelectionBehavior = new DataPointSelectionBehavior()
    {
       SelectionBrush = new SolidColorBrush(Colors.Red),
    };
    chart.Series.Add(series);

Implements

ISupportAxes

ISegmentSelectable

WinUI- v20.4.0.48

Class ScatterSeries

Inheritance

Implements

Inherited Members

Namespace: Syncfusion.UI.Xaml.Charts

Assembly: Syncfusion.Chart.WinUI.dll

Syntax

Remarks

Examples

Constructors

ScatterSeries()

Declaration

Fields

CustomTemplateProperty

Declaration

Field Value

PointHeightProperty

Declaration

Field Value

PointWidthProperty

Declaration

Field Value

SelectionBehaviorProperty

Declaration

Field Value

Properties

CustomTemplate

Declaration

Property Value

PointHeight

Declaration

Property Value

Examples

PointWidth

Declaration

Property Value

Examples

SelectionBehavior

Declaration

Property Value

Remarks

Examples

See Also

Implements

See Also