ChartControl.QueryCursor Event

Occurs when there is a request to display the cursor.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v18.1.UI.dll

Declaration

C#

public event QueryCursorEventHandler QueryCursor

VB.NET

Public Event QueryCursor As QueryCursorEventHandler

Event Data

The QueryCursor event's data class is QueryCursorEventArgs. The following properties provide information specific to this event:

Property	Description
Cursor	Gets or sets the mouse cursor currently being shown for the chart.
CursorType	Gets the cursor type.

Remarks

In the QueryCursor event handler, you can provide custom cursors for your chart in various circumstances (e.g. when a chart is being scrolled or zoomed).

Example

This example demonstrates how to substitute the Hand and Grab cursors shown when a chart’s area is being scrolled with a default system cursor.

To do this, handle the ChartControl.QueryCursor event, and use the QueryCursorEventArgs.Cursor and QueryCursorEventArgs.CursorType properties.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-provide-a-custom-cursor-for-a-chart-e2363

Form1.cs

using System;
using System.Windows.Forms;
using DevExpress.XtraCharts;
// ...
private void chartControl1_QueryCursor(object sender, QueryCursorEventArgs e) {
    if (e.CursorType == CursorType.Hand || e.CursorType == CursorType.Grab) {
        e.Cursor = Cursors.Default;
    }
}

Form1.vb

Imports System
Imports System.Windows.Forms
Imports DevExpress.XtraCharts
' ...
Private Sub chartControl1_QueryCursor(ByVal sender As Object, ByVal e As QueryCursorEventArgs) Handles chartControl1.QueryCursor
    If e.CursorType = CursorType.Hand OrElse e.CursorType = CursorType.Grab Then
        e.Cursor = Cursors.Default
    End If
End Sub

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the QueryCursor event.

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.

VB.NET

how-to-provide-a-custom-cursor-for-a-chart-e2363/VB/CustomChartCursor/Form1.vb#L17

#Region "#code"
Private Sub chartControl1_QueryCursor(ByVal sender As Object, ByVal e As QueryCursorEventArgs) Handles chartControl1.QueryCursor
    If e.CursorType = CursorType.Hand OrElse e.CursorType = CursorType.Grab Then