SeriesBase.CrosshairHighlightPoints Property

Gets or sets a value that specifies whether the series points are highlighted when the crosshair cursor hovers over them.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v21.2.dll

NuGet Package: DevExpress.Charts

Declaration

C#

[XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)]
public DefaultBoolean CrosshairHighlightPoints { get; set; }

VB.NET

<XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)>
Public Property CrosshairHighlightPoints As DefaultBoolean

Property Value

Type	Description
DefaultBoolean	Default - the CrosshairHighlightPoints property value is obtained from the parent CrosshairOptions.HighlightPoints property; true - the series points are highlighted when the crosshair cursor hovers over them; false - the series points are not highlighted.

Available values:

Name	Description
True	true. DefaultBoolean.True has a constant value of 0, while the standard true value corresponds to a value of 1. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
False	false. DefaultBoolean.False has a constant value of 1, while the standard false value corresponds to a value of 0. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
Default	The default behavior determined by the control’s logic.

Remarks

Use the CrosshairHighlightPoints property to enable/disable point highlighting for a particular series when the crosshair cursor hovers over a point.

Note

To enable the crosshair highlighting points feature, make sure the CrosshairOptions.HighlightPoints property is set to true.

The following images demonstrate the CrosshairHighlightPoints property in action.

CrosshairHighlightPoints=True (for Series1); CrosshairHighlightPoints=False (for Series2)	CrosshairHighlightPoints=True (for Series2); CrosshairHighlightPoints=False (for Series1)

Note that the MarkerVisibility property for a particular series (e.g., LineSeriesView.MarkerVisibility) is set to false by default to support series point highlighting on a diagram.

In addition, the crosshair cursor axis lines and labels are displayed on a diagram. It can be done by setting the CrosshairOptions.ShowArgumentLabels, CrosshairOptions.ShowValueLabels, CrosshairOptions.ShowArgumentLine, and CrosshairOptions.ShowValueLine properties to true.

Note

This property is not applicable to ASP.NET and ASP.NET MVC chart series.

For more information on customizing the crosshair cursor, refer to Tooltip and Crosshair Cursor.