
Click above to get retro games delivered to your door ever month!
X-Hacker.org- TSDWIN: Clipper 5.0 Interface Library - Norton Guide
[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
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.
See Also: twLeft() twRight() twCenter() twPutTitles() twPop() _twHandle()
Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson