Back to all docs
API Reference / Telerik.WinControls.UI / ScatterSeries
New to Telerik UI for WinForms? Start a free 30-day trial

ScatterSeries

Class

Represents a scatter chart series that displays data points as individual markers positioned by two numeric values.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.ChartView.dll

Syntax:
C#
public class ScatterSeries : CartesianPointSeries, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, IStylableElement, IStylableNode, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IShapedElement, IChartSeries, IChartElementPresenter, IAxisProvider

Inheritance: objectDisposableObjectRadObjectUIChartElementChartSeriesCartesianSeriesCartesianPointSeriesScatterSeries...

Derived Classes: BubbleSeriesScatterLineSeries

Implements: IAxisProviderIBorderElementIBoxElementIBoxStyleIChartElementPresenterIChartSeriesICustomTypeDescriptorIDisposableIFillElementINotifyPropertyChangedIShapedElementIStylableElementIStylableNode...

Inherited Members CartesianPointSeries.LabelDistanceToPointPropertyCartesianPointSeries.LabelAnglePropertyCartesianPointSeries.LabelAngleCartesianPointSeries.LabelDistanceToPointCartesianSeries.CombineModePropertyCartesianSeries.LegendTitlePropertyCartesianSeries.IsVisibleInLegendPropertyCartesianSeries.OnAttached(UIChartElement)CartesianSeries.OnDettached()CartesianSeries.GetColorForMultiAxis()CartesianSeries.OnPropertyChanged(RadPropertyChangedEventArgs)CartesianSeries.OnNotifyPropertyChanged(PropertyChangedEventArgs)CartesianSeries.LegendTitleCartesianSeries.IsVisibleInLegendCartesianSeries.HorizontalAxisCartesianSeries.VerticalAxisCartesianSeries.StackGroupKeyCartesianSeries.ValueMemberCartesianSeries.CategoryMemberCartesianSeries.CombineModeCartesianSeries.AxesCartesianSeries.ClipLabelsChartSeries.PointSizePropertyChartSeries.LabelFormatPropertyChartSeries.DrawLinesToLabelsPropertyChartSeries.SyncLinesToLabelsColorPropertyChartSeries.LinesToLabelsColorPropertyChartSeries.LabelRotationAnglePropertyChartSeries.OnDataPointIsSelectedChanged(DataPoint)ChartSeries.EnsureVisualState(ChartArea)ChartSeries.ApplyStyleSettingsCore(PropertySettingGroup)ChartSeries.Refresh()ChartSeries.DisposeManagedResources()ChartSeries.CreateDataPointElementCollection()ChartSeries.CreateDataPoint()ChartSeries.CreateDataPointElement(DataPoint)ChartSeries.OnApplyPalette()ChartSeries.GetElement(Point)ChartSeries.GetStyleIndex()ChartSeries.HitTest(int, int)ChartSeries.OnCreatePoint(ChartViewCreatePointEventArgs)ChartSeries.OnTrackballPointTextNeeded(TrackballPointTextNeededEventArgs)ChartSeries.SelectedStyleChartSeries.LabelFormatChartSeries.ShowLabelsChartSeries.LabelFormatProviderChartSeries.PointSizeChartSeries.DrawLinesToLabelsChartSeries.SyncLinesToLabelsColorChartSeries.LinesToLabelsColorChartSeries.DataPointsChartSeries.DataSourceChartSeries.DataMemberChartSeries.DisplayMemberChartSeries.FamilyChartSeries.NameChartSeries.BoundsChartSeries.IsVisibleChartSeries.PaletteChartSeries.LabelRotationAngleChartSeries.TrackballFormatStringChartSeries.CreatePointChartSeries.TrackballPointTextNeededUIChartElement.IsVisiblePropertyUIChartElement.ClassPropertyUIChartElement.VisualStatePropertyUIChartElement.IsMouseDownPropertyUIChartElement.IsMouseOverPropertyUIChartElement.FontPropertyUIChartElement.CustomFontPropertyUIChartElement.CustomFontSizePropertyUIChartElement.CustomFontStylePropertyUIChartElement.ForeColorPropertyUIChartElement.BackColorPropertyUIChartElement.BackColor2PropertyUIChartElement.BackColor3PropertyUIChartElement.BackColor4PropertyUIChartElement.NumberOfColorsPropertyUIChartElement.GradientStylePropertyUIChartElement.GradientAnglePropertyUIChartElement.GradientPercentagePropertyUIChartElement.GradientPercentage2PropertyUIChartElement.BorderBoxStylePropertyUIChartElement.BorderDrawModePropertyUIChartElement.BorderWidthPropertyUIChartElement.BorderLeftWidthPropertyUIChartElement.BorderRightWidthPropertyUIChartElement.BorderTopWidthPropertyUIChartElement.BorderBottomWidthPropertyUIChartElement.BorderGradientAnglePropertyUIChartElement.BorderGradientStylePropertyUIChartElement.BorderColorPropertyUIChartElement.BorderColor2PropertyUIChartElement.BorderColor3PropertyUIChartElement.BorderColor4PropertyUIChartElement.BorderInnerColorPropertyUIChartElement.BorderInnerColor2PropertyUIChartElement.BorderInnerColor3PropertyUIChartElement.BorderInnerColor4PropertyUIChartElement.BorderLeftColorPropertyUIChartElement.BorderTopColorPropertyUIChartElement.BorderRightColorPropertyUIChartElement.BorderBottomColorPropertyUIChartElement.BorderLeftShadowColorPropertyUIChartElement.BorderTopShadowColorPropertyUIChartElement.BorderRightShadowColorPropertyUIChartElement.BorderBottomShadowColorPropertyUIChartElement.BackgroundShapePropertyUIChartElement.BorderDashStylePropertyUIChartElement.BorderDashPatternPropertyUIChartElement.BorderCornerRadiusPropertyUIChartElement.ShapePropertyUIChartElement.PaddingPropertyUIChartElement.SmoothingModePropertyUIChartElement.GetValue(RadProperty)UIChartElement.Attach(UIChartElement)UIChartElement.Dettach()UIChartElement.Invalidate()UIChartElement.MeasureContentOverride(ChartNode, object)UIChartElement.DpiScaleChanged(SizeF)UIChartElement.GetScaledFont(float)UIChartElement.GetCurrentShape()UIChartElement.GetThemeEffectiveType()UIChartElement.ApplyStyle()UIChartElement.BuildVisualState()UIChartElement.AddStylePropertySetting(IPropertySetting)UIChartElement.ApplyStyleByIndex(PropertySettingGroup, int)UIChartElement.ParentUIChartElement.LevelUIChartElement.ChildrenUIChartElement.IsMouseDownUIChartElement.IsMouseOverUIChartElement.ViewUIChartElement.ForeColorUIChartElement.FontUIChartElement.BackColorUIChartElement.BackColor2UIChartElement.BackColor3UIChartElement.BackColor4UIChartElement.GradientStyleUIChartElement.GradientAngleUIChartElement.GradientPercentageUIChartElement.GradientPercentage2UIChartElement.NumberOfColorsUIChartElement.BorderLeftColorUIChartElement.BorderTopColorUIChartElement.BorderRightColorUIChartElement.BorderBottomColorUIChartElement.BorderLeftShadowColorUIChartElement.BorderTopShadowColorUIChartElement.BorderRightShadowColorUIChartElement.BorderBottomShadowColorUIChartElement.BorderBoxStyleUIChartElement.BorderDrawModeUIChartElement.BorderWidthUIChartElement.BorderLeftWidthUIChartElement.BorderTopWidthUIChartElement.BorderRightWidthUIChartElement.BorderBottomWidthUIChartElement.BorderGradientAngleUIChartElement.BorderGradientStyleUIChartElement.BorderColorUIChartElement.BorderColor2UIChartElement.BorderColor3UIChartElement.BorderColor4UIChartElement.BorderInnerColorUIChartElement.BorderInnerColor2UIChartElement.BorderInnerColor3UIChartElement.BorderInnerColor4UIChartElement.BorderDashStyleUIChartElement.BorderDashPatternUIChartElement.BorderCornerRadiusUIChartElement.SizeUIChartElement.ShapeUIChartElement.BackgroundShapeUIChartElement.PaddingUIChartElement.SmoothingModeUIChartElement.IsAttachedUIChartElement.DpiScaleFactorUIChartElement.ClassUIChartElement.VisualStateUIChartElement.ThemeRoleUIChartElement.ChildrenHierarchyUIChartElement.StyleUIChartElement.StateManagerUIChartElement.FallbackToDefaultThemeRadObject.BindingContextPropertyRadObject.RadTypeRadObject.ReplaceDefaultDescriptors(PropertyDescriptorCollection)RadObject.ClearPropertyStore()RadObject.SuspendPropertyNotifications()RadObject.ResumePropertyNotifications()RadObject.GetPropertyValue(RadProperty)RadObject.SetDefaultValueOverride(RadProperty, object)RadObject.SetValue(RadProperty, object)RadObject.ResetValue(RadProperty)RadObject.ResetLocalValue(RadProperty)RadObject.ResetValue(RadProperty, ValueResetFlags)RadObject.UpdateValue(RadProperty)RadObject.GetValueSource(RadProperty)RadObject.GetRegisteredRadProperty(string)RadObject.UpdateValueCore(RadPropertyValue)RadObject.SetValueCore(RadPropertyValue, object, object, ValueSource)RadObject.ResetValueCore(RadPropertyValue, ValueResetFlags)RadObject.GetDefaultValue(RadPropertyValue, object)RadObject.CoerceValue(RadPropertyValue, object)RadObject.ShouldSerializeProperty(RadProperty)RadObject.CanRaisePropertyChangeNotifications(RadPropertyValue)RadObject.BindProperty(RadProperty, RadObject, RadProperty, PropertyBindingOptions)RadObject.UnbindProperty(RadProperty)RadObject.GetInheritedValue(RadProperty)RadObject.OnPropertyChanging(RadPropertyChangingEventArgs)RadObject.OnNotifyPropertyChanged(string)RadObject.OnShouldSerializeProperty(ShouldSerializePropertyEventArgs)RadObject.IsPropertyCancelable(RadPropertyMetadata)RadObject.PropertyValuesRadObject.PropertyFilterRadObject.RadObjectTypeRadObject.BindingContextRadObject.PropertyChangedRadObject.RadPropertyChangedRadObject.RadPropertyChangingDisposableObject.GetBitState(long)DisposableObject.SetBitState(long, bool)DisposableObject.OnBitStateChanged(long, bool, bool)DisposableObject.Dispose()DisposableObject.Dispose(bool)DisposableObject.PerformDispose(bool)DisposableObject.DisposeUnmanagedResources()DisposableObject.BitStateDisposableObject.EventsDisposableObject.IsDisposingDisposableObject.IsDisposedDisposableObject.DisposedDisposableObject.Disposing...

