Class

ChartView

Initializes a new instance of the ChartView class with the specified chart view host and creates a default Cartesian area.

Declaration

public ChartView(IChartViewHost owner)

Parameters

Initializes a new instance of the ChartView class using the wrapper from the specified RadChartElement.

Declaration

public ChartView(RadChartElement owner)

Parameters

Initializes a new instance of the ChartView class using the chart element wrapper from the specified RadChartView control.

Declaration

public ChartView(RadChartView owner)

Parameters

Identifies the Margin dependency property that defines the spacing between the chart view and its container.

Declaration

public static RadProperty MarginProperty

Field Value

Identifies the MinSize dependency property that defines the minimum size constraints for the chart view.

Declaration

public static RadProperty MinSizeProperty

Field Value

Gets the collection of chart annotations that provide additional visual elements overlaid on the chart.

Declaration

public ChartAnnotationCollection Annotations { get; }

Property Value

Gets the current ChartArea that defines the plotting region and coordinate system for data visualization.

Declaration

[Browsable(false)]
public ChartArea Area { get; }

Property Value

Gets or sets the chart area type that determines the coordinate system and layout for data visualization (Cartesian, Pie, Polar, or Funnel).

Declaration

public ChartAreaType AreaType { get; set; }

Property Value

Gets the collection of chart axes that define the coordinate system and scaling for the chart area.

Declaration

public ChartAxisCollection Axes { get; }

Property Value

Gets the client rectangle that defines the available drawing area for the chart.

Declaration

public RectangleF ClientRectangle { get; }

Property Value

Gets the collection of chart view controllers that handle user interaction and chart behavior.

Declaration

public ChartViewControllerCollection Controllers { get; }

Property Value

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

Declaration

[Browsable(true)]
public string DataMember { get; set; }

Property Value

Gets or sets the data source of the ChartSeries.

Declaration

public object DataSource { get; set; }

Property Value

Gets or sets the margin around the chart area within the view boundaries.

Declaration

public Padding Margin { get; set; }

Property Value

Gets or sets the minimum size constraints for the chart view.

Declaration

public SizeF MinSize { get; set; }

Property Value

Gets or sets the chart view host that owns and manages this chart view instance.

Declaration

public IChartViewHost Owner { get; set; }

Property Value

Gets or sets the color palette used to automatically assign colors to chart series elements.

Declaration

[Browsable(false)]
public ChartPalette Palette { get; set; }

Property Value

Gets the chart renderer responsible for drawing and visualizing chart elements within the current chart area.

Declaration

public IChartRenderer Renderer { get; }

Property Value

Gets or sets the selection mode that determines how chart elements can be selected by the user.

Declaration

public ChartSelectionMode SelectionMode { get; set; }

Property Value

Gets the collection of chart series that contain the data points and visualization settings for the chart.

Declaration

public ChartSeriesCollection Series { get; }

Property Value

Gets or sets a value indicating whether the pan and zoom controller is activated for chart navigation.

Declaration

public bool ShowPanZoom { get; set; }

Property Value

Gets or sets a value indicating whether smart labels are enabled to prevent overlapping of chart labels.

Declaration

public bool ShowSmartLabels { get; set; }

Property Value

Gets or sets a value indicating whether still indicators are displayed for static chart elements.

Declaration

public bool ShowStillIndicators { get; set; }

Property Value

Gets or sets a value indicating whether tooltips are displayed when hovering over chart elements.

Declaration

public bool ShowToolTip { get; set; }

Property Value

Gets or sets a value indicating whether the track ball controller is shown for data point tracking.

Declaration

public bool ShowTrackBall { get; set; }

Property Value

Gets or sets a value indicating whether to automatically configure the DataSource of each ChartSeries when null.

Declaration

[Browsable(true)]
public bool UseDataSource { get; set; }

Property Value

Gets or sets the name identifier for this chart view, useful for drill-down navigation and view management.

Declaration

public virtual string ViewName { get; set; }

Property Value

Gets or sets the view result that contains information about the chart view's rendering and data processing state.

Declaration

public ViewResult ViewResult { get; set; }

Property Value

Gets or sets the viewport rectangle that defines the visible chart area.

Declaration

