Visit Gigasoft's Web Site
 ProEssentials v9 Help

CursorMode

Scope

Pego, Pesgo, Pepso

Type

Int32

Default

PECM_NONE

.NET

PeUserInterface.Cursor.Mode

Ocx|Vcl

CursorMode

DLL

PEP_nCURSORMODE

 

Purpose

This property controls whether the object has a cursor, and if so, what style of cursor. Cursor styles POINT, DATACROSS, DATASQUARE, and FLOATINGY are designed to give either a point index the focus or an individual data point the focus. Focus is the same concept as an I- Beam cursor placed on a word within a word processing application.

 

Note that the FLOATINGY and FLOATINGXY usually require MouseCursorControl is set to TRUE.

 

The following constants apply to this property:

 

.NET Gigasoft.Enums.

ActiveX and

 

CursorMode.

DLL Constants

Description

NoCursor

PECM_NOCURSOR(0)

Disable cursor.

Point

PECM_POINT(1)

Vertical line cursor used to give the point index the focus.

DataCross

PECM_DATACROSS(2)

Data cross cursor used to give an individual data point the focus.

DataSquare

PECM_DATASQUARE(3)

Data square cursor used to give an individual data point the focus.

FloatingY

PECM_FLOATINGY(4)

Floating horizontal cursor, plus vertical cursor giving the point index the focus.

FloatingXY

PECM_FLOATINGXY(5)

Floating horizontal and vertical cursors. No focus.

 

Graph VCL Enumerations

eCursorMode = (gNoCursor, gVertLine, gCrossHair, gInvertedRect, gFloatingY, gFloatingXY);

 

Scientific Graph VCL Enumerations

eCursorMode = (sgNoCursor, sgVertLine, sgCrossHair, sgInvertedRect, sgFloatingY, sgFloatingXY);

 

Comments

PeUserInterface.Cursor.Mode members of Pego.PeUserInterface.Cursor, Pesgo.PeUserInterface.Cursor, Pepso.PeUserInterface.Cursor

 

Within the demo, see example 105.

 

The Polar/Smith Chart supports PECM_DATASQUARE only.

 

The cursor can be moved by the user with the arrow keys, and if MouseCursorControl is set to true, with the mouse. The cursor functions much like that of a text editor cursor. The left/right arrows move the focus from point to point, and the up/down arrows move the focus from subset to subset.

 

TheCursorPromptStyle property can be used to continuously show the user the data point value which has the cursors focus. This will be shown in the top left corner.

 

CursorSubset and CursorPoint can be used to retrieve and set the current location of the cursor. Setting CursorPoint is what triggers the cursor to move so set CursorSubset first if applicable. If your chart contains null data (NullDataValue is zero by default), then make sure not to change the CursorSubset and CursorPoint properties to a location that holds a piece of null data.

 

See Also: MouseCursorControl

 

Related events:

.NET: PeCursorMoved and PePreCursorMove events
ActiveX: CursorMoved and PreCursorMove events
SDK/DLL: PEWN_CURSORMOVED and PEWN_PRE_CURSORMOVE notification messages.