ChartControl.CrosshairEnabled Property

Gets or sets a value that specifies whether or not a crosshair cursor is enabled for a chart.

Namespace: DevExpress.XtraCharts

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

Declaration

C#

public DefaultBoolean CrosshairEnabled { get; set; }

VB.NET

Public Property CrosshairEnabled As DefaultBoolean

Property Value

Type	Description
DefaultBoolean	Default - a crosshair cursor’s state (enabled/disabled) is automatically determined based on the type of diagram currently displayed on a chart; True - a crosshair cursor is enabled for a chart; False - a crosshair cursor is disabled.

Available values:

Name	Description
True	Corresponds to a Boolean value of true.
False	Corresponds to a Boolean value of false.
Default	The value is determined by the current object’s parent object setting (e.g., a control setting).

Remarks

Use the CrosshairEnabled property to activate (deactivate) a crosshair cursor at the level of a ChartControl.

After that, it becomes possible to customize the crosshair cursor appearance and position on a diagram via the ChartControl.CrosshairOptions property.

The following image shows the enabled crosshair cursor with the CrosshairOptions.ShowArgumentLabels, CrosshairOptions.ShowValueLabels, CrosshairOptions.ShowArgumentLine and CrosshairOptions.ShowValueLine set to true.

As you can see, data point markers are hidden in XtraCharts for Winforms by default, to support highlighting series points. If you wish to display markers on a diagram, set the MarkerVisibility property for a particular series to true (e.g., LineSeriesView.MarkerVisibility).

You can also change the content of a crosshair label via the SeriesBase.CrosshairLabelPattern property.

For more information on how to use a crosshair cursor, see the Crosshair Cursor topic.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the CrosshairEnabled 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#

how-to-determine-which-series-point-is-located-under-the-test-point-e2717/CS/WindowsFormsApplication79/Form1.cs#L17

private void Form1_Load(object sender, EventArgs e) {
    chartControl1.CrosshairEnabled = DefaultBoolean.False;
    chartControl1.RuntimeHitTesting = true;

VB.NET

how-to-determine-which-series-point-is-located-under-the-test-point-e2717/VB/WindowsFormsApplication79/Form1.vb#L19

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load
    chartControl1.CrosshairEnabled = DefaultBoolean.False
    chartControl1.RuntimeHitTesting = True