skip navigation
  • Product Bundles

    DevCraft

    All Telerik .NET tools and Kendo UI JavaScript components in one package. Now enhanced with:

    • NEW: Design Kits for Figma
    • Online Training
    • Document Processing Library
    • Embedded Reporting for web and desktop

    Web

    Kendo UI UI for jQuery UI for Angular UI for React UI for Vue UI for Blazor UI for ASP.NET Core UI for ASP.NET MVC UI for ASP.NET AJAX

    Mobile

    UI for .NET MAUI

    Document Management

    Telerik Document Processing

    Desktop

    UI for .NET MAUI UI for WinUI UI for WinForms UI for WPF

    Reporting

    Telerik Reporting Telerik Report Server

    Testing & Mocking

    Test Studio Test Studio Dev Edition Telerik JustMock

    CMS

    Sitefinity

    UI/UX Tools

    ThemeBuilder Design System Kit Templates and Building Blocks

    Debugging

    Fiddler Fiddler Everywhere Fiddler Classic Fiddler Everywhere Reporter FiddlerCore

    Free Tools

    VB.NET to C# Converter Testing Framework
    View all products
  • Overview
  • Demos
    • What's New
    • Roadmap
    • Release History
  • Support and Learning

    • Support and Learning Hub
    • First Steps
    • Docs
    • Demos
    • Virtual Classroom
    • Forums
    • Videos
    • Blogs
    • Accessibility
    • Submit a Ticket

    Productivity and Design Tools

    • Visual Studio Extensions
    • Visual Studio Templates
    • Embedded Reporting
  • Pricing
  • Shopping cart
    • Account Overview
    • Your Licenses
    • Downloads
    • Support Center
    • Forum Profile
    • Payment Methods
    • Edit Profile
    • Log out
  • Login
  • Contact Us
  • Try now

Class ChartArea

This class represents a layout region of the RadChart control that holds certain chart series and axis data.

Inheritance
System.Object
ChartArea
Namespace: Telerik.Windows.Controls.Charting
Assembly: Telerik.Windows.Controls.Charting.dll

Syntax

public class ChartArea : ItemsControl, INotifyPropertyChanged, ILogicalItem, IChartThemable, IInteractionManager, IInteractiveElement, IChartExtensibleObject<ChartArea>
Remarks

By default RadChart comes with a single default ChartArea but the control supports multiple ChartAreas that you can add either declaratively from xaml or from code behind.

Constructors

ChartArea()

Initializes a new instance of the ChartArea class.

Declaration
public ChartArea()

Fields

AdditionalYAxesProperty

Identifies the AdditionalYAxes dependency property.

Declaration
public static readonly DependencyProperty AdditionalYAxesProperty
Field Value
System.Windows.DependencyProperty

AnnotationsProperty

Identifies the Annotations dependency property.

Declaration
public static readonly DependencyProperty AnnotationsProperty
Field Value
System.Windows.DependencyProperty

AxisXProperty

Identifies the AxisX dependency property.

Declaration
public static readonly DependencyProperty AxisXProperty
Field Value
System.Windows.DependencyProperty

AxisXStyleProperty

Identifies the AxisXStyle dependency property.

Declaration
public static readonly DependencyProperty AxisXStyleProperty
Field Value
System.Windows.DependencyProperty

AxisYProperty

Identifies the AxisY dependency property.

Declaration
public static readonly DependencyProperty AxisYProperty
Field Value
System.Windows.DependencyProperty

AxisYStyleProperty

Identifies the AxisYStyle dependency property.

Declaration
public static readonly DependencyProperty AxisYStyleProperty
Field Value
System.Windows.DependencyProperty

ChartAreaProperty

Identifies the ChartArea.RootChart attached property.

Declaration
public static readonly DependencyProperty ChartAreaProperty
Field Value
System.Windows.DependencyProperty

CommandParameterProperty

Identifies the CommandParameter dependency property.

Declaration
public static readonly DependencyProperty CommandParameterProperty
Field Value
System.Windows.DependencyProperty

CommandProperty

Identifies the Command dependency property.

Declaration
public static readonly DependencyProperty CommandProperty
Field Value
System.Windows.DependencyProperty

DimensionModeProperty

Identifies the ChartArea.DimensionMode attached property.

Declaration
public static readonly DependencyProperty DimensionModeProperty
Field Value
System.Windows.DependencyProperty

DragZoomLayerControlStyleProperty

Identifies the DragZoomLayerControlStyle dependency property.

Declaration
public static readonly DependencyProperty DragZoomLayerControlStyleProperty
Field Value
System.Windows.DependencyProperty

DragZoomSelectionStyleProperty

Identifies the DragZoomSelectionStyle dependency property.

Declaration
public static readonly DependencyProperty DragZoomSelectionStyleProperty
Field Value
System.Windows.DependencyProperty

EnableAnimationsProperty

