OpenLiveMouse()

Open a graphic mode live mouse and set its starting (X, Y) position


Syntax

OpenLiveMouse(<nXStart>, <nYStart>)


Arguments

<nXStart>
Starting X coordinate for mouse cursor (in pixels).

<nYStart>
Starting Y coordinate for mouse cursor (in pixels).


Returns

-2
Mouse driver is not installed.

-1
Cannot open mouse in this video mode.

1
A one button mouse found.

2
A two button mouse found.

3
A three button mouse found.


Remarks

OpenLiveMouse() must be called prior to calling any other mouse functions. 
You must pass <nXStart> and <nYStart> to set the starting position of the 
mouse cursor. This function returns the status of the mouse driver or number 
of mouse buttons, if driver is loaded and mouse connected. It returns -2 if 
driver is not loaded even though a mouse is connected. Returns the number of 
buttons in situations where a mouse driver may be loaded with no mouse 
physically connected. You must have a mouse driver that supports Microsoft 
mouse compatible function calls through INT33. Your mouse driver should be 
configured for Microsoft mode rather than Mouse Systems, or other 
non-Microsoft modes.


Example

nStatus = FindVideoMode(640, 480, 16)
nStatus = OpenLiveMouse(0,0)
nStatus = Sleep(7)
nStatus = HideMouse()
nStatus = SunSay(0,0,8,15,1,"","Sample text string")
nStatus = ShowMouse()
nStatus = Sleep(7)
nStatus = CloseLiveMouse()
nStatus = TextMode()

For other examples of how to use the mouse support functions, see 
SUNMOUSE.PRG, an example program distributed with Sunshow Pro.