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.IsSelectedPropertyChartSeries.AllowSelectPropertyChartSeries.TrackBallTemplatePropertyChartSeries.TrackBallInfoTemplatePropertyChartSeries.ItemsSourcePropertyChartSeries.ClipToPlotAreaPropertyChartSeries.DisplayNamePropertyChartSeries.TooltipTemplatePropertyChartSeries.LabelConnectorsSettingsPropertyChartSeries.ShowLabelsPropertyChartSeries.PlaySeriesAnimation()ChartSeries.PlayPointAnimations()ChartSeries.OnPlaySeriesAnimation(bool)ChartSeries.HitTest(Rect)ChartSeries.HitTestDataPoints(Rect)ChartSeries.HitTestElements(Rect)ChartSeries.HitTestElementsCore(Rect)ChartSeries.HitTestDataPointsCore(Rect)ChartSeries.OnVisibilityChanged()ChartSeries.OnDetached(RadChartBase)ChartSeries.GetDataPointLabels(DataPoint)ChartSeries.SeriesAnimationChartSeries.PointAnimationChartSeries.IsSelectedChartSeries.AllowSelectChartSeries.TrackBallTemplateChartSeries.TrackBallInfoTemplateChartSeries.DisplayNameChartSeries.TooltipTemplateChartSeries.ClipToPlotAreaChartSeries.ItemsSourceChartSeries.LabelConnectorsSettingsChartSeries.LabelDefinitionsChartSeries.ShowLabelsChartSeries.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