Identifies the EnableAnimations dependency property.

Declaration
public static readonly DependencyProperty EnableAnimationsProperty
Field Value
System.Windows.DependencyProperty

EnableStripLinesAnimationProperty

Identifies the EnableStripLinesAnimation dependency property.

Declaration
public static readonly DependencyProperty EnableStripLinesAnimationProperty
Field Value
System.Windows.DependencyProperty

EnableTransitionAnimationsProperty

Identifies the EnableTransitionAnimations dependency property.

Declaration
public static readonly DependencyProperty EnableTransitionAnimationsProperty
Field Value
System.Windows.DependencyProperty

ExtensionsProperty

Identifies the Extensions dependency property.

Declaration
public static readonly DependencyProperty ExtensionsProperty
Field Value
System.Windows.DependencyProperty

HoveredItemsProperty

Identifies the HoveredItems dependency property.

Declaration
public static readonly DependencyProperty HoveredItemsProperty
Field Value
System.Windows.DependencyProperty

HoveredSeriesProperty

Identifies the HoveredSeries dependency property.

Declaration
public static readonly DependencyProperty HoveredSeriesProperty
Field Value
System.Windows.DependencyProperty

IsNoDataMessageEnabledProperty

Identifies the IsNoDataMessageEnabled dependency property.

Declaration
public static readonly DependencyProperty IsNoDataMessageEnabledProperty
Field Value
System.Windows.DependencyProperty

ItemOverlapPercentProperty

Identifies the ItemOverlapPercent dependency property.

Declaration
public static readonly DependencyProperty ItemOverlapPercentProperty
Field Value
System.Windows.DependencyProperty

ItemToolTipDelayProperty

Identifies the ItemToolTipDelay dependency property.

Declaration
public static readonly DependencyProperty ItemToolTipDelayProperty
Field Value
System.Windows.DependencyProperty

ItemWidthPercentProperty

Identifies the ItemWidthPercent dependency property.

Declaration
public static readonly DependencyProperty ItemWidthPercentProperty
Field Value
System.Windows.DependencyProperty

LabelFormatBehaviorProperty

Identifies the LabelFormatBehavior dependency property.

Declaration
public static readonly DependencyProperty LabelFormatBehaviorProperty
Field Value
System.Windows.DependencyProperty

LegendProperty

Identifies the Legend dependency property.

Declaration
public static readonly DependencyProperty LegendProperty
Field Value
System.Windows.DependencyProperty

NoDataControlStyleProperty

Identifies the NoDataControlStyle dependency property.

Declaration
public static readonly DependencyProperty NoDataControlStyleProperty
Field Value
System.Windows.DependencyProperty

NoDataStringProperty

Identifies the NoDataString dependency property.

Declaration
public static readonly DependencyProperty NoDataStringProperty
Field Value
System.Windows.DependencyProperty

PaletteBrushesProperty

Identifies the PaletteBrushes dependency property.

Declaration
public static readonly DependencyProperty PaletteBrushesProperty
Field Value
System.Windows.DependencyProperty

PaletteBrushesRepeatProperty

Identifies the PaletteBrushesRepeat dependency property.

Declaration
public static readonly DependencyProperty PaletteBrushesRepeatProperty
Field Value
System.Windows.DependencyProperty

PlotAreaAxisXStyleProperty

Identifies the PlotAreaAxisXStyle dependency property.

Declaration
public static readonly DependencyProperty PlotAreaAxisXStyleProperty
Field Value
System.Windows.DependencyProperty

PlotAreaAxisYStyleProperty

Identifies the PlotAreaAxisYStyle dependency property.

Declaration
public static readonly DependencyProperty PlotAreaAxisYStyleProperty
Field Value
System.Windows.DependencyProperty

PlotAreaMouseLeftButtonDownEvent

Identifies the PlotAreaMouseLeftButtonDown event.

Declaration
public static readonly RoutedEvent PlotAreaMouseLeftButtonDownEvent
Field Value
System.Windows.RoutedEvent

PlotAreaMouseLeftButtonUpEvent

Identifies the PlotAreaMouseLeftButtonUp event.

Declaration
public static readonly RoutedEvent PlotAreaMouseLeftButtonUpEvent
Field Value
System.Windows.RoutedEvent

PlotAreaStyleProperty

Identifies the PlotAreaStyle dependency property.

Declaration
public static readonly DependencyProperty PlotAreaStyleProperty
Field Value
System.Windows.DependencyProperty

PreviewPlotAreaMouseLeftButtonDownEvent

Identifies the PreviewPlotAreaMouseLeftButtonDown event.

Declaration
public static readonly RoutedEvent PreviewPlotAreaMouseLeftButtonDownEvent
Field Value
System.Windows.RoutedEvent

PreviewPlotAreaMouseLeftButtonUpEvent

Identifies the PreviewPlotAreaMouseLeftButtonUp event.

Declaration
public static readonly RoutedEvent PreviewPlotAreaMouseLeftButtonUpEvent
Field Value
System.Windows.RoutedEvent

ScientificDigitsProperty

Identifies the ScientificDigits dependency property.

Declaration
public static readonly DependencyProperty ScientificDigitsProperty
Field Value
System.Windows.DependencyProperty

SelectedItemsProperty

Identifies the SelectedItems dependency property.

Declaration
public static readonly DependencyProperty SelectedItemsProperty
Field Value
System.Windows.DependencyProperty

SelectedSeriesProperty

Identifies the SelectedSeries dependency property.

Declaration
public static readonly DependencyProperty SelectedSeriesProperty
Field Value
System.Windows.DependencyProperty

SeriesStylesProperty

Identifies the SeriesStyles dependency property.

Declaration
public static readonly DependencyProperty SeriesStylesProperty
Field Value
System.Windows.DependencyProperty

Template2DProperty

Identifies the Template2D dependency property.

Declaration
public static readonly DependencyProperty Template2DProperty
Field Value
System.Windows.DependencyProperty

Template3DProperty

Identifies the Template3D dependency property.

Declaration
public static readonly DependencyProperty Template3DProperty
Field Value
System.Windows.DependencyProperty

TransitionControlStyleProperty

Identifies the TransitionControlStyle dependency property.

Declaration
public static readonly DependencyProperty TransitionControlStyleProperty
Field Value
System.Windows.DependencyProperty

ZoomScrollSettingsXProperty

Identifies the ZoomScrollSettingsX dependency property.

Declaration
public static readonly DependencyProperty ZoomScrollSettingsXProperty
Field Value
System.Windows.DependencyProperty

ZoomScrollSettingsYProperty

Identifies the ZoomScrollSettingsY dependency property.

Declaration
public static readonly DependencyProperty ZoomScrollSettingsYProperty
Field Value
System.Windows.DependencyProperty

Properties

AdditionalYAxes

Gets or sets the additional Y axes collection.

Declaration
public AxisYCollection AdditionalYAxes { get; set; }
Property Value
AxisYCollection

The additional Y axes collection.

AnimationSettings

Gets or sets the animation settings.

Declaration
public AnimationSettings AnimationSettings { get; set; }
Property Value
AnimationSettings

The animation settings.

Annotations

Gets or sets the Annotations.

Declaration
public AnnotationCollection Annotations { get; set; }
Property Value
AnnotationCollection

AxisX

Gets or sets the AxisX.

Declaration
public AxisX AxisX { get; set; }
Property Value
AxisX

The property.

AxisXStyle

Gets or sets style applied on the horizontal axis.

Declaration
public Style AxisXStyle { get; set; }
Property Value
System.Windows.Style

AxisY

Gets or sets the AxisY.

Declaration
public AxisY AxisY { get; set; }
Property Value
AxisY

The property.

AxisYStyle

Gets or sets the style applied on the vertical axis.

Declaration
public Style AxisYStyle { get; set; }
Property Value
System.Windows.Style

Command

Gets or sets the command.

Declaration
public ICommand Command { get; set; }
Property Value
System.Windows.Input.ICommand

The command.

CommandParameter

Gets or sets the command parameter.

Declaration
public object CommandParameter { get; set; }
Property Value
System.Object

The command parameter.

ControlContainer

This property supports the RadChart infrastructure and is not intended to be used directly from your code.

Declaration
public Panel ControlContainer { get; }
Property Value
System.Windows.Controls.Panel

DataSeries

Gets the collection of data series associated with the chart area.

Declaration
public DataSeriesCollection DataSeries { get; }
Property Value
DataSeriesCollection

DimensionMode

Gets or sets a value indicating whether the chart area should display 2D or 3D chart series types.

Declaration
public DimensionMode DimensionMode { get; set; }
Property Value
DimensionMode

The dimension mode used by the chart area.

DragZoomLayerControlStyle

Gets or sets the drag zoom layer control style.

Declaration
public Style DragZoomLayerControlStyle { get; set; }
Property Value
System.Windows.Style

The drag zoom layer control style.

DragZoomSelectionStyle

Gets or sets the drag-zoom selection style.

Declaration
public Style DragZoomSelectionStyle { get; set; }
Property Value
System.Windows.Style

The drag-zoom selection style.

EnableAnimations

Gets or sets the property indicating whether animations should be applied on the chart or not.

Declaration
public bool EnableAnimations { get; set; }
Property Value
System.Boolean

The property indicating whether animations should be applied on the chart or not.

EnableStripLinesAnimation

Gets or sets the property indicating whether animation should be applied on the strip lines or not.

Declaration
public bool EnableStripLinesAnimation { get; set; }
Property Value
System.Boolean

The property indicating whether animations should be applied on the strip lines or not.

EnableTransitionAnimations

Gets or sets the property indicating whether transitioning animations should be applied when changing chart data.

Declaration
public bool EnableTransitionAnimations { get; set; }
Property Value
System.Boolean

Remarks

Transitioning animations are supported for the built-in hierarchical data (drill-down), zooming & scrolling, and scenarios that utilize the built-in integration with RadTimeBar; otherwise you can use the ChartArea.StartTransitionAnimation() method to trigger the transition programmatically.

Extensions

Gets a collection of chart extension objects attached to the chart area.

Declaration
public ChartExtensionCollection Extensions { get; }
Property Value
ChartExtensionCollection

HoveredItems

Gets or sets the HoveredItems.

Declaration
public ReadOnlyDataPointCollection HoveredItems { get; }
Property Value
ReadOnlyDataPointCollection

HoveredSeries

Gets or sets the HoveredSeries.

Declaration
public ReadOnlyDataSeriesCollection HoveredSeries { get; }
Property Value
ReadOnlyDataSeriesCollection

IsNoDataMessageEnabled

Gets or sets a value indicating whether the "NoData" message enabled.

Declaration
public bool IsNoDataMessageEnabled { get; set; }
Property Value
System.Boolean

ItemOverlapPercent

Gets or sets the item overlap percent.

Declaration
public int ItemOverlapPercent { get; set; }
Property Value
System.Int32

The item overlap percent.

Remarks

This property will apply only for 2D charts.

ItemToolTipDelay

Gets or sets the series items tooltip delay in milliseconds.

Declaration
public int ItemToolTipDelay { get; set; }
Property Value
System.Int32

ItemWidthPercent

Gets or sets the item width percent.

Declaration
public int ItemWidthPercent { get; set; }
Property Value
System.Int32

The item width percent.

LabelFormatBehavior

Gets or sets the number format behavior.

Declaration
public LabelFormatBehavior LabelFormatBehavior { get; set; }
Property Value
LabelFormatBehavior

The number format behavior.

Legend

Gets or sets a value indicating the legend that should be associated with the chart area. This is a dependency property.

Declaration
public ChartLegend Legend { get; set; }
Property Value
ChartLegend

The legend to associate with the chart area.

LegendName

Gets or sets the element name of the legend control that should be associated with the chart area.

Declaration
public string LegendName { get; set; }
Property Value
System.String

Remarks

This property is useful when setting the necessary associations between the chart area and the legend declaratively in xaml. Alternatively you can use the ChartArea.Legend property from code behind as well.

NoDataControlStyle

Gets or sets the no data control style.

Declaration
public Style NoDataControlStyle { get; set; }
Property Value
System.Windows.Style

The no data control style.

NoDataString

Gets or sets the string value which is shown in case of no DataSeries set.

Declaration
public string NoDataString { get; set; }
Property Value
System.String

The actual value to be shown.

PaletteBrushes

Gets or sets the brushes that are to be used with the Series.

Declaration
public BrushCollection PaletteBrushes { get; set; }
Property Value
BrushCollection

The series brushes.

PaletteBrushesRepeat

Gets or sets value indicating whether the brushes added will be used in cyclic fashion.

Declaration
public bool PaletteBrushesRepeat { get; set; }
Property Value
System.Boolean

The series brushes.

PlotAreaAxisXStyle

Gets or sets the style applied on the horizontal axis rendered inside the PlotArea.

Declaration
public Style PlotAreaAxisXStyle { get; set; }
Property Value
System.Windows.Style

PlotAreaAxisYStyle

Gets or sets the style applied on the vertical axis rendered inside the PlotArea.

Declaration
public Style PlotAreaAxisYStyle { get; set; }
Property Value
System.Windows.Style

PlotAreaStyle

Gets or sets the plot area style.

Declaration
public Style PlotAreaStyle { get; set; }
Property Value
System.Windows.Style

The plot area style.

ScientificDigits

Determines the threshold of significant zeroes which trigger formatting of numbers with scientific notation.

Declaration
public int ScientificDigits { get; set; }
Property Value
System.Int32

The number of significant zeroes which trigger the formatting.

SelectedItems

Gets or sets the data points associated with the selected items in the respective ChartArea.

Declaration
public ReadOnlyDataPointCollection SelectedItems { get; }
Property Value
ReadOnlyDataPointCollection

SelectedSeries

Gets or sets the SelectedSeries.

Declaration
public ReadOnlyDataSeriesCollection SelectedSeries { get; }
Property Value
ReadOnlyDataSeriesCollection

SeriesStyles

Gets or sets the series styles container.

Declaration
public SeriesStyles SeriesStyles { get; set; }
Property Value
SeriesStyles

The series styles container.

SmartLabelsEnabled

Gets or sets a value indicating whether smart labels positioning algorithm should be enabled.

Declaration
public bool SmartLabelsEnabled { get; set; }
Property Value
System.Boolean

True if [smart labels enabled]; otherwise, false.

