Click above to get retro games delivered to your door ever month!

POS_ONOFF()                                                         C_EXAM03
   Turns the mouse positioning on or off for a specified region.

   Syntax
         POS_ONOFF(nPosOnOrOff [,nHotRegion])

   Arguments
         nPosOnOrOff Sets the mouse positioning on or off.
                     0 = Turn mouse positioning OFF (Default).
                     1 = Turn mouse positioning ON.
         OPTIONAL PARAMETERS
         nHotRegion  Sets the region number affected. If not specified, the
                     current region is assumed.

   Returns
         None

   Description
         POS_ONOFF() turns the mouse positioning display on or off whenever
         the mouse cursor is within the specified region.

         Mouse positioning is the display of the current mouse cursor location
         in current world scale coordinates. As the mouse cursor is moved
         across the viewport, the display is updated.

         nHotRegion sets the region of the screen that the display will be
         associated with. You can set regions of the screen with REGN_INIT().
         A region can have its own cursor style so when the mouse moves in and
         out of the region, the cursor will change.

   Examples

         Placement and attributes for current position of mouse:

         POS_SIZE()               && No parameters - automatic sizing
         POS_ATTR(0,30,2)         && Row, Column, Font
         POS_ONOFF(1,1)           && Pos on, region 1
         POS_COLOR(1,7)           && fg, bg
         POS_REFER()              && Cursor reference coordinates
                                  && No parameters set reference to origin