Documentation

Class ChartView

Inheritance
System.Object
DisposableObject
RadObject
UIChartElement
ChartView
Inherited Members
System.Object.ToString()
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.ChartView.dll

Syntax

public class ChartView : UIChartElement, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, IStylableElement, IStylableNode, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IShapedElement, IChartView, IChartElementPresenter

Constructors

ChartView(IChartViewHost)

Initializes a new instance of the ChartView class.

Declaration
public ChartView(IChartViewHost owner)
Parameters
IChartViewHost owner

The owner.

ChartView(RadChartElement)

Initializes a new instance of the ChartView class.

Declaration
public ChartView(RadChartElement owner)
Parameters
RadChartElement owner

The owner.

ChartView(RadChartView)

Initializes a new instance of the ChartView class.

Declaration
public ChartView(RadChartView owner)
Parameters
RadChartView owner

The owner.

Fields

MarginProperty

Declaration
public static RadProperty MarginProperty
Field Value
RadProperty

MinSizeProperty

Declaration
public static RadProperty MinSizeProperty
Field Value
RadProperty

Properties

Annotations

Gets the annotations.

Declaration
public ChartAnnotationCollection Annotations { get; }
Property Value
ChartAnnotationCollection

The annotations.

Area

Gets the area.

Declaration
public ChartArea Area { get; }
Property Value
ChartArea

The area.

AreaDesign

Gets or sets the area design.

Declaration
public ChartArea AreaDesign { get; set; }
Property Value
ChartArea

The area design.

AreaType

Gets or sets the type of the area.

Declaration
public ChartAreaType AreaType { get; set; }
Property Value
ChartAreaType

The type of the area.

Axes

Gets the axes.

Declaration
public ChartAxisCollection Axes { get; }
Property Value
ChartAxisCollection

The axes.

ClientRectangle

Gets the client rectangle.

Declaration
public RectangleF ClientRectangle { get; }
Property Value
System.Drawing.RectangleF

The client rectangle.

Controllers

Gets the controllers.

Declaration
public ChartViewControllerCollection Controllers { get; }
Property Value
ChartViewControllerCollection

The controllers.

DataMember

Gets or sets the name of the list or table in the data source for which the ChartSeries is bound.

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

DataSource

Gets or sets the data source of the ChartSeries.

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

Margin

Gets or sets the margin.

Declaration
public Padding Margin { get; set; }
Property Value
System.Windows.Forms.Padding

The margin.

MinSize

Gets or sets the minimum size.

Declaration
public SizeF MinSize { get; set; }
Property Value
System.Drawing.SizeF

The size of the min.

Owner

Gets or sets the owner.

Declaration
public IChartViewHost Owner { get; set; }
Property Value
IChartViewHost

The owner.

Palette

Gets or sets the palette.

Declaration
public ChartPalette Palette { get; set; }
Property Value
ChartPalette

The palette.

Renderer

Gets the renderer.

Declaration
public IChartRenderer Renderer { get; }
Property Value
IChartRenderer

The renderer.

SelectionMode

Gets or sets the selection mode.

Declaration
public ChartSelectionMode SelectionMode { get; set; }
Property Value
ChartSelectionMode

The selection mode.

Series

Gets the series.

Declaration
public ChartSeriesCollection Series { get; }
Property Value
ChartSeriesCollection

The series.

ShowPanZoom

Gets or sets whether the pan and zoom controller will be activated.

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

The show pan zoom.

ShowSmartLabels

Gets or sets whether to show the smart labels.

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

The show smart labels.

ShowStillIndicators

Gets or sets whether to show the still indicators.

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

Indicates whether to show still indicators.

ShowToolTip

Gets or sets whether the tool tip will be shown.

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

The show tool tip.

ShowTrackBall

Gets or sets whether the track ball will be shown.

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

The show track ball.

UseDataSource

Automatically setup DataSource of ChartSeries on attaching using this DataSource only when DataSource property of ChartSeries is null

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

ViewName

Gets or sets the name of the view.

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

The name of the view.

Viewport

Gets or sets the viewport.

Declaration
public RadRect Viewport { get; set; }
Property Value
RadRect

The viewport.

ViewResult

Gets or sets the view result.

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

The view result.

Methods

DeferRefresh()

Defers the refresh.

Declaration
public virtual IDisposable DeferRefresh()
Returns
System.IDisposable

Draw(Object)

Draws the specified context.

Declaration
public virtual void Draw(object context)
Parameters
System.Object context

The context.

GetArea<T>()

Gets the area.

Declaration
public T GetArea<T>()
    where T : ChartArea
Returns
T

Type Parameters
T

The type of the T.

Layout()

Layouts the chart.

Declaration
public void Layout()

Layout(Boolean)

Layouts the chart indicating whether to invalidate.

Declaration
public void Layout(bool redraw)
Parameters
System.Boolean redraw

The redraw.

Layout(RadRect)

Layouts in the specified rect.

Declaration
public void Layout(RadRect rect)
Parameters
RadRect rect

The rect.

OnAttached(UIChartElement)

Called when [attached].

Declaration
protected override void OnAttached(UIChartElement parent)
Parameters
UIChartElement parent

The parent.
Overrides

OnAxisLabelFormatting(Object, ChartAxisLabelFormattingEventArgs)

Called when formatting axes' labels.

Declaration
protected virtual void OnAxisLabelFormatting(object sender, ChartAxisLabelFormattingEventArgs e)
Parameters
System.Object sender

The label element.
ChartAxisLabelFormattingEventArgs e

The ChartAxisLabelFormattingEventArgs instance containing the event data.

OnCreatePoint(ChartViewCreatePointEventArgs)

Raises the CreatePoint event.

Declaration
protected virtual void OnCreatePoint(ChartViewCreatePointEventArgs e)
Parameters
ChartViewCreatePointEventArgs e

The ChartViewCreatePointEventArgs instance containing the event data.

OnCreatePointElement(ChartViewCreatePointElementEventArgs)

Raises the CreatePointElement event.

Declaration
protected virtual void OnCreatePointElement(ChartViewCreatePointElementEventArgs e)
Parameters
ChartViewCreatePointElementEventArgs e

The ChartViewCreatePointElementEventArgs instance containing the event data.

OnCreateRenderer(Object, ChartViewCreateRendererEventArgs)

Fires the CreateRenderer event.

Declaration
protected virtual void OnCreateRenderer(object sender, ChartViewCreateRendererEventArgs e)
Parameters
System.Object sender

The sender.
ChartViewCreateRendererEventArgs e

The ChartViewCreateRendererEventArgs instance containing the event data.

OnDataError(Exception)

Called when data error occurs.

Declaration
protected virtual void OnDataError(Exception exception)
Parameters
System.Exception exception

The exception.

OnGesture(GestureEventArgs)

Raises the Gesture event.

Declaration
protected virtual void OnGesture(GestureEventArgs e)
Parameters
GestureEventArgs e

The GestureEventArgs instance containing the event data.

OnKeyDown(KeyEventArgs)

Raises the KeyDown event.

Declaration
protected virtual void OnKeyDown(KeyEventArgs e)
Parameters
System.Windows.Forms.KeyEventArgs e

The System.Windows.Forms.KeyEventArgs instance containing the event data.

OnKeyPress(KeyPressEventArgs)

Raises the KeyPress event.

Declaration
protected virtual void OnKeyPress(KeyPressEventArgs e)
Parameters
System.Windows.Forms.KeyPressEventArgs e

The System.Windows.Forms.KeyPressEventArgs instance containing the event data.

OnKeyUp(KeyEventArgs)

Raises the KeyUp event.

Declaration
protected virtual void OnKeyUp(KeyEventArgs e)
Parameters
System.Windows.Forms.KeyEventArgs e

