New to Telerik UI for WinForms? Start a free 30-day trial

Base for chart series plotted against horizontal and vertical Cartesian axes. It binds category and value fields to data points and provides axis, combination, and legend integration.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.ChartView.dll

Syntax:

C#
public abstract class CartesianSeries : ChartSeries, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, IStylableElement, IStylableNode, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IShapedElement, IChartSeries, IChartElementPresenter, IAxisProvider

Inheritance: objectDisposableObjectRadObjectUIChartElementChartSeriesCartesianSeries...

Derived Classes: BarSeriesCartesianPointSeriesHlcSeriesRangeSeriesBaseWaterfallSeries

Implements: IAxisProviderIBorderElementIBoxElementIBoxStyleIChartElementPresenterIChartSeriesICustomTypeDescriptorIDisposableIFillElementINotifyPropertyChangedIShapedElementIStylableElementIStylableNode...

Inherited Members ChartSeries.PointSizePropertyChartSeries.LabelFormatPropertyChartSeries.DrawLinesToLabelsPropertyChartSeries.SyncLinesToLabelsColorPropertyChartSeries.LinesToLabelsColorPropertyChartSeries.LabelRotationAnglePropertyChartSeries.OnDataPointIsSelectedChanged(DataPoint)ChartSeries.EnsureVisualState(ChartArea)ChartSeries.ApplyStyleSettingsCore(PropertySettingGroup)ChartSeries.Refresh()ChartSeries.DisposeManagedResources()ChartSeries.CreateModel()ChartSeries.CreatePointElement(DataPoint)ChartSeries.CreateDataPointElementCollection()ChartSeries.CreateDataPoint()ChartSeries.CreateDataPointElement(DataPoint)ChartSeries.ValidatePoint(DataPoint)ChartSeries.OnApplyPalette()ChartSeries.GetElement(Point)ChartSeries.GetStyleIndex()ChartSeries.HitTest(int, int)ChartSeries.GetDefaultTrackballTextForPoint(DataPoint)ChartSeries.OnCreatePoint(ChartViewCreatePointEventArgs)ChartSeries.OnTrackballPointTextNeeded(TrackballPointTextNeededEventArgs)ChartSeries.SelectedStyleChartSeries.LabelFormatChartSeries.ShowLabelsChartSeries.LabelFormatProviderChartSeries.PointSizeChartSeries.DrawLinesToLabelsChartSeries.SyncLinesToLabelsColorChartSeries.LinesToLabelsColorChartSeries.DataPointsChartSeries.DataSourceChartSeries.DataMemberChartSeries.DisplayMemberChartSeries.FamilyChartSeries.NameChartSeries.ModelChartSeries.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

Initializes a new instance of the CartesianSeries class.

C#
public CartesianSeries()

Initializes a new instance of the CartesianSeries class.

C#
public CartesianSeries(string valueMember, string categoryMember)
Parameters:valueMemberstring

The value member.

categoryMemberstring

The category member.

Initializes a new instance of the CartesianSeries class.

C#
public CartesianSeries(string valueMember)
Parameters:valueMemberstring

The value member.

Fields

Identifies how this series is combined with compatible series, including whether it is plotted independently, clustered, or stacked.

C#
public static RadProperty CombineModeProperty

Identifies whether this series contributes an entry to the chart legend.

C#
public static RadProperty IsVisibleInLegendProperty

Identifies the title displayed for this series in the chart legend.

C#
public static RadProperty LegendTitleProperty

Properties

Gets the axes.

C#
[Browsable(false)]
public override Axis[] Axes { get; }
Property Value:

The axes.

Overrides: ChartSeries.Axes

Gets or sets the category member.

C#
[Browsable(true)]
public string CategoryMember { get; set; }
Property Value:

The category member.

Gets or sets a value indicating whether the series labels will be clipped according to the viewport`s width and height.

C#
public bool ClipLabels { get; set; }

Gets or sets the combination mode to be used when data points are plotted.

C#
public ChartSeriesCombineMode CombineMode { get; set; }

Gets or sets the visual CartesianAxis instance that will be used to plot points along the horizontal (X) axis.

C#
[TypeConverter(typeof(StringConverter))]
public CartesianAxis HorizontalAxis { get; set; }

Gets or sets whether this series will be used in chart legend.

C#
public bool IsVisibleInLegend { get; set; }

Gets or sets the title that will be used by chart legend.

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

Gets or sets the key that defines in which stack group this series will be included if its CombineMode equals Stack or Stack100.

C#
[Browsable(false)]
public object StackGroupKey { get; set; }

Gets or sets the value member.

C#
[Browsable(true)]
public string ValueMember { get; set; }
Property Value:

The value member.

Gets or sets the visual CartesianAxis instance that will be used to plot points along the vertical (Y) axis.

C#
[TypeConverter(typeof(StringConverter))]
public CartesianAxis VerticalAxis { get; set; }

Methods

Binds the members.

C#
protected override void BindMembers()

Overrides: ChartSeries.BindMembers()

Creates the default data point.

C#
protected override DataPoint CreateDefaultDataPoint()
Returns:

DataPoint

Overrides: ChartSeries.CreateDefaultDataPoint()

Gets the color that would be used to draw the series axes when in multi axis mode.

C#
public virtual Color GetColorForMultiAxis()
Returns:

Color

The axes color.

Called when [attached].

C#
protected override void OnAttached(UIChartElement parent)
Parameters:parentUIChartElement

The parent.

Overrides: ChartSeries.OnAttached(UIChartElement)

Called when [dettached].

C#
protected override void OnDettached()

Overrides: ChartSeries.OnDettached()

Raises the standard .NET PropertyChanged event.

C#
protected override void OnNotifyPropertyChanged(PropertyChangedEventArgs e)
Parameters:ePropertyChangedEventArgs

Overrides: RadObject.OnNotifyPropertyChanged(PropertyChangedEventArgs)

Propagates combination-mode changes to the series model and refreshes layout; legend property changes update the area's legend entry.

C#
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
Parameters:eRadPropertyChangedEventArgs

Details of the changed property.

Overrides: ChartSeries.OnPropertyChanged(RadPropertyChangedEventArgs)