public RadRect Viewport { get; set; }

Property Value

Defers chart refresh operations until the returned IDisposable is disposed.

Declaration

public virtual IDisposable DeferRefresh()

Returns

Draws the chart view using the specified rendering context.

Declaration

public virtual void Draw(object context)

Parameters

Gets the chart area cast to the specified type.

Declaration

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

Returns

Performs a layout pass to arrange chart elements and invalidates the display.

Declaration

public void Layout()

Performs a layout pass to arrange chart elements within the specified rectangle.

Declaration

public void Layout(RadRect rect)

Parameters

Performs a layout pass to arrange chart elements with optional invalidation.

Declaration

public void Layout(bool redraw)

Parameters

Called when the chart view is attached to a parent chart element.

Declaration

protected override void OnAttached(UIChartElement parent)

Parameters

Overrides UIChartElement.OnAttached(UIChartElement)

Raises the AxisLabelFormatting event.

Declaration

protected virtual void OnAxisLabelFormatting(object sender, ChartAxisLabelFormattingEventArgs e)

Parameters

Raises the CreatePoint event.

Declaration

protected virtual void OnCreatePoint(ChartViewCreatePointEventArgs e)

Parameters

Raises the CreatePointElement event.

Declaration

protected virtual void OnCreatePointElement(ChartViewCreatePointElementEventArgs e)

Parameters

Raises the CreateRenderer event.

Declaration

protected virtual void OnCreateRenderer(object sender, ChartViewCreateRendererEventArgs e)

Parameters

Raises the DataError event when a data exception occurs.

Declaration

protected virtual void OnDataError(Exception exception)

Parameters

Raises the gesture event and processes it through all chart controllers.

Declaration

protected virtual void OnGesture(GestureEventArgs e)

Parameters

Raises the key down event and processes it through all chart controllers.

Declaration

protected virtual void OnKeyDown(KeyEventArgs e)

Parameters

Raises the key press event and processes it through all chart controllers.

Declaration

protected virtual void OnKeyPress(KeyPressEventArgs e)

Parameters

Raises the key up event and processes it through all chart controllers.

Declaration

protected virtual void OnKeyUp(KeyEventArgs e)

Parameters

Raises the LabelFormatting event.

Declaration

protected virtual void OnLabelFormatting(object sender, ChartViewLabelFormattingEventArgs e)

Parameters

Raises the mouse capture changed event and processes it through all chart controllers.

Declaration

protected virtual void OnMouseCaptureChanged(EventArgs e)

Parameters

Raises the mouse click event and processes it through all chart controllers.

Declaration

protected virtual void OnMouseClick(MouseEventArgs e)

Parameters

Raises the mouse double click event and processes it through all chart controllers.

Declaration

protected virtual void OnMouseDoubleClick(MouseEventArgs e)

Parameters

Raises the mouse down event and processes it through all chart controllers.

Declaration

protected virtual void OnMouseDown(MouseEventArgs e)

Parameters

Raises the mouse enter event and processes it through all chart controllers.

Declaration

protected virtual void OnMouseEnter(EventArgs e)

Parameters

Raises the mouse hover event and processes it through all chart controllers.

Declaration

protected virtual void OnMouseHover(EventArgs e)

Parameters

Raises the mouse leave event and processes it through all chart controllers.

Declaration

protected virtual void OnMouseLeave(EventArgs e)

Parameters

Raises the mouse move event and processes it through all chart controllers.

Declaration

protected virtual void OnMouseMove(MouseEventArgs e)

Parameters

Raises the mouse up event and processes it through all chart controllers.

Declaration

protected virtual void OnMouseUp(MouseEventArgs e)

Parameters

Raises the mouse wheel event and processes it through all chart controllers.

Declaration

protected virtual void OnMouseWheel(MouseEventArgs e)

Parameters

Raises the PanChanged event.

Declaration

public virtual void OnPanChanged(EventArgs e)

Parameters

Raises the PanChanging event.

Declaration

public virtual void OnPanChanging(PanChangingEventArgs e)

Parameters

Raises the pan gesture event and processes it through all chart controllers.

Declaration

protected virtual void OnPanGesture(PanGestureEventArgs e)

Parameters

