WBox() - Places a frame around the active window
Places a frame around the active window
──────────────────────────────────────────────────────────────────────────────

Syntax

WBox( [<cFrameString | nFrameType>] [, <nWindow> ] [, <cTitle> ] )
--> nWindow

Arguments

<cFrameString> defines a string of eight border characters and one
fill character. If only one characters is passed, that character is
used to draw the whole box.

<nFrameType> allows you to use one of eight predefined box types

<nWindow> an optional numeric, representing the window, to apply the
border changes to. If not passed, the current window is used.

<cTitle> an optional title for the window

Returns

WBox() returns the current window as a numeric.

Description

WBox() may be used to give a border to a window. WBox() may be used to
give the current window a border, or with the use of an optional window
number, give or change a specific window a border.

You may pass down parameters similar to that used by the CA-Clipper
@...BOX command, see BOX.CH for further character strings ore you may
use 1 of 8 predefined border character sets as shown below:

0 1 2 3 Blank fill character
╔═════╗ ┌─────┐ ╒═════╕ ╓─────╖
║ ║ │ │ │ │ ║ ║
║ ║ │ │ │ │ ║ ║
╚═════╝ └─────┛ ╘═════╛ ╙─────╜
4 5 6 7 No fill character


8 9 10 11 Blank fill character
███████ █▀▀▀▀▀█ ▐▀▀▀▀▀▌ ▐█████▌
█ █ █ █ ▐ ▌ ▐ ▌
█ █ █ █ ▐ ▌ ▐ ▌
███████ █▄▄▄▄▄█ ▐▄▄▄▄▄▌ ▐█████▌
12 13 14 15 No fill character

If no arguments are supplied, then a double line box is drawn around the
current window and the window is filled with the CLEARB character.


Examples

■ This example applies a solid character border to a window

WBox( 8, nWindow )

Files: Library is MRWINDOW.LIB.