[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 WBOARD()
 Allocates allowable screen area for windows
------------------------------------------------------------------------------
 Syntax

     WBOARD([<nTopRow>, <nLeftColumn>, <nBottomRow>,
        <nRight Column>]) --> nError

 Arguments

     <nToprow>, <nLeftcolumn>, <nBottomrow>, <nRightcolumn>  Designate
     the screen coordinates (upper left and lower right) within which windows
     can be opened.

     ()  If WBOARD() is called without parameters, then the window border is
     reset to the boundaries of the physical screen, which as a rule
     corresponds to a call of WBOARD(0, 0, 24, 79).

 Returns

     WBOARD() returns a -1 if an error occurs.   If no errors occur, WBOARD()
     returns a 0.

 Description

     This function defines the screen area where windows are permitted.
     Windows are subsequently only visible in this defined area.  You can use
     this function to protect an area of the screen from being overwritten
     with windows, even when you allow the user to move the window
     interactively.  The boundaries designated by WBOARD() become the screen
     boundaries for window functions.

 Notes

     .  WBOARD() is only effective when there are no open windows.

     .  Always consider that closing individual windows or all the
        windows never influences the setting of the window border.  So if you
        neglect to specifically eliminate the window border, you can have
        unanticipated problems later when you open windows.

 Example

     Leave only the upper half of the screen free for window functions:

     WBOARD(0, 0, 12, 79)


See Also: WACLOSE() WCLOSE() WSETMOVE() WMODE()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson