DESCRIPTION OF QBWINDOW LIBRARIES FOR QUICKBASIC VER 4.0/4.5

QBWindow is a windowing/menuing routine to be used with Microsoft
QuickBasic Versions 4.0 and 4.5. It is supplied in two forms: a quick
library (.QLB) to allow access to the routines while in the QuickBasic
Environment, and a normal library (.lib) to allow access to the routines
when creating .EXE files. The libraries were written with a combination
of assembly language and QuickBasic. The screen saving and restoring
parts of the library were written in assembly language for speed.

If you are using QBWindow in the QuickBasic Environment, make sure you
use the /l option to load QBWindow.QLB as the quick library.

There are 5 routines that can be called using QBWindow. They are
described below along with their syntax. See the sample program
windtest.bas for examples on how these routines are used.


InitWind
---------

Syntax:
Call InitWind(LineT%, fg%, bg%, Shad%)

where,

LineT%=Line type to use in drawing window (1=double line, 0=single line)
fg%=Window foreground color
bg%=Window background color
Shad%=Window Shadow Flag (1=use shadow,0=no shadow)

This routine sets up parameters for any window that is drawn using
DrawWind. InitWind should be called before any other routines from
QBWindow are called. It can then be called when a change in window
drawing parameters is desired. All windows drawn following InitWind
will be drawn with the parameters specified until the next InitWind is
called.

DrawWind
---------

Syntax:
Call DrawWind(TopR%, LeftC%, BotR%, RightC%, Title$, WindN%)

where,

TopR%=Top row of window (1-24)
LeftC%=Left column of window(1-78)
BotR%=Bottom row of window(2-25)
RightC%=Right column of window(2-80)
Title$=Window title (if any)
WindN%=Window number(1-5)

This routine draws a window using the parameters specified in the
parameter list and in the most recent InitWind. The title will be
centered in the top row of the window. If no title is desired, a null
string should be included in place of Title$. The window number will be
used by the CloseWind, MenuV, and MenuH routines. Specify a unique
window number of 1 through 5 (up to 5 windows can be open
simultaneously) each time DrawWind is called.


CloseWind
----------

Syntax:
Call CloseWind(WindN%)

where,

WindN%=Window number to close.

This routine closes the window associated with the specified window
number. The window area of the screen will be restored to its contents
at the time of the DrawWind call for that window.


MenuV
------

Syntax:
Call MenuV(WindN%, Men$, fg%, rfg%, rbg%, Stch%, Rtrn%)

where,

WindN%=Window number to use in creating vertical menu.
Men$=String defining Menu choices.
fg%=Foreground color to use for the menu choices.
rfg%=Foreground color to be used for the highlighted choice.
rbg%=Background color to be used for the highlighted choice.
Stch%=Choice number to highlight on entry to the menu.
Rtrn%=Variable holding choice number selected (=20 if Esc was used)

This routine sets up a vertical "pop-up" menu using the contents of Men$
as the menu choices. The choices are automatically centered in the
window (make sure there is enough room for the choices). The choices
can be selected by using the cursor keys (Home and End also) or by
pressing the quick key for each choice which is shown as the only
capitalized letter in the choice. Numbers cannot be used as quick keys.
Choices should be separated by commas. As an example,
Men$="Load,Save,Quit". All choices should have one unique letter
capitalized to specify the quick key for that choice. Stch% specifies
the choice that should be highlighted on entry into the menu. Rtrn%
must be specified as an integer variable which holds the choice made by
the user (=20 is Esc key was pressed by the user).


MenuH
------

Syntax:
Call MenuH(WindN%, Men$, fg%, rfg%, rbg%, Stch%, Rtrn%)

where,

WindN%=Window number to use in creating horizontal menu.

Men$=String defining Menu choices.
fg%=Foreground color to use for the menu choices.
rfg%=Foreground color to be used for the highlighted choice.
rbg%=Background color to be used for the highlighted choice.
Stch%=Choice number to highlight on entry to the menu.
Rtrn%=Variable holding choice number selected (=20 if Esc was used)

This routine sets up a horizontal "pop-up" menu using the contents of Men$
as the menu choices. The choices are automatically centered in the
window (make sure there is enough room for the choices). The choices
can be selected by using the cursor keys (Home and End also) or by
pressing the quick key for each choice which is shown as the only
capitalized letter in the choice. Numbers cannot be used as quick keys.
Choices should be separated by commas. As an example,
Men$="Load,Save,Quit". All choices should have one unique letter
capitalized to specify the quick key for that choice. Stch% specifies
the choice that should be highlighted on entry into the menu. Rtrn%
must be specified as an integer variable which holds the choice made by
the user (=20 is Esc key was pressed by the user).

Jay Messner
CIS 71251,2271