The System.Windows.Forms.KeyEventArgs instance containing the event data.

OnLabelFormatting(Object, ChartViewLabelFormattingEventArgs)

Raises the LabelFormatting event

Declaration
protected virtual void OnLabelFormatting(object sender, ChartViewLabelFormattingEventArgs e)
Parameters
System.Object sender

ChartViewLabelFormattingEventArgs e

OnMouseCaptureChanged(EventArgs)

Raises the MouseCaptureChanged event.

Declaration
protected virtual void OnMouseCaptureChanged(EventArgs e)
Parameters
System.EventArgs e

The System.EventArgs instance containing the event data.

OnMouseClick(MouseEventArgs)

Raises the MouseClick event.

Declaration
protected virtual void OnMouseClick(MouseEventArgs e)
Parameters
System.Windows.Forms.MouseEventArgs e

The System.Windows.Forms.MouseEventArgs instance containing the event data.

OnMouseDoubleClick(MouseEventArgs)

Raises the MouseDoubleClick event.

Declaration
protected virtual void OnMouseDoubleClick(MouseEventArgs e)
Parameters
System.Windows.Forms.MouseEventArgs e

The System.Windows.Forms.MouseEventArgs instance containing the event data.

OnMouseDown(MouseEventArgs)

Raises the MouseDown event.

Declaration
protected virtual void OnMouseDown(MouseEventArgs e)
Parameters
System.Windows.Forms.MouseEventArgs e

The System.Windows.Forms.MouseEventArgs instance containing the event data.

OnMouseEnter(EventArgs)

Raises the MouseEnter event.

Declaration
protected virtual void OnMouseEnter(EventArgs e)
Parameters
System.EventArgs e

The System.EventArgs instance containing the event data.

OnMouseHover(EventArgs)

Raises the MouseHover event.

Declaration
protected virtual void OnMouseHover(EventArgs e)
Parameters
System.EventArgs e

The System.EventArgs instance containing the event data.

OnMouseLeave(EventArgs)

Raises the MouseLeave event.

Declaration
protected virtual void OnMouseLeave(EventArgs e)
Parameters
System.EventArgs e

The System.EventArgs instance containing the event data.

OnMouseMove(MouseEventArgs)

Raises the MouseMove event.

Declaration
protected virtual void OnMouseMove(MouseEventArgs e)
Parameters
System.Windows.Forms.MouseEventArgs e

The System.Windows.Forms.MouseEventArgs instance containing the event data.

OnMouseUp(MouseEventArgs)

Raises the MouseUp event.

Declaration
protected virtual void OnMouseUp(MouseEventArgs e)
Parameters
System.Windows.Forms.MouseEventArgs e

The System.Windows.Forms.MouseEventArgs instance containing the event data.

OnMouseWheel(MouseEventArgs)

Raises the MouseWheel event.

Declaration
protected virtual void OnMouseWheel(MouseEventArgs e)
Parameters
System.Windows.Forms.MouseEventArgs e

The System.Windows.Forms.MouseEventArgs instance containing the event data.

OnPanChanged(EventArgs)

Raises the PanChanged event.

Declaration
public virtual void OnPanChanged(EventArgs e)
Parameters
System.EventArgs e

The System.EventArgs instance containing the event data.

OnPanChanging(PanChangingEventArgs)

Raises the PanChanging event.

Declaration
public virtual void OnPanChanging(PanChangingEventArgs e)
Parameters
PanChangingEventArgs e

The PanChangingEventArgs instance containing the event data.

OnPanGesture(PanGestureEventArgs)

Raises the PanGesture event.

Declaration
protected virtual void OnPanGesture(PanGestureEventArgs e)
Parameters
PanGestureEventArgs e

The PanGestureEventArgs instance containing the event data.

OnPressAndTapGesture(PressAndTapGestureEventArgs)

Raises the PressAndTapGesture event.

Declaration
protected void OnPressAndTapGesture(PressAndTapGestureEventArgs e)
Parameters
PressAndTapGestureEventArgs e

The PressAndTapGestureEventArgs instance containing the event data.

OnPropertyChanged(RadPropertyChangedEventArgs)

Declaration
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
Parameters
RadPropertyChangedEventArgs e

Overrides

OnRotateGesture(RotateGestureEventArgs)

Raises the RotateGesture event.

Declaration
protected virtual void OnRotateGesture(RotateGestureEventArgs e)
Parameters
RotateGestureEventArgs e

The RotateGestureEventArgs instance containing the event data.

OnSelectedPointChanged(ChartViewSelectedPointChangedEventArgs)

Raises the SelectedPointChanged event.

Declaration
protected virtual void OnSelectedPointChanged(ChartViewSelectedPointChangedEventArgs e)
Parameters
ChartViewSelectedPointChangedEventArgs e

The ChartViewSelectedPointChangedEventArgs instance containing the event data.

OnSelectedPointChanging(ChartViewSelectedPointChangingEventArgs)

Raises the SelectedPointChanging event.

Declaration
protected virtual void OnSelectedPointChanging(ChartViewSelectedPointChangingEventArgs e)
Parameters
ChartViewSelectedPointChangingEventArgs e

The ChartViewSelectedPointChangingEventArgs instance containing the event data.

OnTwoFingerTapGesture(GestureEventArgs)

Raises the TwoFingerTapGesture event.

Declaration
protected virtual void OnTwoFingerTapGesture(GestureEventArgs e)
Parameters
GestureEventArgs e

The GestureEventArgs instance containing the event data.

OnZoomChanged(EventArgs)

Raises the ZoomChanged event.

Declaration
public virtual void OnZoomChanged(EventArgs e)
Parameters
System.EventArgs e

The System.EventArgs instance containing the event data.

OnZoomChanging(ZoomChangingEventArgs)

Raises the ZoomChanging event.

Declaration
public virtual void OnZoomChanging(ZoomChangingEventArgs e)
Parameters
ZoomChangingEventArgs e

The ZoomChangingEventArgs instance containing the event data.

OnZoomGesture(ZoomGestureEventArgs)

Raises the ZoomGesture event.

Declaration
protected virtual void OnZoomGesture(ZoomGestureEventArgs e)
Parameters
ZoomGestureEventArgs e

The ZoomGestureEventArgs instance containing the event data.

Pan(Double, Double)

Pans with the specified x,y offset.

Declaration
public void Pan(double offsetX, double offsetY)
Parameters
System.Double offsetX

The offset X.
System.Double offsetY

The offset Y.

PerformRefresh(UIChartElement, Boolean)

Performs refreshing the view.

Declaration
public void PerformRefresh(UIChartElement element, bool updateLayout)
Parameters
UIChartElement element

The element.
System.Boolean updateLayout

The update layout.

ProcessResult(ActionResult)

Processes the result.

Declaration
protected virtual bool ProcessResult(ActionResult actionResult)
Parameters
ActionResult actionResult

The action result.
Returns
System.Boolean

Reset()

Resets the view.

Declaration
public void Reset()

ResumeRefresh()

Resumes refreshing the view.

Declaration
public void ResumeRefresh()

SuspendRefresh()

Suspends refreshing the view.

Declaration
public void SuspendRefresh()

UpdatePanOnZoom(Double, Double)

Updates the pan on zoom with the specified horizontal/vertical scale factor.

Declaration
protected virtual void UpdatePanOnZoom(double horizontalScaleFactor, double verticalScaleFactor)
Parameters
System.Double horizontalScaleFactor

The horizontal scale factor.
System.Double verticalScaleFactor

The vertical scale factor.

Zoom(Double, Double)

Zooms the view with the specified horizontal/vertical scale factor.

Declaration
public void Zoom(double horizontalScaleFactor, double verticalScaleFactor)
Parameters
System.Double horizontalScaleFactor

