ChartControlBase.CrosshairEnabled Property

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

Namespace: DevExpress.Xpf.Charts

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

NuGet Package: DevExpress.Wpf.Charts

Declaration

C#

public bool? CrosshairEnabled { get; set; }

VB.NET

Public Property CrosshairEnabled As Boolean?

Property Value

Type	Description
Nullable<Boolean>	Null - 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.

Remarks

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

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

You can also change the content of a crosshair label, via the XYSeries2D.CrosshairLabelPattern property and crosshair label appearance using the XYSeries2D.CrosshairLabelTemplate property.

The following table shows this property in action.

CrosshairEnabled=True	CrosshairEnabled=False

Note

The CrosshairOptionsBase.ShowCrosshairLabels and CrosshairOptions.ShowArgumentLine properties are enabled by default.

To show series point markers on a diagram, set the MarkerVisible property for a particular series to true (e.g., LineSeries2D.MarkerVisible).

To learn more about the crosshair cursor, see the Crosshair Cursor topic.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references 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.

XAML

how-to-provide-a-custom-tooltip-for-a-series-point-e4083/CS/ToolTipPointTemplate/MainWindow.xaml#L8

<dxc:ChartControl Name="chart" Width="758" Height="440"
                  ToolTipEnabled="True" CrosshairEnabled="False">
    <dxc:ChartControl.ToolTipController>

wpf-chart-customize-the-appearance-of-a-series-tooltip/CS/ToolTipSeriesTemplate/MainWindow.xaml#L7

<Grid>
    <dxc:ChartControl ToolTipEnabled="True" CrosshairEnabled="False">
        <dxc:ChartControl.ToolTipOptions>