TdxChartCrosshairOptions.StickyLines Property

Specifies the active crosshair line behavior mode.

Declaration

property StickyLines: TdxChartCrosshairStickyLines read; write; default TdxChartCrosshairStickyLines.SingleAxis;

Property Value

Type	Default	Description
TdxChartCrosshairStickyLines	SingleAxis	The active crosshair line behavior mode.

Remarks

Use the StickyLines property to change what crosshair lines and their axis labels snap to target series points.

SnapToPointMode, SnapToSeriesMode, and SnapToOutRangePoints properties define how Crosshair Cursor targets series points.

Property Value Examples

The following table demonstrates the difference between all crosshair line behavior modes under the same conditions:

Value	Description	Example[1]
SingleAxis (default)	Argument or value crosshair lines snap to target series points if the SnapToPointMode property is set to Argument or Value, respectively. The StickyLines property setter changes the SnapToPointMode property value from NearestToCursor to Argument when you enable the SingleAxis mode because it is incompatible with the point-based targeting mode. Refer to the following section for details: Property Setter Behavior.
Crosshair	Both argument and value crosshair lines snap to target series points if the SnapToPointMode property is set to NearestToCursor. This mode is compatible with all possible SnapToPointMode property values.
None	Argument and value crosshair lines always follow the mouse pointer as a crosshair. This mode is compatible with all possible SnapToPointMode property values.

Property Setter Behavior

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

• The new StickyLines property value is SingleAxis.
• The current SnapToPointMode property value is NearestToCursor.

Otherwise, the SnapToPointMode property value remains unchanged.

Default Value

The StickyLines property’s default value is TdxChartCrosshairStickyLines.SingleAxis.

Footnotes

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

   • The SnapToSeriesMode property is set to All.
   • The SnapToPointMode property is set to Argument.
   • ArgumentLines.Visible and ValueLines.Visible properties are set to True.
   • The ShowArgumentLabels property is set to False.