Template2D

Gets or sets a value indicating the template applied to two-dimensional chart area. This is a dependency property.

Declaration
public ControlTemplate Template2D { get; set; }
Property Value
System.Windows.Controls.ControlTemplate

The 2D control template.

Template3D

Gets or sets a value indicating the template applied to three-dimensional chart area. This is a dependency property.

Declaration
public ControlTemplate Template3D { get; set; }
Property Value
System.Windows.Controls.ControlTemplate

The 3D control template.

TransitionControl

Gets the transition control responsible for handling of the transitioning animations.

Declaration
public RadTransitionControl TransitionControl { get; }
Property Value
RadTransitionControl

Remarks

Transitioning animations are supported for the built-in hierarchical data (drill-down) and zooming & scrolling scenarios; otherwise you can use the ChartArea.StartTransitionAnimation() method to trigger the transition programmatically.

TransitionControlStyle

Gets or sets the style applied to the transition control responsible for handling of the transitioning animations.

Declaration
public Style TransitionControlStyle { get; set; }
Property Value
System.Windows.Style

Remarks

Transitioning animations are supported for the built-in hierarchical data (drill-down) and zooming & scrolling scenarios; otherwise you can use the ChartArea.StartTransitionAnimation() method to trigger the transition programmatically.

ZoomScrollSettingsX

Gets or sets the zoom and scroll settings for AxisX.

Declaration
public ZoomScrollSettings ZoomScrollSettingsX { get; set; }
Property Value
ZoomScrollSettings

The ZoomScrollSettings.

ZoomScrollSettingsY

Gets or sets the zoom and scroll settings for AxisY.

Declaration
public ZoomScrollSettings ZoomScrollSettingsY { get; set; }
Property Value
ZoomScrollSettings

The ZoomScrollSettings.

Methods

add_ItemToolTipClosing(ItemToolTipEventHandler)

Declaration
public void add_ItemToolTipClosing(ItemToolTipEventHandler value)
Parameters
ItemToolTipEventHandler value

add_ItemToolTipOpening(ItemToolTipEventHandler)

Declaration
public void add_ItemToolTipOpening(ItemToolTipEventHandler value)
Parameters
ItemToolTipEventHandler value

ClearContainerForItemOverride(DependencyObject, Object)

When overridden in a derived class, undoes the effects of the System.Windows.Controls.ItemsControl.PrepareContainerForItemOverride(System.Windows.DependencyObject,System.Object) method.

Declaration
protected override void ClearContainerForItemOverride(DependencyObject element, object item)
Parameters
System.Windows.DependencyObject element

The container element.

System.Object item

The item.

ClearSelection()

Clears the selection state for all selected items / series associated with the respective ChartArea.

Declaration
public void ClearSelection()
Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

GetAxis(String)

Gets the Y-axis related to the axisName.

Declaration
public AxisY GetAxis(string axisName)
Parameters
System.String axisName

AxisName of the Y-axis.

Returns
AxisY

The corresponding Y-axis.

GetAxis(DataSeries)

Gets the Y-axis related to the series.

Declaration
public AxisY GetAxis(DataSeries series)
Parameters
DataSeries series

The data series.

Returns
AxisY

The corresponding Y-axis.

GetContainerForItemOverride()

Creates or identifies the element that is used to display the given item.

Declaration
protected override DependencyObject GetContainerForItemOverride()
Returns
System.Windows.DependencyObject

The element that is used to display the given item.

IsItemItsOwnContainerOverride(Object)

Determines if the specified item is (or is eligible to be) its own container.

Declaration
protected override bool IsItemItsOwnContainerOverride(object item)
Parameters
System.Object item

The item to check.

Returns
System.Boolean

Returns true if the item is (or is eligible to be) its own container; otherwise, false.

MeasureOverride(Size)

Called to measure a control.

Declaration
protected override Size MeasureOverride(Size availableSize)
Parameters
System.Windows.Size availableSize

The maximum size that the method can return.

Returns
System.Windows.Size

The size of the control, up to the maximum specified by availableSize.

OnApplyTemplate()

When overridden in a derived class, is invoked whenever application code or internal processes call System.Windows.FrameworkElement.ApplyTemplate.

Declaration
public override void OnApplyTemplate()

OnHoverStateChanged(ChartHoverChangedEventArgs)

Raises the HoverStateChanged event.

Declaration
protected virtual void OnHoverStateChanged(ChartHoverChangedEventArgs args)
Parameters
ChartHoverChangedEventArgs args

The ChartHoverChangedEventArgs instance containing the event data.

OnInitialized(EventArgs)

Raises the System.Windows.FrameworkElement.Initialized event. This method is invoked whenever System.Windows.FrameworkElement.IsInitialized is set to true internally.

Declaration
protected override void OnInitialized(EventArgs e)
Parameters
System.EventArgs e

