New to Telerik UI for WinFormsStart a free 30-day trial

Represents a pie chart series that displays data as segments of a circular pie, where each segment represents a data point's proportional value.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.ChartView.dll

Syntax:

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

Inheritance: objectDisposableObjectRadObjectUIChartElementChartSeriesPieSeries...

Derived Classes: DonutSeries

Implements: IAxisProviderIBorderElementIBoxElementIBoxStyleIChartElementPresenterIChartSeriesICustomTypeDescriptorIDisposableIFillElementINotifyPropertyChangedIShapedElementIStylableElementIStylableNode...

Inherited Members ChartSeries.PointSizePropertyChartSeries.LabelFormatPropertyChartSeries.DrawLinesToLabelsPropertyChartSeries.SyncLinesToLabelsColorPropertyChartSeries.LinesToLabelsColorPropertyChartSeries.LabelRotationAnglePropertyChartSeries.OnDataPointIsSelectedChanged(DataPoint)ChartSeries.EnsureVisualState(ChartArea)ChartSeries.ApplyStyleSettingsCore(PropertySettingGroup)ChartSeries.Refresh()ChartSeries.OnPropertyChanged(RadPropertyChangedEventArgs)ChartSeries.CreateDataPointElementCollection()ChartSeries.CreateDataPoint()ChartSeries.CreateDataPointElement(DataPoint)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.AxesChartSeries.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(PropertyChangedEventArgs)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 PieSeries class.

C#
public PieSeries()

Initializes a new instance of the PieSeries class with the specified value and legend title members.

C#
public PieSeries(string valueMember, string legendTitleMember)
Parameters:valueMemberstring

The name of the property that contains the data values for the pie segments.

legendTitleMemberstring

The name of the property that contains the legend titles for the pie segments.

Initializes a new instance of the PieSeries class with the specified value member.

C#
public PieSeries(string valueMember)
Parameters:valueMemberstring

The name of the property that contains the data values for the pie segments.

Fields

Identifies the LabelMode dependency property.

C#
public static readonly RadProperty LabelModeProperty

Identifies the LabelsOffsetFromCenter dependency property.

C#
public static readonly RadProperty LabelsOffsetFromCenterProperty

Identifies the RadiusFactor dependency property.

C#
public static readonly RadProperty RadiusFactorProperty

Properties

Gets or sets the label positioning mode for the pie chart labels.

C#
public PieLabelModes LabelMode { get; set; }

Gets or sets the distance multiplier that determines how far labels are positioned from the center of the pie.

C#
public float LabelsOffsetFromCenter { get; set; }

Gets or sets the name of the data source property that provides legend titles for the pie segments.

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

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

C#
public override ChartSeriesModel Model { get; }

Overrides: ChartSeries.Model

Gets or sets a multiplier that determines the final radius of the pie chart relative to its default size.

C#
public float RadiusFactor { get; set; }

Gets or sets the angular range that defines the starting and sweep angles of the pie chart.

C#
public AngleRange Range { get; set; }

Gets or sets the name of the data source property that provides values for the pie segments.

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

Methods

Binds the data members to the appropriate data point properties.

C#
protected override void BindMembers()

Overrides: ChartSeries.BindMembers()

Creates a default pie data point for the series.

C#
protected override DataPoint CreateDefaultDataPoint()
Returns:

DataPoint

A new DataPoint instance suitable for pie charts.

Overrides: ChartSeries.CreateDefaultDataPoint()

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

C#
protected override ChartDataPointCollection CreateModel()
Returns:

ChartDataPointCollection

A ChartDataPointCollection containing the pie data points.

Overrides: ChartSeries.CreateModel()

Creates a visual element for the specified pie 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 pie segment.

Overrides: ChartSeries.CreatePointElement(DataPoint)

Releases the managed resources used by the pie series.

C#
protected override void DisposeManagedResources()

Overrides: ChartSeries.DisposeManagedResources()

Gets the palette entry for the pie segment at the specified index.

C#
public PaletteEntry GetPieSegmentColors(int i)
Parameters:iint

The index of the pie segment.

Returns:

PaletteEntry

A PaletteEntry containing the colors for the segment, or null if no palette is available.

Applies the current palette to all pie point elements, setting their background and border colors.

C#
protected override void OnApplyPalette()

Overrides: ChartSeries.OnApplyPalette()

Called when the series is attached to a parent chart element.

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

The parent chart element, which must be a PieArea.

Overrides: ChartSeries.OnAttached(UIChartElement)

Called when the series is detached from its parent chart element.

C#
protected override void OnDettached()

Overrides: ChartSeries.OnDettached()

Raises the property changed event and updates the data model.

C#
protected override void OnNotifyPropertyChanged(string propertyName)
Parameters:propertyNamestring

The name of the property that changed.

Overrides: RadObject.OnNotifyPropertyChanged(string)

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

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

The data point to validate.

Overrides: ChartSeries.ValidatePoint(DataPoint)