Tag Archives: RAT_EXIST()

SP_RAT_ROWL

Posted on by vivaclipper 
RAT_ROWL() Returns mouse row at the last left button press

 Returns
 <nRow> => mouse row at last left button press

 Syntax
 RAT_ROWL()

 Description
 Returns mouse row 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_ROW() in that RAT_ROW()
 tells the mouse row NOW wherease RAT_ROWL() tells where the
 mouse was at the last recorded left button press (as recorded by
 a call to rat_leftb() )

 Source: S_MOUSE.ASM

 

SP_RAT_ROW

Posted on by vivaclipper 
RAT_ROW() Current mouse row

 Returns
 <nRow> => mouse row right now

 Syntax
 RAT_ROW()

 Description
 This gives the CURRENT mouse row

 Examples
  ?"Mouse is at row :",rat_row()

 Notes:
 This is different from RAT_ROWL() or RAT_ROWR() in
 that these two functions return the recorded row when the mouse
 button was last pressed, RAT_ROWL() for left or RAT_ROWR() for
 right.

 This function tells where the mouse is right now.

 Source: S_MOUSE.ASM

 

SP_RAT_POSIT

Posted on by vivaclipper 
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

SP_RAT_ON

Posted on by vivaclipper 
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_EXIST

Posted on by vivaclipper 
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_COLL

Posted on by vivaclipper 
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

SP_RAT_ISMOUSE

Posted on by vivaclipper 
RAT_ISMOUSE()

  Short:
  ------
  RAT_ISMOUSE() Determines mouse usage by RAT_EVENT()

  Returns:
  --------
  <lIsMouse> => is there a mouse

  Syntax:
  -------
  RAT_ISMOUSE([lIsMouse])

  Description:
  ------------
  Determines mouse usage by RAT_EVENT(). Default is
  determined by a call to the ASM function RAT_EXIST(). However,
  you may want to shut down mouse usage even if a mouse is
  present. If so, call this function with False, to override.

  [lIsMouse]  S_MOOSE.PRG contains a static variable
  called 'lIsMouse'. This is determined initially by a call to
  RAT_EXIST(), but may be overridden by calling RAT_ISMOUSE(.f.).

  Examples:
  ---------
   RAT_ISMOUSE(.f.).

  Source:
  -------
  S_MOOSE.PRG

See Also : RAT_ELBHD(), RAT_EQMCOL(), RAT_EQMROW(), RAT_ERBHD(), RAT_EVENT(), 
           RAT_LASTEV(), RAT_MENU2(), RAT_READ()