The System.Windows.RoutedEventArgs that contains the event data.

OnPropertyChanged(PropertyChangedEventArgs)

Raises the PropertyChanged event.

Declaration
protected virtual void OnPropertyChanged(PropertyChangedEventArgs e)
Parameters
System.ComponentModel.PropertyChangedEventArgs e

The System.ComponentModel.PropertyChangedEventArgs instance containing the event data.

OnSelectionChanged(ChartSelectionChangedEventArgs)

Raises the SelectionChanged event.

Declaration
protected virtual void OnSelectionChanged(ChartSelectionChangedEventArgs args)
Parameters
ChartSelectionChangedEventArgs args

The ChartSelectionChangedEventArgs instance containing the event data.

PrepareContainerForItemOverride(DependencyObject, Object)

Prepares the specified element to display the specified item.

Declaration
protected override void PrepareContainerForItemOverride(DependencyObject element, object item)
Parameters
System.Windows.DependencyObject element

Element used to display the specified item.

System.Object item

Specified item.

remove_ItemToolTipClosing(ItemToolTipEventHandler)

Declaration
public void remove_ItemToolTipClosing(ItemToolTipEventHandler value)
Parameters
ItemToolTipEventHandler value

remove_ItemToolTipOpening(ItemToolTipEventHandler)

Declaration
public void remove_ItemToolTipOpening(ItemToolTipEventHandler value)
Parameters
ItemToolTipEventHandler value

ResetTheme()

Resets the theme.

Declaration
public void ResetTheme()

SelectItem(Int32)

Selects series item based on its item index in the first DataSeries associated with the respective ChartArea.

Declaration
public void SelectItem(int itemIndex)
Parameters
System.Int32 itemIndex

Series item index.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

SelectItem(Int32, Int32)

Selects series item based on its item index in the DataSeries at the specified series index.

Declaration
public void SelectItem(int seriesIndex, int itemIndex)
Parameters
System.Int32 seriesIndex

Series index.

System.Int32 itemIndex

Series item index.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

SelectItem(String, Int32)

Selects series item based on its item index in the DataSeries associated with the respective series name.

Declaration
public void SelectItem(string seriesName, int itemIndex)
Parameters
System.String seriesName

Series name.

System.Int32 itemIndex

Series item index.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

SelectItem(DataPoint)

Selects series item based on its associated data point.

Declaration
public void SelectItem(DataPoint dataPoint)
Parameters
DataPoint dataPoint

The data point.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

SelectItem(DataSeries, Int32)

Selects series item based on its item index in the respective DataSeries.

Declaration
public void SelectItem(DataSeries series, int itemIndex)
Parameters
DataSeries series

The data series.

System.Int32 itemIndex

Series item index.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

SelectItems(IEnumerable<Int32>)

Selects series items based on their item indices in the first DataSeries associated with the respective ChartArea.

Declaration
public void SelectItems(IEnumerable<int> itemIndices)
Parameters
System.Collections.Generic.IEnumerable<System.Int32> itemIndices

Series item indices.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

SelectItems(IEnumerable<DataPoint>)

Selects series items based on their associated data points.

Declaration
public void SelectItems(IEnumerable<DataPoint> dataPoints)
Parameters
System.Collections.Generic.IEnumerable<DataPoint> dataPoints

The data points.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

SelectItems(Int32, IEnumerable<Int32>)

Selects series items based on their item indices in the DataSeries at the specified series index.

Declaration
public void SelectItems(int seriesIndex, IEnumerable<int> itemIndices)
Parameters
System.Int32 seriesIndex

Series index.

System.Collections.Generic.IEnumerable<System.Int32> itemIndices

Series item indices.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

SelectItems(String, IEnumerable<Int32>)

Selects series items based on their item indices in the DataSeries associated with the respective series name.

Declaration
public void SelectItems(string seriesName, IEnumerable<int> itemIndices)
Parameters
System.String seriesName

Series name.

System.Collections.Generic.IEnumerable<System.Int32> itemIndices

Series item indices.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

SelectItems(DataSeries, IEnumerable<Int32>)

Selects series items based on their item indices in the respective DataSeries.

Declaration
public void SelectItems(DataSeries series, IEnumerable<int> itemIndices)
Parameters
DataSeries series

The data series.

System.Collections.Generic.IEnumerable<System.Int32> itemIndices

Series item indices.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

SelectSeries()

Selects the first series in the respective ChartArea.

Declaration
public void SelectSeries()
Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

SelectSeries(IEnumerable<Int32>)

Selects multiple series based on their associated data series.

Declaration
public void SelectSeries(IEnumerable<int> seriesIndices)
Parameters
System.Collections.Generic.IEnumerable<System.Int32> seriesIndices

The series indices.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

SelectSeries(IEnumerable<String>)

Selects multiple series based on their associated series names.

Declaration
public void SelectSeries(IEnumerable<string> seriesNames)
Parameters
System.Collections.Generic.IEnumerable<System.String> seriesNames

