Class
ChartSeries

Base class for all series of data points, plotted on a RadChartBase instance.

Definition

Namespace:Telerik.Windows.Controls.ChartView

Assembly:Telerik.Windows.Controls.Chart.dll

Syntax:

cs-api-definition
public abstract class ChartSeries : ChartElementPresenter, IChartElementPresenter

Inheritance: objectRadControlBasePresenterBaseChartElementPresenterChartSeries

Derived Classes: FunnelSeriesIndicatorBasePieSeriesPointTemplateSeries

Implements: IChartElementPresenter

Inherited Members ChartElementPresenter.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

ChartSeries()

Initializes a new instance of the ChartSeries class.

Declaration

cs-api-definition
protected ChartSeries()

Fields

AllowSelectProperty

Identifies the AllowSelect property.

Declaration

cs-api-definition
public static readonly DependencyProperty AllowSelectProperty

Field Value

DependencyProperty

ClipToPlotAreaProperty

Identifies the ClipToPlotArea property.

Declaration

cs-api-definition
public static readonly DependencyProperty ClipToPlotAreaProperty

Field Value

DependencyProperty

DisplayNameProperty

Identifies the DisplayName dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty DisplayNameProperty

Field Value

DependencyProperty

IsSelectedProperty

Identifies the IsSelected property.

Declaration

cs-api-definition
public static readonly DependencyProperty IsSelectedProperty

Field Value

DependencyProperty

ItemsSourceProperty

Identifies the ItemsSource property.

Declaration

cs-api-definition
public static readonly DependencyProperty ItemsSourceProperty

Field Value

DependencyProperty

LabelConnectorsSettingsProperty

Identifies the LabelConnectorsSettings dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty LabelConnectorsSettingsProperty

Field Value

DependencyProperty

PointAnimationProperty

Identifies the PointAnimation property.

Declaration

cs-api-definition
public static readonly DependencyProperty PointAnimationProperty

Field Value

DependencyProperty

SeriesAnimationProperty

Identifies the SeriesAnimation property.

Declaration

cs-api-definition
public static readonly DependencyProperty SeriesAnimationProperty

Field Value

DependencyProperty

ShowLabelsProperty

Identifies the ShowLabels property.

Declaration

cs-api-definition
public static readonly DependencyProperty ShowLabelsProperty

Field Value

DependencyProperty

TooltipTemplateProperty

Identifies the TooltipTemplate dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty TooltipTemplateProperty

Field Value

DependencyProperty

TrackBallInfoTemplateProperty

Identifies the TrackBallInfoTemplate property.

Declaration

cs-api-definition
public static readonly DependencyProperty TrackBallInfoTemplateProperty

Field Value

DependencyProperty

TrackBallTemplateProperty

Identifies the TrackBallTemplate property.

Declaration

cs-api-definition
public static readonly DependencyProperty TrackBallTemplateProperty

Field Value

DependencyProperty

Properties

AllowSelect

Determines whether the series might enter the IsSelected state.

Declaration

cs-api-definition
public bool AllowSelect { get; set; }

Property Value

bool

ClipToPlotArea

Gets or sets a value indicating whether this instance will be clipped to the bounds of the plot area.

Declaration

cs-api-definition
public bool ClipToPlotArea { get; set; }

Property Value

bool

DisplayName

Gets or sets the human-readable name of the series.

Declaration

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

Property Value

string

IsSelected

Gets or sets a value indicating whether the series is currently in a "Selected" state. Usually this state is indicated by a change in the visual representation of the series.

Declaration

cs-api-definition
public bool IsSelected { get; set; }

Property Value

bool

ItemsSource

Gets or sets the source items to generate data points from.

Declaration

cs-api-definition
public IEnumerable ItemsSource { get; set; }

Property Value

IEnumerable

LabelConnectorsSettings

Gets or sets the connectors settings. When the value of this property is null, label connectors are not drawn.

Declaration

cs-api-definition
public ChartSeriesLabelConnectorsSettings LabelConnectorsSettings { get; set; }

Property Value

ChartSeriesLabelConnectorsSettings

LabelDefinitions

Gets the collection that stores all the definitions that describe the appearance of each label per data point. When ShowLabels is true and no custom definition is present within the collection, a default one is used.

Declaration

cs-api-definition
public ObservableCollection<ChartSeriesLabelDefinition> LabelDefinitions { get; }

Property Value

ObservableCollection<ChartSeriesLabelDefinition>

PointAnimation

Gets or sets the animation for this data points in this series instance.

Declaration

cs-api-definition
public ChartAnimationBase PointAnimation { get; set; }

Property Value

ChartAnimationBase

SeriesAnimation

Gets or sets the animation for this series instance.

Declaration

cs-api-definition
public ChartAnimationBase SeriesAnimation { get; set; }

Property Value

ChartAnimationBase

ShowLabels

Gets or sets a value indicating whether the series will display a label associated with each data point.

