RAT_POSIT() Positions the mouse cursor at row,column coordinates Returns None Syntax RAT_POSIT(nRow,nColumn) Description Move the mouse cursor to nRow,nColumn. Examples RAT_OFF() RAT_POSIT(0,0) // upper left hand corner RAT_ON() Notes: Be sure to RAT_OFF() before doing this. Source: S_MOUSE.ASM
Tag Archives: mouse
SP_RAT_ON
RAT_ON() Sets the mouse cursor on
Returns
None
Syntax
RAT_ON()
Description
Turns the mouse cursor on
Examples
if rat_exist()
rat_on()
* do something, or wait for something...
rat_off()
endif
Notes:
There must be a rat_on() call for each rat_off() call
in succession.
In other words, if you do:
rat_off()
rat_off()
you must then do:
rat_on()
rat_on()
to turn on the mouse cursor, as it is stacked.
e.g.
if rat_exist()
rat_on()
* do something, or wait for something...
rat_off()
endif
RAT_EVENT() takes care of the mouse on/off settings,
so if you use RAT_EVENT(), you need not use RAT_ON()/RAT_OFF()
Source: S_MOUSE.ASM
SP_RAT_OFF
RAT_OFF() Sets the mouse cursor off
Returns
None
Syntax
RAT_OFF()
Description
Turns the mouse cursor off
Examples
if rat_exist()
rat_on()
* do something, or wait for something...
rat_off()
endif
Notes:
There must be a rat_on() call for each rat_off() call
in succession.
In other words, if you do:
rat_off()
rat_off()
you must then do:
rat_on()
rat_on()
to turn on the mouse cursor, as it is stacked.
e.g.
if rat_exist()
rat_on()
* do something, or wait for something...
rat_off()
endif
RAT_EVENT() takes care of the mouse on/off settings,
so if you use RAT_EVENT(), you need not use RAT_ON()/RAT_OFF()
Source: S_MOUSE.ASM
SP_RAT_NOMOUSE
RAT_NOMOUSE() Sets the mouse flag to false, regardless of if there is a mouse and driver or not Returns None Syntax RAT_NOMOUSE() Description RAT_NOMOUSE() Sets the mouse flag to false, regardless of if there is a mouse and driver or not Examples RAT_NOMOUSE() Source: S_MOUSE.ASM
SP_RAT_LEFTB
RAT_LEFTB() Determines if the left mouse button has been
pressed
Returns
<lHasBeenPressed> => left mouse button has been
pressed
Syntax
RAT_LEFTB()
Description
This returns .t. if the left button has been pressed
since last call to this function. Row and column are recorded
for reference by rat_rowl() and rat_coll().
Examples
if rat_leftb()
?"While you were out:"
?"Left button was depressed at"
??rat_rowl(),rat_coll()
endif
Notes:
This is different from RAT_LBHD() in that RAT_LBHD()
is a 'right now' function - determining if the button IS
depressed, whereas this function determines if the button HAS
been depressed.
Source: S_MOUSE.ASM
SP_RAT_LBHD
RAT_LBHD() Determines if the mouse left button is currently
depressed
Returns
<lDepressed> => mouse left button is currently
depressed
Syntax
RAT_LBHD()
Description
Determines if the mouse left button is currently
depressed
Examples
if RAT_LBHD()
?"Mouse left button depressed NOW"
endif
Notes:
This is different from the event function
RAT_ELBHD(). RAT_ELBHD(<n>) watches the mouse for <n> seconds,
and if the mouse remains depressed for the full time, then it is
considered to be HELD DOWN. RAT_LBHD() on the other hand, only
checks for the mouse button being depressed RIGHT NOW.
RAT_ELBHD() calls RAT_LBHD() repetitively.
Source: S_MOUSE.ASM
SP_RAT_FORCE
RAT_FORCE() Sets the mouse flag to True, regardless of if there is a mouse and driver or not Returns None Syntax RAT_FORCE() Description RAT_FORCE() Sets the mouse flag to True, regardless of if there is a mouse and driver or not Examples RAT_FORCE() Source: S_MOUSE.ASM
SP_RAT_EXIST
RAT_EXIST() Determines if a mouse is available
Returns
<lExists> => mouse is available
Syntax
RAT_EXIST()
Description
This tells if a mouse is present, and mouse driver
software is loaded. The mouse state is not changed.
Examples
if rat_exist()
* do some mouse stuff
else
* don't do some mouse stuff
endif
Notes:
Many mouse libraries use a call to Interrupt 33,
service 0 to determine if a mouse is present. This has the
unpleasant effect of resetting the mouse to its defaults. This blows away
mouse position, cursor and other nifty things that may have been set.
This function uses another means to determine if a
mouse is present, and does not reset the mouse or damage any mouse
settings, thus you can use it with other mouse-oriented libraries
without dire consequences.
Source: S_MOUSE.ASM
SP_RAT_COLR
RAT_COLR() Returns mouse column at the last right button
press
Returns
<nColumn> => mouse column at last right button press
Syntax
RAT_COLR()
Description
Returns mouse column at the last right button press
(as recorded by a call to rat_rightb() )
Examples
if rat_rightb()
?"While you were out:"
?"Right button was depressed at"
??rat_rowr(),rat_colr()
endif
Notes:
This is different from RAT_COL() in that RAT_COL()
tells the mouse row NOW whereas RAT_COLR() tells where the mouse
was at the last recorded right button press (as recorded by a
call to rat_rightb() )
Source: S_MOUSE.ASM
SP_RAT_COLL
RAT_COLL() Returns mouse column at the last left button press
Returns
<nColumn> => mouse column at last left button press
Syntax
RAT_COLL()
Description
Returns mouse column at the last left button press
(as recorded by a call to rat_leftb() )
Examples
if rat_leftb()
?"While you were out:"
?"Left button was depressed at"
??rat_rowl(),rat_coll()
endif
Notes:
This is different from RAT_COL() in that RAT_COL()
tells the mouse row NOW whereas RAT_COLL() tells where the mouse
was at the last recorded left button press (as recorded by a
call to rat_leftb() )
Source: S_MOUSE.ASM
