Class
ChartSeries

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

Definition

Namespace:Telerik.UI.Xaml.Controls.Chart

Assembly:Telerik.WinUI.Controls.dll

Syntax:

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

Inheritance: objectRadControlPresenterBaseChartElementPresenterChartSeries

Derived Classes: IndicatorBasePieSeriesPointTemplateSeries

Implements: IChartElementPresenterIChartSeriesIElementPresenter

Inherited Members ChartElementPresenter.ZIndexChartElementPresenter.ChartPresenterBase.InfinitySizePresenterBase.InfinityPointPresenterBase.RefreshNode(object)PresenterBase.InvalidatePalette()PresenterBase.MeasureNodeOverride(Node, object)PresenterBase.RefreshNodeCore(Node)PresenterBase.CreateContentPresenter(object, DataTemplate)PresenterBase.RenderSurfacePresenterBase.CompositorPresenterBase.ContainerVisualRootRadControl.EndVisualStateUpdate(bool, bool)RadControl.UpdateVisualState(bool)RadControl.BeginVisualStateUpdate()RadControl.SetVisualState(string, bool)RadControl.CanUpdateVisualState()RadControl.ComposeVisualStateName()RadControl.MeasureOverride(Size)RadControl.ArrangeOverride(Size)RadControl.OnApplyTemplate()RadControl.UnapplyTemplateCore()RadControl.OnIsEnabledChanged(bool, bool)RadControl.LoadCore()RadControl.OnLoaded()RadControl.UnloadCore()RadControl.CurrentVisualStateRadControl.IsLoadedRadControl.IsLoadingRadControl.IsUnloadedRadControl.WasUnloadedRadControl.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

IsSelectedBindingProperty

Identifies the IsSelectedBinding property.

Declaration

cs-api-definition
public static readonly DependencyProperty IsSelectedBindingProperty

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

PaletteIndexProperty

Identifies the PaletteIndex property.

Declaration

cs-api-definition
public static readonly DependencyProperty PaletteIndexProperty

Field Value

DependencyProperty

ShowLabelsProperty

Identifies the ShowLabels property.

Declaration

cs-api-definition
public static readonly DependencyProperty ShowLabelsProperty

Field Value

DependencyProperty

Properties

ActualPaletteIndex

Gets the actual palette index used to retrieve the actual palette brush used for this series.

Declaration

cs-api-definition
public int ActualPaletteIndex { get; }

Property Value

int

AllowSelect

Gets or sets a value indicating 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

IsSelectedBinding

Gets or sets the DataPointBinding instance that provides mechanism for a ViewModel to define the property.

Declaration

cs-api-definition
public DataPointBinding IsSelectedBinding { get; set; }

Property Value

DataPointBinding

ItemsSource

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

Declaration

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

Property Value

IEnumerable

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>

PaletteIndex

Gets or sets the preferred palette index for this series. By default the palette index is equal to the index of this series within the owning chart's Series collection. Set this value to -1 to reset it to its default value and have the CollectionIndex-based logic applied.

Declaration

cs-api-definition
public int PaletteIndex { get; set; }

Property Value

int

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

Methods

ApplyTemplateCore()

Applies the pan transformation to the render surface template part and initializes any data bindings specified.

Declaration

cs-api-definition
protected override bool ApplyTemplateCore()

Returns

bool

Overrides PresenterBase.ApplyTemplateCore()

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>

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 method.

Declaration

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

Parameters

touchRect

Rect

The touch rectangle.

Returns

IEnumerable<DataPoint>

HitTestDataPointsCore(Rect, bool)

Performs the core logic behind the HitTestDataPoints method.

Declaration

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

Parameters

touchRect

Rect

The touch rectangle.

includeAllDataPoints

bool

True to return all data points in the touch rectangle.

Returns

IEnumerable<DataPoint>

HitTestElementsCore(Rect, bool, bool)

Performs the core logic behind the HitTestElements method.

Declaration

cs-api-definition
protected virtual IEnumerable<FrameworkElement> HitTestElementsCore(Rect touchRect, bool dataPointsOnly, bool includeAllElements)

Parameters

touchRect

Rect

dataPointsOnly

bool

includeAllElements

bool

Returns

IEnumerable<FrameworkElement>

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()

OnCreateAutomationPeer()

Declaration

cs-api-definition
protected override AutomationPeer OnCreateAutomationPeer()

Returns

AutomationPeer

Overrides RadControl.OnCreateAutomationPeer()

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)

OnTemplateApplied()

Occurs when the method has been called and the template is already successfully applied.

Declaration

cs-api-definition
protected override void OnTemplateApplied()

Overrides RadControl.OnTemplateApplied()

SelectRectPoints(ref Rect)

Returns an array of rectangle .

Declaration

cs-api-definition
protected virtual Point[] SelectRectPoints(ref Rect touchRect)

Parameters

touchRect

Rect

Returns

Point[]

Events

DataBindingComplete

Occurs when a data binding operation has been successfully completed.

Declaration

cs-api-definition
public event EventHandler DataBindingComplete

Event Value

EventHandler