Edit this page

Conversion API

The conversion API that the ChartView provides, allows the conversion of a position on the screen (for example the position of the mouse) to ChartView coordinates.

Using the conversion API

Both RadCartesianChart and RadPolarChart provide a ConvertPointToData method. This method takes a System.Windows.Point as an argument (position on the screen) and returns an object of type DataTuple.

The DataTuple class has two properties: FirstValue and SecondValue, both of type object. In the context of RadCartesianChart they represent the coordinates on the Horizontal and the Vertical axes and in the context of RadPolarChart - the coordinates on the Polar and the Radial axes.

Here is a RadCartesianChart example:

private void UIElement_MouseMove(object sender, MouseEventArgs e)
{
    Point mousePosition = e.GetPosition(radCartesianChart1);
    DataTuple tuple = radCartesianChart1.ConvertPointToData(mousePosition);

    string Category = (string)tuple.FirstValue;
    double Value = (double)tuple.SecondValue;
    //...
}
Private Sub UIElement_MouseMove(sender As Object, e As MouseEventArgs)
    Dim mousePosition As Point = e.GetPosition(radCartesianChart1)
    Dim tuple As DataTuple = radCartesianChart1.ConvertPointToData(mousePosition)

    Dim Category As String = DirectCast(tuple.FirstValue, String)
    Dim Value As Double = CDbl(tuple.SecondValue)
    '...
End Sub

The RadCartesianChart provides an overloaded version of the ConvertPointToData method, which besides a System.Windows.Point, takes a two other arguments - references to a Horizontal and a Vertical axes. This allows the user to get information relative to the specified axes (often different then the default ones), enabling the use of additional axes.

See Also

Was this article helpful? Yes No

Give article feedback

Tell us how we can improve this article

Dummy