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

Base class for series displayed in polar chart areas. It provides polar and radial axis integration, point-label positioning, and legend behavior for polar and radar series.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.ChartView.dll

Syntax:

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

Inheritance: objectDisposableObjectRadObjectUIChartElementChartSeriesPolarSeries...

Derived Classes: PolarPointSeriesRadarSeries

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.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.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 polar series with no data-source members assigned.

C#
public PolarSeries()

Initializes a polar series that reads point values and angles from the specified data-source members.

C#
public PolarSeries(string valueMember, string angleMember)
Parameters:valueMemberstring

The data-source member that supplies each point's radial value.

angleMemberstring

The data-source member that supplies each point's angle.

Initializes a polar series that reads point values from the specified data-source member.

C#
public PolarSeries(string valueMember)
Parameters:valueMemberstring

The data-source member that supplies each point's radial value.

Fields

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

C#
public static RadProperty IsVisibleInLegendProperty

Identifies the angle, in degrees, used to position a data-point label relative to its point.

C#
public static readonly RadProperty LabelAngleProperty

Identifies the distance between a data point's center and the center of its label.

C#
public static readonly RadProperty LabelDistanceToPointProperty

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

C#
public static RadProperty LegendTitleProperty

Properties

Gets or sets the data-source member bound to the angle coordinate of each polar data point. Radar series use CategoryMember instead.

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

Gets the polar and radial axes used by this series, in that order.

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

Overrides: ChartSeries.Axes

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

C#
public bool IsVisibleInLegend { get; set; }

Gets or sets the angle, in degrees, used to position each point label relative to its data point.

C#
public double LabelAngle { get; set; }

Gets or sets the distance between a data point's center and the center of its label.

C#
public double LabelDistanceToPoint { get; set; }

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

C#
public string LegendTitle { get; set; }

Gets or sets the polar axis of the radar chart.

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

Gets or sets the radial axis of the radar chart.

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

Gets or sets the data-source member bound to the radial value of each data point.

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

Methods

Binds the value and angle members to the corresponding fields of polar data points.

C#
protected override void BindMembers()

Overrides: ChartSeries.BindMembers()

Creates a default polar data point for this series.

C#
protected override DataPoint CreateDefaultDataPoint()
Returns:

DataPoint

A new PolarDataPoint.

Overrides: ChartSeries.CreateDefaultDataPoint()

Creates the visual element used to render a polar data point.

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

The data point represented by the element.

Returns:

DataPointElement

A PolarPointElement for point.

Overrides: ChartSeries.CreatePointElement(DataPoint)

Formats the default trackball text with the series name, point value, and point angle.

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

The point for which trackball text is requested.

Returns:

string

The series name followed by the value and angle in degrees.

Overrides: ChartSeries.GetDefaultTrackballTextForPoint(DataPoint)

Attaches the series to a polar area, registers its axes, and adds its legend entry when visible in the legend.

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

The chart element to which the series is being attached.

Exceptions: InvalidOperationException

parent is not a PolarArea.

Overrides: ChartSeries.OnAttached(UIChartElement)

Removes this series' legend entry when it is detached from its polar area.

C#
protected override void OnDettached()

Overrides: ChartSeries.OnDettached()

Relayouts the view after a property change when this series is attached and both axes are assigned.

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

Details of the changed property.

Overrides: RadObject.OnNotifyPropertyChanged(PropertyChangedEventArgs)

Updates this series' legend entry when its title or legend visibility changes.

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

Details of the changed property.

Overrides: ChartSeries.OnPropertyChanged(RadPropertyChangedEventArgs)

Ensures that the supplied point uses a data-point type supported by polar series.

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

The data point to validate.

Exceptions: ArgumentException

item is neither a CategoricalDataPoint nor a PolarDataPoint.

Overrides: ChartSeries.ValidatePoint(DataPoint)