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

 twREHotSpot( nRowTop, nColLeft, nRowBot, nColRight,
              bAction, nButton, nPause, lRelease )
 ----------------------------------------------------------------------------

     Define a region of the screen to be used as a hot spot for a mouse
     action code block when twReadModal() is operating. If you are going
     to have several hot spots in operation, it is prudent to store the
     handles in an array so they may be released more easily and also
     so a reference to the array may be passed to other functions to
     disable the hotspots when others are active. (  See twRESpotOff/On ).

     NOTE: MEMORY USED BY HOT SPOTS MUST BE RELEASED WHEN YOU ARE
           FINISHED WITH IT. THE PROGRAMMER IS IN COMPLETE CONTROL OF
           MEMORY USE WHEN DEFINING HOT SPOTS. ( twRERemHotSpot() )

       Arguments:

     nRowTop   -+
     nColLeft   |- 'N' Screen coordinates of hot spot region.
     nRowBot    |
     nColRight -+

     bAction  - 'B' Code block to be executed when mouse button nButton
                    is pressed in the hot spot region.

     nButton  - 'N' The mouse button used to execute the code block.

                        1 - Left Button.
                        2 - Right Button.
                        3 - Both buttons.

     nPause   - 'N' The pause time to wait after the mouse command is
                    executed. This defaults to the time set by
                    twSetMPause().

     lRelease - 'L' Logical to indicate whether the mouse button should
                    be released before executing the code block. It is
                    wise to set this to .T. for most actions. If you do
                    not, you may end up calling the code several times.

       Return:

     Handle for the hot spot.

       Example:

     aMouseID[ 1 ] := twREHotSpot( 24, 0, 24, 9,;
                                   Help(),  1,, .T. )