Constructors

ScatterSeries()

Initializes a new instance of the ScatterSeries class.

C#
public ScatterSeries()

ScatterSeries(SizeF)

Initializes a new instance of the ScatterSeries class with the specified point size.

C#
public ScatterSeries(SizeF pointSize)
Parameters:pointSizeSizeF

The size of the data point markers.

ScatterSeries(string, string)

Initializes a new instance of the ScatterSeries class with the specified X and Y value members.

C#
public ScatterSeries(string xValueMember, string yValueMember)
Parameters:xValueMemberstring

The name of the property that contains the X coordinate values.

yValueMemberstring

The name of the property that contains the Y coordinate values.

Properties

Model

Gets the data model that represents the scatter series structure and behavior.

C#
public override ChartSeriesModel Model { get; }

Overrides: ChartSeries.Model

XValueMember

Gets or sets the name of the data source property that provides X coordinate values for the scatter points.

C#
[Browsable(true)]
public string XValueMember { get; set; }

YValueMember

Gets or sets the name of the data source property that provides Y coordinate values for the scatter points.

C#
[Browsable(true)]
public string YValueMember { get; set; }

Methods

BindMembers()

Binds the X and Y data members to the appropriate data point properties.

C#
protected override void BindMembers()

Overrides: CartesianSeries.BindMembers()

