ClassPieSeries
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:
public class PieSeries : ChartSeries, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, IStylableElement, IStylableNode, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IShapedElement, IChartSeries, IChartElementPresenter, IAxisProviderInheritance: objectDisposableObjectRadObjectUIChartElementChartSeriesPieSeries
Derived Classes:
Implements:
Inherited Members
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
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
valueMember
The name of the property that contains the data values for the pie segments.
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 LabelModePropertyField Value
LabelsOffsetFromCenterProperty
Identifies the LabelsOffsetFromCenter dependency property.
Declaration
public static readonly RadProperty LabelsOffsetFromCenterPropertyField Value
RadiusFactorProperty
Identifies the RadiusFactor dependency property.
Declaration
public static readonly RadProperty RadiusFactorPropertyField Value
Properties
LabelMode
Gets or sets the label positioning mode for the pie chart labels.
Declaration
public PieLabelModes LabelMode { get; set; }Property Value
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
LegendTitleMember
Gets or sets the name of the data source property that provides legend titles for the pie segments.
Declaration
[Browsable(true)]
public string LegendTitleMember { get; set; }Property Value
Model
Gets the data model that represents the pie series structure and behavior.
Declaration
public override ChartSeriesModel Model { get; }Property Value
Overrides
RadiusFactor
Gets or sets a multiplier that determines the final radius of the pie chart relative to its default size.
Range
Gets or sets the angular range that defines the starting and sweep angles of the pie chart.
ValueMember
Gets or sets the name of the data source property that provides values for the pie segments.
Declaration
[Browsable(true)]
public string ValueMember { get; set; }Property Value
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.
CreateModel()
Creates the data model for the pie series and initializes the data point collection.
Declaration
protected override ChartDataPointCollection CreateModel()Returns
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
point
The data point for which to create the visual element.
Returns
A DataPointElement representing the pie segment.
Overrides
DisposeManagedResources()
Releases the managed resources used by the pie series.
Declaration
protected override void DisposeManagedResources()Overrides
GetPieSegmentColors(int)
Gets the palette entry for the pie segment at the specified index.
Declaration
public PaletteEntry GetPieSegmentColors(int i)Parameters
i
The index of the pie segment.
Returns
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
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
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
item
The data point to validate.
Overrides