The series names.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

SelectSeries(IEnumerable<DataSeries>)

Selects multiple series based on their associated data series.

Declaration
public void SelectSeries(IEnumerable<DataSeries> seriesCollection)
Parameters
System.Collections.Generic.IEnumerable<DataSeries> seriesCollection

The data series.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

SelectSeries(Int32)

Selects the series at the specified series index in the respective ChartArea.

Declaration
public void SelectSeries(int seriesIndex)
Parameters
System.Int32 seriesIndex

Series index.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

SelectSeries(String)

Selects series based on the specified series name.

Declaration
public void SelectSeries(string seriesName)
Parameters
System.String seriesName

Series name.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

SelectSeries(DataSeries)

Selects series based on its associated data series.

Declaration
public void SelectSeries(DataSeries series)
Parameters
DataSeries series

The data series.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

StartTransitionAnimation()

Starts the transition animation programmatically.

Declaration
public void StartTransitionAnimation()
Remarks

This method is designed for custom scenarios where transition animation should be started conditionally and can be used even if ChartArea.EnableTransitionAnimations property is set to false.

ToString()

Returns a System.String that represents this instance.

Declaration
public override string ToString()
Returns
System.String

A System.String that represents this instance.

UnselectItem(Int32)

Unselects series item based on its item index in the first DataSeries associated with the respective ChartArea.

Declaration
public void UnselectItem(int itemIndex)
Parameters
System.Int32 itemIndex

Series item index.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

UnselectItem(Int32, Int32)

Unselects series item based on its item index in the DataSeries at the specified series index.

Declaration
public void UnselectItem(int seriesIndex, int itemIndex)
Parameters
System.Int32 seriesIndex

Series index.

System.Int32 itemIndex

Series item index.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

UnselectItem(String, Int32)

Unselects series item based on its item index in the DataSeries associated with the respective series name.

Declaration
public void UnselectItem(string seriesName, int itemIndex)
Parameters
System.String seriesName

Series name.

System.Int32 itemIndex

Series item index.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

UnselectItem(DataPoint)

Unselects series item based on its associated data point.

Declaration
public void UnselectItem(DataPoint dataPoint)
Parameters
DataPoint dataPoint

The data point.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

UnselectItem(DataSeries, Int32)

Unselects series item based on its item index in the respective DataSeries.

Declaration
public void UnselectItem(DataSeries series, int itemIndex)
Parameters
DataSeries series

The data series.

System.Int32 itemIndex

Series item index.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

UnselectItems(IEnumerable<Int32>)

Unselects series items based on their item indices in the first DataSeries associated with the respective ChartArea.

Declaration
public void UnselectItems(IEnumerable<int> itemIndices)
Parameters
System.Collections.Generic.IEnumerable<System.Int32> itemIndices

Series item indices.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

UnselectItems(IEnumerable<DataPoint>)

Unselects series items based on their associated data points.

Declaration
public void UnselectItems(IEnumerable<DataPoint> dataPoints)
Parameters
System.Collections.Generic.IEnumerable<DataPoint> dataPoints

The data points.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

UnselectItems(Int32, IEnumerable<Int32>)

Unselects series items based on their item indices in the DataSeries at the specified series index.

Declaration
public void UnselectItems(int seriesIndex, IEnumerable<int> itemIndices)
Parameters
System.Int32 seriesIndex

Series index.

System.Collections.Generic.IEnumerable<System.Int32> itemIndices

Series item indices.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

UnselectItems(String, IEnumerable<Int32>)

Unselects series items based on their item indices in the DataSeries associated with the respective series name.

Declaration
public void UnselectItems(string seriesName, IEnumerable<int> itemIndices)
Parameters
System.String seriesName

Series name.

System.Collections.Generic.IEnumerable<System.Int32> itemIndices

Series item indices.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

UnselectItems(DataSeries, IEnumerable<Int32>)

Unselects series items based on their item indices in the respective DataSeries.

Declaration
public void UnselectItems(DataSeries series, IEnumerable<int> itemIndices)
Parameters
DataSeries series

The data series.

System.Collections.Generic.IEnumerable<System.Int32> itemIndices

Series item indices.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

UnselectSeries()

Unselects the first series in the respective ChartArea.

Declaration
public void UnselectSeries()
Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

UnselectSeries(IEnumerable<Int32>)

Unselects multiple series based on their associated data series.

Declaration
public void UnselectSeries(IEnumerable<int> seriesIndices)
Parameters
System.Collections.Generic.IEnumerable<System.Int32> seriesIndices

The series indices.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

UnselectSeries(IEnumerable<String>)

Unselects multiple series based on their associated series names.

Declaration
public void UnselectSeries(IEnumerable<string> seriesNames)
Parameters
System.Collections.Generic.IEnumerable<System.String> seriesNames

