xHarbour Reference Documentation > Function Reference

WBoard()

Determines the area that can be used for displaying windows.

Syntax

WBoard( [<nTop>]   , ;
        [<nLeft>]  , ;
        [<nBottom>], ;
        [<nRight>]   ) --> nErrorCode

Arguments

<nTop> and <nLeft>

Numeric values indicating the screen coordinates for the upper left corner of the screen area. Both default to zero.

<nBottom>

Numeric value indicating the bottom row screen coordinate. It defaults to MaxRow().

<nRight>

Numeric value indicating the right column screen coordinate. It defaults to MaxCol().

Return

The function returns 0 if the useable screen area could be defined, otherwise -1 is returned.

Description

WBoard() restricts the area for displaying windows on the screen to the rectangle specified with the given coordinates. Windows are not visible outside this rectangle, even if they are moved beyond its boundaries. If no parameter is passed to WBoard() the area useable for displaying windows is reset to the entire screen. WSelect(0) also selects the entire screen for screen output.

Info

See also:	WClose(), WMode(), WSetMove(), WAClose()
Category:	CT:Window , Windows (text mode)
Source:	ct\ctwin.c
LIB:	xhb.lib
DLL:	xhbdll.dll