Back to all docs
API Reference / Telerik.Windows.Controls.ChartView / PieSeries

Class
PieSeries

Represents a chart series that visualize data points using arcs that form a pie.

Definition

Namespace:Telerik.Windows.Controls.ChartView

Assembly:Telerik.Windows.Controls.Chart.dll

Syntax:
cs-api-definition
public class PieSeries : ChartSeries, IChartElementPresenter

Inheritance: objectRadControlBasePresenterBaseChartElementPresenterChartSeriesPieSeries

Derived Classes: DoughnutSeries

Implements: IChartElementPresenter

Inherited Members ChartSeries.SeriesAnimationPropertyChartSeries.PointAnimationPropertyChartSeries.ShowLabelsPropertyChartSeries.IsSelectedPropertyChartSeries.AllowSelectPropertyChartSeries.TrackBallTemplatePropertyChartSeries.TrackBallInfoTemplatePropertyChartSeries.ItemsSourcePropertyChartSeries.ClipToPlotAreaPropertyChartSeries.DisplayNamePropertyChartSeries.TooltipTemplatePropertyChartSeries.LabelConnectorsSettingsPropertyChartSeries.PlaySeriesAnimation()ChartSeries.PlayPointAnimations()ChartSeries.OnPlaySeriesAnimation(bool)ChartSeries.GetDataPointLabels(DataPoint)ChartSeries.HitTest(Rect)ChartSeries.HitTestDataPoints(Rect)ChartSeries.HitTestElements(Rect)ChartSeries.HitTestElementsCore(Rect)ChartSeries.HitTestDataPointsCore(Rect)ChartSeries.OnVisibilityChanged()ChartSeries.OnDetached(RadChartBase)ChartSeries.SeriesAnimationChartSeries.PointAnimationChartSeries.LabelDefinitionsChartSeries.ShowLabelsChartSeries.IsSelectedChartSeries.AllowSelectChartSeries.TrackBallTemplateChartSeries.TrackBallInfoTemplateChartSeries.DisplayNameChartSeries.TooltipTemplateChartSeries.ClipToPlotAreaChartSeries.ItemsSourceChartSeries.LabelConnectorsSettingsChartSeries.SeriesAnimationCompletedChartSeries.PointAnimationsCompletedChartSeries.DataBindingCompleteChartElementPresenter.OnPropertyChanged(DependencyPropertyChangedEventArgs)ChartElementPresenter.ZIndexChartElementPresenter.ChartPresenterBase.InfinitySizePresenterBase.InfinityPointPresenterBase.RefreshNode(ChartNode)PresenterBase.InvalidatePalette()PresenterBase.MeasureNodeOverride(ChartNode, object)PresenterBase.RefreshNodeCore(ChartNode)PresenterBase.CreateContentPresenter(object, DataTemplate)PresenterBase.OnInitialized(EventArgs)PresenterBase.RenderSurfaceRadControlBase.OnUnloaded(object, RoutedEventArgs)RadControlBase.IsLoadedRadControlBase.IsTemplateApplied

Constructors

PieSeries()

Initializes a new instance of the PieSeries class.

Declaration

cs-api-definition
public PieSeries()

Fields

DefaultSliceStyleProperty

Identifies the DefaultSliceStyle property.

Declaration

cs-api-definition
public static readonly DependencyProperty DefaultSliceStyleProperty

Field Value

DependencyProperty

LegendSettingsProperty

Identifies the LegendSettings property.

Declaration

cs-api-definition
public static readonly DependencyProperty LegendSettingsProperty

Field Value

DependencyProperty

RadiusFactorProperty

Identifies the RadiusFactor property.

Declaration

cs-api-definition
public static readonly DependencyProperty RadiusFactorProperty

Field Value

DependencyProperty

SelectedPointOffsetProperty

Identifies the SelectedPointOffset property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectedPointOffsetProperty

Field Value

DependencyProperty

SliceStyleSelectorProperty

Identifies the StyleSelector property.

Declaration

cs-api-definition
public static readonly DependencyProperty SliceStyleSelectorProperty

Field Value

DependencyProperty

ValueBindingProperty

Identifies the ValueBinding property.

Declaration

cs-api-definition
public static readonly DependencyProperty ValueBindingProperty

Field Value

DependencyProperty

Properties

AngleRange

Gets or sets the angle range that define the pie.

Declaration

cs-api-definition
public AngleRange AngleRange { get; set; }

Property Value

AngleRange

DataPoints

Gets the collection of data points associated with the series.

Declaration

cs-api-definition
public ElementCollection<PieDataPoint> DataPoints { get; }

Property Value

ElementCollection<PieDataPoint>

DefaultSliceStyle

Gets or sets the Style instance that defines the default appearance of each Path presenting a pie slice.

Declaration

cs-api-definition
public Style DefaultSliceStyle { get; set; }

Property Value

Style

LabelFormat

Gets or sets the string used to format the default label (that is the Percent value) of each data point. Defaults to 'p0'.

Declaration

cs-api-definition
public string LabelFormat { get; set; }

Property Value

string

LegendSettings

Gets or sets the legend settings.

Declaration

cs-api-definition
public DataPointLegendSettings LegendSettings { get; set; }

Property Value

DataPointLegendSettings

RadiusFactor

Gets or sets the radius factor used to calculate the radius of the visual series.

Declaration

cs-api-definition
public double RadiusFactor { get; set; }

Property Value

double

The default value is 1.

Remarks

This value is usually within the (0,1) range but it is possible to oversize the series by setting a value greater than 1.

SelectedPointOffset

Gets or sets the offset applied to a PieDataPoint which is currently selected. This value is applied only if the point's OffsetFromCenter property is 0.

Declaration

cs-api-definition
public double SelectedPointOffset { get; set; }

Property Value

double

SliceStyleSelector

Gets or sets the StyleSelector instance used to select the appropriate style for a PieDataPoint.

Declaration

cs-api-definition
public StyleSelector SliceStyleSelector { get; set; }

Property Value

StyleSelector

SliceStyles

Gets the collection storing a Style instance for each segment present on the chart.

Declaration

cs-api-definition
public ObservableCollection<Style> SliceStyles { get; }

Property Value

ObservableCollection<Style>

ValueBinding

Gets or sets the binding that will be used to fill the Value member of the contained data points.

Declaration

cs-api-definition
[TypeConverter(typeof(StringToDataPointBindingConverter))]
public DataPointBinding ValueBinding { get; set; }

Property Value

DataPointBinding

Methods

GetLabelConnector(ChartSeriesLabelPositionInfo)

Gets the points which build the label connector polyline.

Declaration

cs-api-definition
protected override List<Point> GetLabelConnector(ChartSeriesLabelPositionInfo info)

Parameters

info

ChartSeriesLabelPositionInfo

Returns

List<Point>

Overrides ChartSeries.GetLabelConnector(ChartSeriesLabelPositionInfo)

GetValueAggregateFunction()

When overridden in a derived class, this method returns the function used to calculate the aggregate values for the Value property.

Declaration

cs-api-definition
protected virtual ChartAggregateFunction GetValueAggregateFunction()

Returns

ChartAggregateFunction

OnApplyTemplate()

When overridden in a derived class, is invoked whenever application code or internal processes (such as a rebuilding layout pass) call . In simplest terms, this means the method is called just before a UI element displays in an application. For more information, see Remarks.

Declaration

cs-api-definition
public override void OnApplyTemplate()

Overrides ChartSeries.OnApplyTemplate()

OnAttached()

Occurs when the presenter has been successfully attached to its owning RadChartBase instance.

Declaration

cs-api-definition
protected override void OnAttached()

Overrides ChartSeries.OnAttached()

OnCreateAutomationPeer()

Returns class-specific AutomationPeer implementations for the Windows Presentation Foundation (WPF) infrastructure.

Declaration

cs-api-definition
protected override AutomationPeer OnCreateAutomationPeer()

Returns

AutomationPeer

The type-specific AutomationPeer implementation.

OnLoaded(object, RoutedEventArgs)

Occurs when a System.Windows.FrameworkElement has been constructed and added to the object tree.

Declaration

cs-api-definition
protected override void OnLoaded(object sender, RoutedEventArgs e)

Parameters

sender

object

e

RoutedEventArgs

Overrides ChartSeries.OnLoaded(object, RoutedEventArgs)

OnMouseLeave(MouseEventArgs)

Invoked when an unhandled  attached event is raised on this element. Implement this method to add class handling for this event.

Declaration

cs-api-definition
protected override void OnMouseLeave(MouseEventArgs e)

Parameters

e

MouseEventArgs

The MouseEventArgs that contains the event data.

OnMouseMove(MouseEventArgs)

Invoked when an unhandled  attached event reaches an element in its route that is derived from this class. Implement this method to add class handling for this event.

Declaration

cs-api-definition
protected override void OnMouseMove(MouseEventArgs e)

Parameters

e

MouseEventArgs

The MouseEventArgs that contains the event data.

OnPlayPointAnimations(bool)

Fired when Point animations are about to be played.

Declaration

cs-api-definition
protected override void OnPlayPointAnimations(bool hidePointsOnLoad)

Parameters

hidePointsOnLoad

bool

When true, the animated element is collapsed until the start of the animation.

Overrides ChartSeries.OnPlayPointAnimations(bool)

In this article
DefinitionConstructorsPieSeries()FieldsDefaultSliceStylePropertyLegendSettingsPropertyRadiusFactorPropertySelectedPointOffsetPropertySliceStyleSelectorPropertyValueBindingPropertyPropertiesAngleRangeDataPointsDefaultSliceStyleLabelFormatLegendSettingsRadiusFactorSelectedPointOffsetSliceStyleSelectorSliceStylesValueBindingMethodsGetLabelConnector(ChartSeriesLabelPositionInfo)GetValueAggregateFunction()OnApplyTemplate()OnAttached()OnCreateAutomationPeer()OnLoaded(object, RoutedEventArgs)OnMouseLeave(MouseEventArgs)OnMouseMove(MouseEventArgs)OnPlayPointAnimations(bool)
Not finding the help you need?
Contact Support