Declaration

cs-api-definition
public bool ShowLabels { get; set; }

Property Value

bool

TooltipTemplate

Gets or sets the ContentTemplate of the tooltip that is shown by the ChartTooltipBehavior. This property has a higher priority than the TooltipTemplate property of the chart.

Declaration

cs-api-definition
public DataTemplate TooltipTemplate { get; set; }

Property Value

DataTemplate

TrackBallInfoTemplate

Gets or sets the template used to visualize the information about this series in a ChartTrackBallBehavior TrackInfo control.

Declaration

cs-api-definition
public DataTemplate TrackBallInfoTemplate { get; set; }

Property Value

DataTemplate

TrackBallTemplate

Gets or sets the template used to visualize an intersection point between a ChartTrackBallBehavior line and a data point that is contained within this series.

Declaration

cs-api-definition
public DataTemplate TrackBallTemplate { get; set; }

Property Value

DataTemplate

Methods

GetDataPointLabels(DataPoint)

Gets all the FrameworkElement instances that represent labels, associated with the specified DataPoint instance.

Declaration

cs-api-definition
public IEnumerable<FrameworkElement> GetDataPointLabels(DataPoint point)

Parameters

point

DataPoint

Returns

IEnumerable<FrameworkElement>

GetLabelConnector(ChartSeriesLabelPositionInfo)

Gets the points which build the label connector polyline.

Declaration

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

Parameters

info

ChartSeriesLabelPositionInfo

Returns

List<Point>

HitTest(Rect)

Determines whether the provided touch Rect is within the series visual representation.

Declaration

cs-api-definition
public virtual bool HitTest(Rect touchRect)

Parameters

touchRect

Rect

Returns

bool

HitTestDataPoints(Rect)

Finds all the data points which visual representations contain the specified touch Rect.

Declaration

cs-api-definition
public IEnumerable<DataPoint> HitTestDataPoints(Rect touchRect)

Parameters

touchRect

Rect

Returns

IEnumerable<DataPoint>

HitTestDataPointsCore(Rect)

Performs the core logic behind the HitTestDataPoints(Rect) method.

Declaration

cs-api-definition
protected virtual IEnumerable<DataPoint> HitTestDataPointsCore(Rect touchRect)

Parameters

touchRect

Rect

Returns

IEnumerable<DataPoint>

HitTestElements(Rect)

Finds all the visual representations that contain the specified touch Rect.

Declaration

cs-api-definition
public IEnumerable<FrameworkElement> HitTestElements(Rect touchRect)

Parameters

touchRect

Rect

Returns

IEnumerable<FrameworkElement>

HitTestElementsCore(Rect)

Performs the core logic behind the HitTestElements(Rect) method.

Declaration

cs-api-definition
protected virtual IEnumerable<FrameworkElement> HitTestElementsCore(Rect touchRect)

Parameters

touchRect

Rect

Returns

IEnumerable<FrameworkElement>

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 PresenterBase.OnApplyTemplate()

OnAttached()

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

Declaration

cs-api-definition
protected override void OnAttached()

Overrides ChartElementPresenter.OnAttached()

OnDetached(RadChartBase)

Occurs when the presenter has been successfully detached from its owning RadChartBase instance.

Declaration

cs-api-definition
protected override void OnDetached(RadChartBase oldChart)

Parameters

oldChart

RadChartBase

Overrides ChartElementPresenter.OnDetached(RadChartBase)

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 RadControlBase.OnLoaded(object, RoutedEventArgs)

OnPlayPointAnimations(bool)

Occurs when the PointAnimation for every datapoint is about to be played.

Declaration

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

Parameters

hidePointsOnLoad

bool

OnPlaySeriesAnimation(bool)

Occurs when the SeriesAnimation is about to be played.

Declaration

cs-api-definition
protected virtual void OnPlaySeriesAnimation(bool hideSeriesOnLoad)

Parameters

hideSeriesOnLoad

bool

OnVisibilityChanged()

Occurs when the has been changed.

Declaration

cs-api-definition
protected virtual void OnVisibilityChanged()

PlayPointAnimations()

Plays the PointAnimation for all data points in this series instance.

Declaration

cs-api-definition
public void PlayPointAnimations()

PlaySeriesAnimation()

Plays the SeriesAnimation for this series instance.

Declaration

cs-api-definition
public void PlaySeriesAnimation()

Events

DataBindingComplete

Occurs when a databinding operation has been successfully completed.

Declaration

cs-api-definition
public event EventHandler DataBindingComplete

Event Value

EventHandler

PointAnimationsCompleted

Occurs when the PointAnimation for every datapoint of this series has completed.

Declaration

cs-api-definition
public event EventHandler PointAnimationsCompleted

Event Value

EventHandler

SeriesAnimationCompleted

Occurs when the SeriesAnimation has completed.

Declaration

cs-api-definition
public event EventHandler SeriesAnimationCompleted

Event Value

EventHandler