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

 twTitle( cString, wColor, _Row, _Justify, _Delim )
 ----------------------------------------------------------------------------
     twTitle is a powerful function allowing headers and footer to be
     displayed in the current window in a wide variety of ways.

     The colour of the title, its position (top, bottom, centered, left
     justification, right justification) and delimiters can be defined
     by the programmer.

     The window stack is updated when this function is called.  Title
     strings and colours are inserted at the appropriate place in the
     stack's title array.

       Arguments:

     cString   - 'C' The title to be displayed.

     wColor    - 'C' Clipper colour attribute. Defaults to SETCOLOR().

     _Row      - 'C' Two values may be passed:

                     'T' for TOP or HEADER. The title is displayed on
                     the top line of the current window.

                     'B' for BOTTOM or FOOTER. The title is displayed
                     on the bottom line of the window.

                     Shadow positions are accounted for.  The function
                     defaults to 'T'.

      JUSTIFY  - 'C' Three values are allowed:

                     'C' for CENTERED
                     'L' for LEFT Justified
                     'R' for RIGHT Justified.

                     This defaults to 'C'.

      DELIM     - 'C' Any characters may be used for delimiters. A two
                      character string is passed. The first is for the
                      left delimiter, the second for the right. The
                      function defaults to spaces, ie., the title will
                      be padded with one space on either end of the
                      string. Borders may be continued into the header
                      with characters such as '|-' using the DELIM
                      parameter.  The delimiters are THE SAME COLOUR as
                      the string in this version of TSDWIN.LIB.


       Return:

                      Current window handle.


       Example:

     twTitle( "Trilateral Systems", "", "T", "C" )

     Creates a header in the current window, centered on the top line,
     in the current window colour and delimited with spaces.

     twTitle( "LEFT", "gr+/r", "T", "L" )

     Creates a left justified header on the current window, delimited
     with spaces in yellow/red.

     twTitle( "Window Library", "w+/r", "B", "C", "|-" )

     Creates a centered footer on the current window, delimited with
     box characters on bright white/red. The programmer must keep track
     of the box border characters in this version of TSDWIN.LIB. We
     don't do smart delimiters yet.