TiPlotDataCursor.Pointer1Position

TiPlotDataCursor

Specifies the position of the first cursor pointer.

property Pointer1Position : Double;

Description

Use Pointer1Position to get or set the position of the first cursor pointer. The units of the Pointer1Position are in reference to the DataView area in percent. Therefore, the only valid values are between 0 and 100.

If the data cursor is horizontal, the position is in reference to the Y-Axis side of the DataView area with 0 being the bottom of the DataView and 100 being the top of the data view.

If the data cursor is vertical, the position is in reference to the X-Axis side of the DataView area with 0 being the left side of the DataView and 100 being the right side of the data view.

For data cursors of style ValueXY (iPlot Component Only), ValueX, and ValueY, this property sets the position of the single cursor line used with these data cursor styles.

CursorStyle
Position Value Meaning
ipcsValueXY
(iPlot Only)
References the X-Axis size of the DataView.
ipcsValueX
References the X-Axis size of the DataView.
ipcsValueY
References the X-Axis size of the DataView.

For data cursors of style ValueXY (iXYPlot Component Only), DeltaX, DeltaY, and InverseDeltaX, this property sets the position of the first cursor line with these dual-line data cursor styles.

CursorStyle
Position Value Meaning
ipcsValueXY
(iXYPlot Only)
References the X-Axis size of the DataView.
ipcsDeltaX
References the X-Axis size of the DataView.
ipcsDeltaY
References the Y-Axis size of the DataView.
ipcsInverseDeltaX
References the X-Axis size of the DataView.

Note: to set the position of the data cursor to a value of 157.25 on the X-Axis scale, you would set the Pointer1Position property as follows using the PositionToPercent function of the axis.

iPlot1.DataCursor[0].Pointer1Position := iPlot1.YAxis[0].PositionToPercent(157.25) * 100;

Example

Delphi

iComponent.DataCursor[0].Pointer1Position := 12.5;

C++ Builder

iComponent->DataCursor[0]->Pointer1Position = 12.5;

Contents | Index | Previous | Next