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

  WTITLE()                                                   Window Function
 Purpose..: Define the title of a window
-------------------------------------------------------------------------------
 Syntax...: wTitle( [<uWin>], [<cTitle>], [<cClr> [, <nType>]] ) --> 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.

            [<cTitle>] = title text for the window.  If no title
                         is wanted but a title box is, insert double
                         quotes (i.e. "") which is the default.
                         If it is not passed, the previous one is
                         erased.

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


            [<nType>]  = title area type.

            Title Type Manifest Constants as found in FW_MAIN.CH
            --------------------------------------------------------
            Value  FW_MAIN.CH       Description
            --------------------------------------------------------
            0      WT_BOX           Draw a border around the title.
            1      WT_NOBOX         Default. Display title on
                                    top line of window.
            2      WT_BAR           Draw a window with a title
                                    cross bar that spans it's width.
            --------------------------------------------------------

 Returns..: NIL

 Remark...: wTitle() defines the title of the window. The value
            in quotes is centered in the area or on the top line
            of the window. The function is not required to define
            a window. If it is not used, the default (i.e. no title
            and no title box) will be used. The function changes
            the previous version or assigns a new title.

 Source...: WTITLE.PRG
-------------------------------------------------------------------------------
 Example..: The example is the creation of a window instance
            called "Four", with the color attribute of bright white
            on cyan. The title area with the entry "Window 4"
            in yellow on cyan.

    wNew   ( "Four", 12, 40, 19, 70, "W+/BG" )
    wTitle ( "Four", "Window 4", "GR+/BG", WT_BOX )