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

  WFOOTER()                                                  Window Function
 Purpose..: Assign a permanent window footer
-------------------------------------------------------------------------------
 Syntax...: wFooter( [<uWin>], [<cMsg>], [<cClr>] ) --> NIL

 Arguments: [<uWin>] = the string identifier of the window
                       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.

            [<cMsg>] = text to be used in the footer display.
                       If it is not passed, the previous one is
                       erased.

            [<cClr>] = color of the footer text.

 Returns..: NIL

 Remark...: The function is used to assign a footer centered
            on the bottom of the window in focus' border. It changes
            the previous version or assigns a new footer. If it is
            used on a window that is not yet opened, the footer is
            stored until the window is displayed.

            As with all FreshWin window functions that alter the display,
            this function hides and redisplays automatically the mouse
            cursor if it is active.

 Source...: WFOOTER.PRG
-------------------------------------------------------------------------------
 Example..: . The example will display a permanent footer
              in the window, "MnuWin".

            wNew     ( "MnuWin", 8, 9, 22, 49, "W+/BG+" )
            wTitle   ( "MnuWin", " Main Menu ", "W+/BG+", WT_BAR )
            wFrame   ( "MnuWin", B_THICK, "W+/BG" )
            wFooter  ( "MnuWin", " <Esc> to Exit " )
            wShadow  ( "MnuWin", B_SHADOW( , S_HALF ) )