Raises the press and tap gesture event and processes it through all chart controllers.

Declaration

protected void OnPressAndTapGesture(PressAndTapGestureEventArgs e)

Parameters

Raises the RadPropertyChanged event and the standard .NET PropertyChanged event to notify subscribers of property value changes.

Declaration

protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)

Parameters

Overrides UIChartElement.OnPropertyChanged(RadPropertyChangedEventArgs)

Raises the rotate gesture event and processes it through all chart controllers.

Declaration

protected virtual void OnRotateGesture(RotateGestureEventArgs e)

Parameters

Raises the SelectedPointChanged event.

Declaration

protected virtual void OnSelectedPointChanged(ChartViewSelectedPointChangedEventArgs e)

Parameters

Raises the SelectedPointChanging event.

Declaration

protected virtual void OnSelectedPointChanging(ChartViewSelectedPointChangingEventArgs e)

Parameters

Raises the two finger tap gesture event and processes it through all chart controllers.

Declaration

protected virtual void OnTwoFingerTapGesture(GestureEventArgs e)

Parameters

Raises the ZoomChanged event.

Declaration

public virtual void OnZoomChanged(EventArgs e)

Parameters

Raises the ZoomChanging event.

Declaration

public virtual void OnZoomChanging(ZoomChangingEventArgs e)

Parameters

Raises the zoom gesture event and processes it through all chart controllers.

Declaration

protected virtual void OnZoomGesture(ZoomGestureEventArgs e)

Parameters

Pans the chart view by the specified offset values.

Declaration

public void Pan(double offsetX, double offsetY)

Parameters

Performs a refresh operation on the chart view for the specified element.

Declaration

public void PerformRefresh(UIChartElement element, bool updateLayout)

Parameters

Processes the action result returned by chart controllers.

Declaration

protected virtual bool ProcessResult(ActionResult actionResult)

Parameters

Returns

Resets the chart view by clearing axis states and performing a layout update.

Declaration

public void Reset()

Resumes chart refresh operations and triggers a refresh if needed.

Declaration

public void ResumeRefresh()

Suspends chart refresh operations to improve performance during multiple updates.

Declaration

public void SuspendRefresh()

Updates the pan offset when zoom changes to maintain proper chart positioning.

Declaration

protected virtual void UpdatePanOnZoom(double horizontalScaleFactor, double verticalScaleFactor)

Parameters

Zooms the chart view using the specified horizontal and vertical scale factors.

Declaration

public void Zoom(double horizontalScaleFactor, double verticalScaleFactor)

Parameters

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

Declaration

[Browsable(true)]
public event ChartAxisLabelFormattingEventHandler AxisLabelFormatting

Event Value

Occurs when a new data point is created, allowing customization of data points.

Declaration

public event ChartViewCreatePointEventHandler CreatePoint

Event Value

Occurs when a new data point element is created, allowing customization of point elements.

Declaration

public event ChartViewCreatePointElementEventHandler CreatePointElement

Event Value

Occurs when the chart area requires a renderer for the first time, allowing custom renderer creation.

Declaration

public event ChartViewCreateRendererEventHandler CreateRenderer

Event Value

Occurs when a data error is detected during chart operations.

Declaration

public event ChartViewDataErrorEventHandler DataError

Event Value

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

Declaration

[Browsable(true)]
public event ChartViewLabelFormattingEventHandler LabelFormatting

Event Value

Occurs when the pan position has changed.

Declaration

public event EventHandler PanChanged

Event Value

Occurs when the pan position is about to change, allowing cancellation of the pan operation.

Declaration

public event PanChangingEventHandler PanChanging

Event Value

Occurs when the selected point has changed.

Declaration

public event ChartViewSelectedChangedEventHandler SelectedPointChanged

Event Value

Occurs when the selected point is about to change, allowing cancellation of the selection.

Declaration

public event ChartViewSelectedChangingEventHandler SelectedPointChanging

Event Value

Occurs when the zoom level has changed.

Declaration

public event EventHandler ZoomChanged

Event Value

Occurs when the zoom level is about to change, allowing cancellation of the zoom operation.

Declaration

public event ZoomChangingEventHandler ZoomChanging

Event Value