CreateDefaultDataPoint()

Creates a default scatter data point for the series.

C#
protected override DataPoint CreateDefaultDataPoint()
Returns:

DataPoint

A new DataPoint instance suitable for scatter charts.

Overrides: CartesianSeries.CreateDefaultDataPoint()

CreateModel()

Creates the data model for the scatter series and initializes the data point collection.

C#
protected override ChartDataPointCollection CreateModel()
Returns:

ChartDataPointCollection

A ChartDataPointCollection containing the scatter data points.

Overrides: ChartSeries.CreateModel()

CreatePointElement(DataPoint)

Creates a visual element for the specified scatter data point.

C#
protected override DataPointElement CreatePointElement(DataPoint point)
Parameters:pointDataPoint

The data point for which to create the visual element.

Returns:

DataPointElement

A DataPointElement representing the scatter point marker.

Overrides: ChartSeries.CreatePointElement(DataPoint)

GetDefaultTrackballTextForPoint(DataPoint)

Gets the default trackball text for the specified scatter data point.

C#
protected override string GetDefaultTrackballTextForPoint(DataPoint point)
Parameters:pointDataPoint

The data point for which to generate trackball text.

Returns:

string

A string containing the formatted X and Y coordinate values.

Overrides: ChartSeries.GetDefaultTrackballTextForPoint(DataPoint)

ValidatePoint(DataPoint)

Validates that the specified data point is compatible with this scatter series.

C#
protected override void ValidatePoint(DataPoint item)
Parameters:itemDataPoint

The data point to validate.

Overrides: ChartSeries.ValidatePoint(DataPoint)

In this article
DefinitionConstructorsScatterSeries()ScatterSeries(SizeF)ScatterSeries(string, string)PropertiesModelXValueMemberYValueMemberMethodsBindMembers()CreateDefaultDataPoint()CreateModel()CreatePointElement(DataPoint)GetDefaultTrackballTextForPoint(DataPoint)ValidatePoint(DataPoint)
Not finding the help you need?
Contact Support