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

  W2FRONT()                                                  Window Function
 Purpose..: Promote a background window to the top
-------------------------------------------------------------------------------
 Syntax...: w2Front( <uWin> ) --> lSuccess

 Arguments: <uWin>  = the string identifier of the window to move
                      OR the reference to the window structure
                      returned as an array by wNew() or wArray().
                      If not passed, the function will operate on
                      the window in focus.

 Returns..: lSuccess is true if successful.

 Remark...: The function is essential to an event-driven desktop.
            If an window needs to be on top, this function will do it.

            You need not open the windows to put one on top.

 Source...: W2FRONT.PRG
-------------------------------------------------------------------------------
 Example..: . This example opens 3 windows and then promotes the
              bottom window to the top.

            wOpen( "A" )
            wOpen( "B" )
            wOpen( "C" )

            w2Front( "A" )