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

WBOX()

Syntax:     WBOX() ([<expC>])

Arguments:  <expC> corresponds to a string with up to nine characters to
            surround and fill a window.  A double-lined frame is the default
            if no argument is passed and the window is filled with CHR(255).

Returns:    A numeric value.
            The number of the window in use.

Usage:      This function will operate like Clipper's box command,
            except that WBOX() will always enclose the selected window.
            It will therefore be possible to indicate a single character to
            envelope the whole window or up to nine different characters
            for the horizontal and vertical lines, the  corners , and one
            character which is used to fill the window.  The characters will
            be used for the frame from the top left hand corner
            clockwise.  The window is filled with the ninth character.

Note:       The available working area of the window will be reduced by
            two lines and two columns because of the frame (as
            WFORMAT(1,1,1,1)).  It is not possible to write beyond the
            window frame.  The window frame will be reduced each time
            WBOX() is called.  If the window is to small to enclose the
            WBOX(), -1 is returned and the call to WBOX(0 is ignored.
            It is possible to place a title on the top line of the window
            by specifying a negative value for the top row.

Library:    CT1.LIB


--------------------------------- Example ------------------------------

Examples:   window_no = 5
            WSELECT(window_no)
            WBOX("+-+|+-+|# ")

            This will enclose window number 5 with a double
            line and fill it with CHR(176).
            The output area of the window will then be reduced
            on each side by 1.