The series names.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

UnselectSeries(IEnumerable<DataSeries>)

Unselects multiple series based on their associated data series.

Declaration
public void UnselectSeries(IEnumerable<DataSeries> seriesCollection)
Parameters
System.Collections.Generic.IEnumerable<DataSeries> seriesCollection

The data series.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

UnselectSeries(Int32)

Unselects the series at the specified series index in the respective ChartArea.

Declaration
public void UnselectSeries(int seriesIndex)
Parameters
System.Int32 seriesIndex

Series index.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

UnselectSeries(String)

Unselects series based on the specified series name.

Declaration
public void UnselectSeries(string seriesName)
Parameters
System.String seriesName

Series name.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

UnselectSeries(DataSeries)

Unselects series based on its associated data series.

Declaration
public void UnselectSeries(DataSeries series)
Parameters
DataSeries series

The data series.

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

Events

HoverChanged

Occurs when the chart hover interactivity has changed.

Declaration
public event EventHandler<ChartHoverChangedEventArgs> HoverChanged
Event Type
System.EventHandler<ChartHoverChangedEventArgs>

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

ItemClick

Occurs when chart item within this ChartArea is clicked.

Declaration
public event EventHandler<ChartItemClickEventArgs> ItemClick
Event Type
System.EventHandler<ChartItemClickEventArgs>

ItemToolTipClosing

Occurs when a series item tooltip is about to be hidden.

Declaration
public event ItemToolTipEventHandler ItemToolTipClosing
Event Type
ItemToolTipEventHandler

ItemToolTipOpening

Occurs when a series item tooltip is about to be displayed.

Declaration
public event ItemToolTipEventHandler ItemToolTipOpening
Event Type
ItemToolTipEventHandler

PlotAreaMouseLeftButtonDown

Occurs when the left mouse button is pressed while the mouse pointer is over the ChartArea.

Declaration
public event EventHandler<PlotAreaMouseEventArgs> PlotAreaMouseLeftButtonDown
Event Type
System.EventHandler<PlotAreaMouseEventArgs>

PlotAreaMouseLeftButtonUp

Occurs when the left mouse button is released while the mouse pointer is over the ChartArea.

Declaration
public event EventHandler<PlotAreaMouseEventArgs> PlotAreaMouseLeftButtonUp
Event Type
System.EventHandler<PlotAreaMouseEventArgs>

PreviewItemClick

Occurs when chart item within this ChartArea is clicked.

Declaration
public event EventHandler<ChartItemClickEventArgs> PreviewItemClick
Event Type
System.EventHandler<ChartItemClickEventArgs>

PreviewPlotAreaMouseLeftButtonDown

Occurs when the left mouse button is pressed while the mouse pointer is over the ChartArea.

Declaration
public event EventHandler<PlotAreaMouseEventArgs> PreviewPlotAreaMouseLeftButtonDown
Event Type
System.EventHandler<PlotAreaMouseEventArgs>

PreviewPlotAreaMouseLeftButtonUp

Occurs when the left mouse button is released while the mouse pointer is over the ChartArea.

Declaration
public event EventHandler<PlotAreaMouseEventArgs> PreviewPlotAreaMouseLeftButtonUp
Event Type
System.EventHandler<PlotAreaMouseEventArgs>

PropertyChanged

Occurs when a property value changes.

Declaration
public event PropertyChangedEventHandler PropertyChanged
Event Type
System.ComponentModel.PropertyChangedEventHandler

SelectionChanged

Occurs when the chart selection has changed.

Declaration
public event EventHandler<ChartSelectionChangedEventArgs> SelectionChanged
Event Type
System.EventHandler<ChartSelectionChangedEventArgs>

Remarks

Note that the interactivity functionality is available for WPF4 / Silverlight projects only.

Explicit Interface Implementations

IChartExtensibleObject<ChartArea>.Extensions

Declaration
IChartExtensionCollection<ChartArea> IChartExtensibleObject<ChartArea>.Extensions { get; }
Returns
IChartExtensionCollection<ChartArea>

Implements
IChartExtensibleObject<T>.Extensions

Extension Methods

CollectionExtensions.ToEnumerable<T>(T)
EnumerableExtensions.ToEnumerable<T>(T)
Getting Started
  • Install Now
  • Demos
  • SDK Samples Browser
  • Sample Applications
Support Resources
  • Code Library
  • Knowledge Base
  • MVVM Support
  • Videos
  • GitHub SDK Repository
Community
  • Forums
  • Blogs
  • XAML Feedback Portal
  • Document Processing Feedback Portal

Copyright © 2018 Progress Software Corporation and/or its subsidiaries or affiliates.
All Rights Reserved.

Progress, Telerik, and certain product names used herein are trademarks or registered trademarks of Progress Software Corporation and/or one of its subsidiaries or affiliates in the U.S. and/or other countries. See Trademarks for appropriate markings.