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

REGN_SET()                                                          C_EXAM03
   Defines attributes for specified region.

   Syntax
         REGN_SET(nRegion [,nLeft,nTop,nRight,nBottom,nScanCode], nCursor)

   Arguments
         nRegion     Defines the region number to set.
         nCursor     Cursor shape to display within region.
         OPTIONAL PARAMETERS
         nLeft       Sets the left horizontal coordinate of region.
         nTop        Set sthe top vertical coordinate of region.
         nRight      Sets the right horizontal coordinate of region.
         nBottom     Sets the bottom vertical coordinate of region.
         nScanCode   Sets the scan code for alternate activation key.

   Returns
         None

   Description
         nLeft, nTop, nRight, nBottom set a mouse region as a rectangular area
         on the screen. When the mouse cursor enters or leaves the region, the
         cursor shape will change according to how it was defined with nCursor.
         The mouse cursor that was set at the time the REGN_SET() function was
         called becomes the cursor for default region 0. You can change the
         default cursor by changing it with MS_CURSOR() before calling
         REGN_INIT().

         A mouse region is a rectangular area on the screen such that when the
         mouse cursor enters or leaves the region, an event will be generated.
         nScanCode can be set to release a region event 8 from KEY_PRESS()
         each time the cursor changes regions. The event returned by
         KEY_PRESS() will have a scan code value of 214, indicating a region
         has been crossed. KP_ASCII() will indicate which region the mouse
         cursor has exited and MS_REGION() will return the region that has
         been entered. If nScanCode is set to 0, the region event will not
         release from KEY_PRESS().

         The region can be set off by calling the REGN_OFF() function and
         reinstated with a call to REGN_ON(). If no regions are specified, the
         cursor region will always default to region 0, which is the full
         screen, and the original cursor that was defined.

         Region definitions can be changed by calling REGN_SET() again with
         new parameters. You can set a region off by setting REGN_SET() X,Y
         coordinates to 0.