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

  Name:     m_wait() - pause until the user releases the mouse button
  Usage:    m_wait(<button>)
  Params:   integer <button> - the button to wait for, 0 = left,
            1 = right and 2 = middle (3 button mice only)

  Returns:  nothing

 ---------------------------------- Example ---------------------------------

            This example displays a little box, and then if the user
            clicks on it, it is redisplayed in reverse while the
            user is still holding the button down. As soon as the
            button is released, it is repainted in the normal color.
            This simulates the normal Macintosh Flash feature...

            cls()
            m_csron()
            box(18,32,20,47,m_frame(),standard())
            print(19,33," Click On Me  ")
            do while .T.
                    if (m_region(18,32,20,47) .and. _isbutton(0))
                           m_csroff()
                            box(18,32,20,47,m_frame(),enhanced())
                            m_csron()
                            m_wait(0)
                            m_csroff()
                            box(18,32,20,47,m_frame(),standard())
                            m_csron()
                    endif
            enddo

  Note:     This function is very useful to control more closely how
            menus and popup boxes react to the mouse. It will make
            your mouse routines easier to use if you m_wait() for the
            user to release the button before you branch to the next
            item in your prompts.