New to Telerik UI for WinForms? Start a free 30-day trial

ChartRenderer

Class

Provides the base implementation for chart rendering functionality, handling drawing operations and text measurement for chart elements.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.ChartView.dll

Syntax:

public class ChartRenderer : IChartRenderer

Inheritance: objectChartRenderer

Derived Classes: CartesianRendererFunnelRendererPieRendererPolarRenderer

Implements: IChartRenderer

Constructors

ChartRenderer(ChartArea)

Initializes a new instance of the ChartRenderer class with the specified chart area.

public ChartRenderer(ChartArea area)

Parameters:areaChartArea

The chart area that this renderer will be associated with.

Properties

Graphics

Gets the Graphics object from the current rendering surface.

public Graphics Graphics { get; }

Surface

object

Gets or sets the rendering surface used for drawing operations.

public object Surface { get; }

Implements: IChartRenderer.Surface

Methods

Draw(object)

Draws the chart using the specified rendering context.

public virtual void Draw(object context)

Parameters:contextobject

The graphics context used for rendering operations.

Implements: IChartRenderer.Draw(object)

GetDistanceBetweenPoints(PointF, PointF)

Calculates the Euclidean distance between two points.

public float GetDistanceBetweenPoints(PointF start, PointF end)

Parameters:startPointF

The starting point.

endPointF

The ending point.

Returns:

float

The distance between the two points as a float value.

HitTest(int, int)

Performs hit testing to find the data point at the specified coordinates.

public virtual DataPoint HitTest(int x, int y)

Parameters:xint

The x-coordinate for hit testing.

yint

The y-coordinate for hit testing.

Returns:

DataPoint

The DataPoint at the specified coordinates, or null if no data point is found.

Implements: IChartRenderer.HitTest(int, int)

Initialize()

Initializes the renderer by setting up smart labels controller and calculating label positions if available.

protected virtual void Initialize()

Invalidate(object)

Invalidates the specified model to trigger a redraw operation.

public virtual void Invalidate(object model)

Parameters:modelobject

The model object to invalidate.

Implements: IChartRenderer.Invalidate(object)

MeasureRotatedLabels(string, object, double)

Measures the size of rotated text labels considering the rotation angle.

public virtual RadSize MeasureRotatedLabels(string text, object context, double rotationAngle)

Parameters:textstring

The text to measure.

contextobject

The font context used for measurement.

rotationAngledouble

The rotation angle in degrees.

Returns:

RadSize

A RadSize representing the measured dimensions of the rotated text.

Implements: IChartRenderer.MeasureRotatedLabels(string, object, double)

MeasureText(string, object)

Measures the size of the specified text using the provided font context.

public virtual RadSize MeasureText(string text, object context)

Parameters:textstring

The text to measure.

contextobject

The font context used for measurement.

Returns:

RadSize

A RadSize representing the measured dimensions of the text.

Implements: IChartRenderer.MeasureText(string, object)

ToPoint(RadPoint)

Converts a RadPoint to a Point with rounded coordinates.

public static Point ToPoint(RadPoint point)

Parameters:pointRadPoint

The RadPoint to convert.

Returns:

Point

A Point with rounded integer coordinates.

ToPointF(RadPoint)

Converts a RadPoint to a PointF.

public static PointF ToPointF(RadPoint point)

Parameters:pointRadPoint

The RadPoint to convert.

Returns:

PointF

A PointF with equivalent coordinates.

ToRectangle(RadRect)

Converts a RadRect to a Rectangle with rounded coordinates.

public static Rectangle ToRectangle(RadRect rect)

Parameters:rectRadRect

The RadRect to convert.

Returns:

Rectangle

A Rectangle with rounded integer coordinates.

ToRectangleF(RadRect)

Converts a RadRect to a RectangleF.

public static RectangleF ToRectangleF(RadRect rect)

Parameters:rectRadRect

The RadRect to convert.

Returns:

RectangleF

A RectangleF with equivalent dimensions.

ToSize(RadSize)

Converts a RadSize to a Size with rounded coordinates.

public static Size ToSize(RadSize size)

Parameters:sizeRadSize

The RadSize to convert.

Returns:

Size

A Size with rounded integer dimensions.

ToSizeF(RadSize)

Converts a RadSize to a SizeF.

public static SizeF ToSizeF(RadSize size)

Parameters:sizeRadSize

The RadSize to convert.

Returns:

SizeF

A SizeF with equivalent dimensions.