TdxChartCrosshairOptions.SnapToSeriesMode Property

Specifies how the Chart control chooses target series for Crosshair Cursor.

Declaration

delphi

property SnapToSeriesMode: TdxChartCrosshairSnapToSeriesMode read; write; default TdxChartCrosshairSnapToSeriesMode.All;

Property Value

Type	Default	Description
TdxChartCrosshairSnapToSeriesMode	All

The active snap to series mode.

Remarks

Use SnapToPointMode, SnapToSeriesMode, SnapToOutRangePoints, and StickyLines properties to customize crosshair line and label behavior in XY diagrams.

Property Value Examples

The following table demonstrates the difference between all snap to series modes under the same conditions:

Value

Description

Example[1]

| | --- | --- | --- | |

All ( default )

All series in a diagram can be targets for Crosshair Cursor. An XY diagram can display multiple sets of crosshair lines in this mode.

Note

An XY series can be a target for Crosshair Cursor only if the ToolTips.Enabled property is set to True for the series.

This mode is compatible with all possible SnapToPointMode property values.

| |

NearestToCursor

Crosshair Cursor targets only the series point nearest to the mouse pointer.

This mode is compatible with all possible SnapToPointMode property values.

| |

NearestToFreeLine

Crosshair Cursor targets only the series point nearest to the crosshair line that follows the mouse pointer.

The SnapToSeriesMode property setter updates the SnapToPointMode property value from NearestToCursor to Argument when you enable the NearestToFreeLine mode because it is incompatible with the point-based targeting mode.

Refer to the following section for details: Property Setter Behavior.

Property Setter Behavior

The SnapToSeriesMode property setter changes the SnapToPointMode property value to Argument if the following conditions are met:

The new SnapToSeriesMode property value is NearestToFreeLine.
The current SnapToPointMode property value is NearestToCursor.

Otherwise, the SnapToPointMode property value remains unchanged.

Default Value

The SnapToSeriesMode property’s default value is TdxChartCrosshairSnapToSeriesMode.All.

Footnotes

These examples demonstrate all possible SnapToSeriesMode property values for the same XY diagram with three simple Line series under the following conditions: