Chart3DHitInfo Class

Contains information about a specific point within a chart.

Namespace: DevExpress.Xpf.Charts

Assembly: DevExpress.Xpf.Charts.v20.2.dll

NuGet Packages: DevExpress.WindowsDesktop.Wpf.Charts, DevExpress.Wpf.Charts

Declaration

C#

public class Chart3DHitInfo :
    ChartHitInfoBase

VB.NET

Public Class Chart3DHitInfo
    Inherits ChartHitInfoBase

Related API Members

The following members return Chart3DHitInfo objects:

• Chart3DControl.CalcHitInfo(Point)

Remarks

Chart3DHitInfo objects can be created by calling the chart’s Chart3DControl.CalcHitInfo method. This method requires the test point as a parameter, or its coordinates.

The Chart3DHitInfo class properties can be grouped into two categories:

• The properties that indicate whether the test point resides over a particular view element. For instance, the ChartHitInfoBase.InAxis property indicates whether the test point is over the axis;
• The properties identifying the topmost visual element, which contains the test point (e.g., ChartHitInfoBase.Axis).

Example

This example shows coordinates for a surface point and series point marker clicked in a 3D chart:

XAML

<dxc:Chart3DControl x:Name="chart" MouseUp="Chart3DControl_MouseUp">
    ...
    <dxc:Series3DStorage>
        <dxc:Series3D DisplayName="Function">
            ...
            <dxc:Series3D.View>
                <dxc:SurfaceSeriesView MarkerVisible="True">
                    ...
                </dxc:SurfaceSeriesView>
            </dxc:Series3D.View>
        </dxc:Series3D>
    </dxc:Series3DStorage>
</dxc:Chart3DControl>

C#

using DevExpress.Xpf.Charts;
using System.Windows;
//...
private void Chart3DControl_MouseUp(object sender, System.Windows.Input.MouseButtonEventArgs e) {
    Chart3DHitInfo hitInfo = chart.CalcHitInfo(e.GetPosition(this));
    if (hitInfo.InSeries) {
        string str;
        if (hitInfo.SeriesPoint != null) {
            SeriesPoint3D point = hitInfo.SeriesPoint;
            str = $"X: {point.NumericXArgument:f2}, Y: {point.NumericYArgument:f2}, Z: {point.Value:f2}";
            MessageBox.Show(str);
        }
        if (hitInfo.AdditionalItem != null) {
            SurfacePoint surfacePoint = (SurfacePoint)hitInfo.AdditionalItem;
            str = $"X: {surfacePoint.X:f2}, Y: {surfacePoint.Y:f2}, Z: {surfacePoint.Z:f2}";
            MessageBox.Show(str);
        }
    }
}

VB.NET

Imports DevExpress.Xpf.Charts
Imports System.Windows
'...
Private Sub Chart3DControl_MouseUp(ByVal sender As Object, ByVal e As System.Windows.Input.MouseButtonEventArgs)
    Dim hitInfo As Chart3DHitInfo = chart.CalcHitInfo(e.GetPosition(Me))
    If hitInfo.InSeries Then
        Dim str As String
        If hitInfo.SeriesPoint IsNot Nothing Then
            Dim point As SeriesPoint3D = hitInfo.SeriesPoint
            str = $"X: {point.NumericXArgument:f2}, Y: {point.NumericYArgument:f2}, Z: {point.Value:f2}"
            MessageBox.Show(str)
        End If
        If hitInfo.AdditionalItem IsNot Nothing Then
            Dim surfacePoint As SurfacePoint = CType(hitInfo.AdditionalItem, SurfacePoint)
            str = $"X: {surfacePoint.X:f2}, Y: {surfacePoint.Y:f2}, Z: {surfacePoint.Z:f2}"
            MessageBox.Show(str)
        End If
    End If
End Sub

Inheritance

Object

ChartHitInfoBase

Chart3DHitInfo