ChartControl.RuntimeHitTesting Property

Specifies whether or not hit-testing is enabled for a Chart control.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v23.2.UI.dll

NuGet Package: DevExpress.Win.Charts

Declaration

C#

public bool RuntimeHitTesting { get; set; }

VB.NET

Public Property RuntimeHitTesting As Boolean

Property Value

Type	Description
Boolean	true if a chart provides hit information at runtime; otherwise, false.

Remarks

The default RuntimeHitTesting property value is false, which means that hit-testing is disabled at runtime. This is done to accelerate chart rendering.

Set the RuntimeHitTesting option to true if you want to use the ChartControl.CalcHitInfo method to get information on clicks within the chart.

Refer to Hit Information for more information.

Note

• If you handle the ChartControl.ObjectHotTracked event, it will be raised and information on hit-testing will be collected regardless of the current RuntimeHitTesting property value.
• When the RuntimeHitTesting property is enabled, the SeriesPoint object can be inaccessible when hovering over the LineSeriesView at runtime. To resolve this issue, make sure the line point markers are visible (set the LineSeriesView.MarkerVisibility property to true).

Example

To enable the RuntimeHitTesting property at runtime, turn it on during a chart’s initialization. You can do this in the Form’s constructor after the components’ initialization or in the Form’s Load event handler.

C#

private void Form_Load(object sender, EventArgs e) {
    chartControl.RuntimeHitTesting = true;
    //...
}

VB.NET

Private Sub Form_Load(ByVal sender As Object, ByVal e As EventArgs)
    chartControl.RuntimeHitTesting = true
    '...
End Sub

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the RuntimeHitTesting property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-dashboard-custom-items/CS/TutorialsCustomItems/CustomItems/FunnelItemControlProvider.cs#L20

chart = new ChartControl();
chart.RuntimeHitTesting = true;
chart.BorderOptions.Visibility = DevExpress.Utils.DefaultBoolean.False;

winforms-dashboard-custom-items-extension/CS/CustomItemExtension/CustomItems/Funnel/FunnelItemControlProvider.cs#L20

chart = new ChartControl();
chart.RuntimeHitTesting = true;
chart.BorderOptions.Visibility = DevExpress.Utils.DefaultBoolean.False;

VB.NET

winforms-dashboard-custom-items/VB/TutorialsCustomItems/CustomItems/FunnelItemControlProvider.vb#L26

chart = New ChartControl()
chart.RuntimeHitTesting = True
chart.BorderOptions.Visibility = DevExpress.Utils.DefaultBoolean.False

winforms-dashboard-custom-items-extension/VB/CustomItemExtension/CustomItems/Funnel/FunnelItemControlProvider.vb#L26

chart = New ChartControl()
chart.RuntimeHitTesting = True
chart.BorderOptions.Visibility = DevExpress.Utils.DefaultBoolean.False