CursorEventArgs.NewPosition Property

.NET Framework (current version)

The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets or sets the position of a cursor. Depending on the event, also sets the cursor's position.

Namespace:   System.Windows.Forms.DataVisualization.Charting
Assembly:  System.Windows.Forms.DataVisualization (in System.Windows.Forms.DataVisualization.dll)

public double NewPosition { get; set; }

Property Value

Type: System.Double

A double value that represents the position of a cursor along an axis.

This property represents the new position of a cursor, and can be used in the CursorPositionChanging and CursorPositionChanged events to get the cursor position. It can also be used in the SelectionRangeChanging event to set the cursor position.

Note that setting this property in the SelectionRangeChanging event will have no effect. The NewPosition property will have a value of NaN in this event.

To determine the chart area that the event is being raised for, use the ChartArea property.

Use the Axis property to determine if this end position is for a range selected along the primary or secondary X or Y axis.

.NET Framework
Available since 4.0
Return to top