Class PieSeries

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

Inheritance
System.Object
DisposableObject
RadObject
UIChartElement
ChartSeries
PieSeries
DonutSeries
Inherited Members
System.Object.ToString()
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.ChartView.dll

Syntax

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

Constructors

PieSeries()

Initializes a new instance of the PieSeries class.

Declaration
public PieSeries()

PieSeries(String)

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

Declaration
public PieSeries(string valueMember)
Parameters
System.String valueMember

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

PieSeries(String, String)

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

Declaration
public PieSeries(string valueMember, string legendTitleMember)
Parameters
System.String valueMember

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

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

Fields

LabelModeProperty

Identifies the LabelMode dependency property.

Declaration
public static readonly RadProperty LabelModeProperty
Field Value
RadProperty

LabelsOffsetFromCenterProperty

Identifies the LabelsOffsetFromCenter dependency property.

Declaration
public static readonly RadProperty LabelsOffsetFromCenterProperty
Field Value
RadProperty

RadiusFactorProperty

Identifies the RadiusFactor dependency property.

Declaration
public static readonly RadProperty RadiusFactorProperty
Field Value
RadProperty

Properties

LabelMode

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

Declaration
public PieLabelModes LabelMode { get; set; }
Property Value
PieLabelModes

LabelsOffsetFromCenter

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

Declaration
public float LabelsOffsetFromCenter { get; set; }
Property Value
System.Single

LegendTitleMember

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

Declaration
public string LegendTitleMember { get; set; }
Property Value
System.String

Model

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

Declaration
public override ChartSeriesModel Model { get; }
Property Value
ChartSeriesModel

Overrides

RadiusFactor

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

Declaration
public float RadiusFactor { get; set; }
Property Value
System.Single

Range

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

Declaration
public AngleRange Range { get; set; }
Property Value
AngleRange

ValueMember

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

Declaration
public string ValueMember { get; set; }
Property Value
System.String

Methods

BindMembers()

Binds the data members to the appropriate data point properties.

Declaration
protected override void BindMembers()
Overrides

CreateDefaultDataPoint()

Creates a default pie data point for the series.

Declaration
protected override DataPoint CreateDefaultDataPoint()
Returns
DataPoint

A new DataPoint instance suitable for pie charts.
Overrides

CreateModel()

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

Declaration
protected override ChartDataPointCollection CreateModel()
Returns
ChartDataPointCollection

A ChartDataPointCollection containing the pie data points.
Overrides

CreatePointElement(DataPoint)

Creates a visual element for the specified pie data point.

Declaration
protected override DataPointElement CreatePointElement(DataPoint point)
Parameters
DataPoint point

The data point for which to create the visual element.
Returns
DataPointElement

A DataPointElement representing the pie segment.
Overrides

DisposeManagedResources()

Releases the managed resources used by the pie series.

Declaration
protected override void DisposeManagedResources()
Overrides

GetPieSegmentColors(Int32)

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

Declaration
public PaletteEntry GetPieSegmentColors(int i)
Parameters
System.Int32 i

The index of the pie segment.
Returns
PaletteEntry

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

OnApplyPalette()

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

Declaration
protected override void OnApplyPalette()
Overrides

OnAttached(UIChartElement)

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

Declaration
protected override void OnAttached(UIChartElement parent)
Parameters
UIChartElement parent

The parent chart element, which must be a PieArea.
Overrides

OnDettached()

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

Declaration
protected override void OnDettached()
Overrides

OnNotifyPropertyChanged(String)

Raises the property changed event and updates the data model.

Declaration
protected override void OnNotifyPropertyChanged(string propertyName)
Parameters
System.String propertyName

The name of the property that changed.
Overrides

ValidatePoint(DataPoint)

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

Declaration
protected override void ValidatePoint(DataPoint item)
Parameters
DataPoint item

The data point to validate.
Overrides

Extension Methods