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

  WHBAR()                                                    Screen Function
 Purpose..: Draw a horizontal crossbar in a window
-------------------------------------------------------------------------------
 Syntax...: wHBar( [<uWin>], [<nRow>, [<nBar> [,
                      <nChrL> [, <nChrR> [, <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.

            [<nRow>] = Row to start "H-bar"   (default is 0).
            [<nBar>] = Cross bar piece        (default is 1).
            [<nChrL>]= Left column end piece  (default is 1).
            [<nChrR>]= Right column end piece (default is 1).

              Cross Bar & Column End
              -------------------------
              Value  Description
              -------------------------
              1      Single line.
              2      Double line.
              3      Thick single line.
              -------------------------

            [<cClr>] = window bar color. If not
                        specified, the window will default to the
                        window frame color.

 Returns..: NIL

 Remark...: Draw an "H" type bar in the window between the two edges.

            The function works whether the window is open or not.

 Source...: WBAR.PRG
-------------------------------------------------------------------------------
 Example..:   The following would draw the bar, #----#

               wOpen( "Next" )
               wHBar( , 2, 1, 3, 3 )

              The code will draw the following box:

               ######################
               #                    #
               #--------------------#
               #                    #
               #                    #
               ######################


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