The horizontal scale factor.
System.Double verticalScaleFactor

The vertical scale factor.

Events

AxisLabelFormatting

Occurs when the content of a axis label needs to be formatted for display.

Declaration
public event ChartAxisLabelFormattingEventHandler AxisLabelFormatting
Event Type
ChartAxisLabelFormattingEventHandler

CreatePoint

Occurs when a new DataPoint is created.

Declaration
public event ChartViewCreatePointEventHandler CreatePoint
Event Type
ChartViewCreatePointEventHandler

CreatePointElement

Occurs when a new DataPointElement is created.

Declaration
public event ChartViewCreatePointElementEventHandler CreatePointElement
Event Type
ChartViewCreatePointElementEventHandler

CreateRenderer

Fired when the area requires an renderer for the first time.

Declaration
public event ChartViewCreateRendererEventHandler CreateRenderer
Event Type
ChartViewCreateRendererEventHandler

DataError

Occurs when a data error is detected.

Declaration
public event ChartViewDataErrorEventHandler DataError
Event Type
ChartViewDataErrorEventHandler

LabelFormatting

Fires when the content of a point label needs to be formatted for display.

Declaration
public event ChartViewLabelFormattingEventHandler LabelFormatting
Event Type
ChartViewLabelFormattingEventHandler

PanChanged

Occurs when [pan changed].

Declaration
public event EventHandler PanChanged
Event Type
System.EventHandler

PanChanging

Occurs when [pan changing].

Declaration
public event PanChangingEventHandler PanChanging
Event Type
PanChangingEventHandler

SelectedPointChanged

Occurs when the selected point changes

Declaration
public event ChartViewSelectedChangedEventHandler SelectedPointChanged
Event Type
ChartViewSelectedChangedEventHandler

SelectedPointChanging

Occurs when the selected point is changing

Declaration
public event ChartViewSelectedChangingEventHandler SelectedPointChanging
Event Type
ChartViewSelectedChangingEventHandler

ZoomChanged

Occurs when [zoom changed].

Declaration
public event EventHandler ZoomChanged
Event Type
System.EventHandler

ZoomChanging

Occurs when [zoom changing].

Declaration
public event ZoomChangingEventHandler ZoomChanging
Event Type
ZoomChangingEventHandler

Explicit Interface Implementations

IChartElementPresenter.InvalidatePalette()

Declaration
void IChartElementPresenter.InvalidatePalette()
Implements

IChartElementPresenter.IsVisible

Declaration
bool IChartElementPresenter.IsVisible { get; }
Returns
System.Boolean

Implements

IChartElementPresenter.MeasureContent(ChartNode, Object)

Declaration
RadSize IChartElementPresenter.MeasureContent(ChartNode owner, object content)
Parameters
ChartNode owner

System.Object content

Returns
RadSize

Implements

IChartElementPresenter.RefreshNode(ChartNode)

Declaration
void IChartElementPresenter.RefreshNode(ChartNode node)
Parameters
ChartNode node

Implements

IChartView.PlotAreaClip

Declaration
RadRect IChartView.PlotAreaClip { get; }
Returns
RadRect

Implements

IChartView.PlotOriginX

Declaration
double IChartView.PlotOriginX { get; }
Returns
System.Double

Implements

IChartView.PlotOriginY

Declaration
double IChartView.PlotOriginY { get; }
Returns
System.Double

Implements

IChartView.ViewportHeight

Declaration
double IChartView.ViewportHeight { get; }
Returns
System.Double

Implements

IChartView.ViewportWidth

Declaration
double IChartView.ViewportWidth { get; }
Returns
System.Double

Implements

IChartView.ZoomHeight

Declaration
double IChartView.ZoomHeight { get; }
Returns
System.Double

Implements

IChartView.ZoomWidth

Declaration
double IChartView.ZoomWidth { get; }
Returns
System.Double

Implements

Extension Methods