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

  WFRAME()                                                   Window Function
 Purpose..: Define the default window frame
-------------------------------------------------------------------------------
 Syntax...: wFrame( [<uWin>], <uFrame> [, <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.

            <uFrame> = parameter that can take a pre-defined
                       frame type or a custom frame type. To use
                       a custom frame type, see the guide options
                       titled:
                          Reference -> Creating Custom Frames.

                       The table below lists the pre-defined
                       frame types using the code convention where
                         B_ = Box class
                         N  = North or top line
                         E  = East or right side
                         S  = South or bottom line
                         W  = West or left side

            Frame Type Manifest Constants as found in FW_BOX.CH
            --------------------------------------------------
            Value  FW_BOX.CH    Description
            --------------------------------------------------
             1     B_SSSS       single line box
             2     B_DDDD       double line box
             3     B_SDSD       NS-single EW-double
             4     B_DSDS       NS-double EW-single
             5     B_SSDD       NE-single SW-double
             6     B_SDDS       NW-double SE-single
             7     B_DSSD       NW-double SE-single
             8     B_DDSS       NE-double SW-single
             9     B_THICK      thick solid
            10     B_LIGHT      shaded light
            11     B_MEDIUM     shaded medium
            12     B_HEAVY      shaded heavy
            13     B_NONE       spaces - DEFAULT
            --------------------------------------------------

            [<cClr>] = window frame color. If not
                       specified, the window will default to the
                       window color defined in wNew().

 Returns..: NIL

 Remark...: This function will work on either an active or
            inactive window. If the window is inactive, it
            will define the window's frame. If active, it will
            both define and physically update the display of
            the window's frame.

            If you define a window to be the whole screen, then
            do not use wFrame(). Bleeding to the restored screen
            occurs usually.

 Source...: WFRAME.PRG
-------------------------------------------------------------------------------
 Example..: . The example uses wFrame() to have the instance
              created by wNew() inherit a single line frame,
              displayed with the color combination of green on blue.

            wNew  ( "MyWin",,,,, "GR+/B" )
            wFrame( "MyWin", B_SSSS, "G/B" )

 Note.....: If no color string is sent to wFrame(), "MyWin" will
            default to the color string defined for it by wNew().