CODE-IT Menus & Windows Version 2.1
Copyright (C) 1991-1992, Clear Software. All Rights Reserved.

Clear Software
14962 Bear Valley Rd. Ste. G
Victorville, Ca. 92392
Telephone (619)243-4749 FAX (619)241-3256

Welcome to CODE-IT Menus & Windows. This file lists new information about
version changes and serves as a road map to the document and program files on
the CODE-IT disk(s). The sections included are:

INTRODUCTION - Enplanes CODE-IT.
INSTALLATION - How to install CODE-IT
UPGRADES - Current upgrade information.
FIXES and NOTES - Bug fixes and special notes
FILES - Descriptions of the disk files.


****INTRODUCTION:

CODE-IT is a tool box of flexible user interface libraries for the
Microsoft(r) BASIC language programmer (QuickBASIC 4.5 and BASIC PDS 7.x
versions are available).

CODE-IT 2.1 includes complete library modules for building menus and windows.
The programmer can use the combined quick library included with the set to
immediately begin building programs, or they can mix and match the individual
libraries in just about any way.

* Pull Down Menus
* Pop Up Menus
* Ring or vertical menus
* Fully Programmable data windows
* Scrolling Windows
* Tagging windows
* Alerting windows
* Text display windows
* Screen saving and restoring
* Screen painting, box drawing.
* Video hardware detection
* Selective screen scrolling
* Extended keypress detection(alt, ctrl, etc.)
* Mouse routines

And more!

All the menus and windows have complete mouse support built in.
Data windows can have text, boxes, lines, edit fields with controlled keyboard
input and output, and several types of buttons.

No royalty fees are charged for programs developed with the registered version
of the CODE-IT Menus & Windows.






Clear Software backs the CODE-IT tool box with a 90 day money back guarantee
for registered users - no questions asked.


SYSTEM REQUIREMENTS

IBM XT, AT, PS/2 or compatible computer running DOS 2.1 or higher and
Microsoft(r) QuickBASIC 4.5 or BASIC PDS 7.x.

REGISTRATION

Registration costs for the CODE-IT Menus & Windows tool box are $59.00.
Shipping and handling are FREE anywhere in the U.S.A., air services are
available at an additional cost. QuickBASIC and BASIC PDS versions can be
registered at the same time for $79.00 for both! Canada S & H are $10.00 -
$15.00 Outside North America.

Registered users get the following:
* Printed programmers reference manual
* The most recent version of the software
* 1 year FREE tech support
* A 90 day money back guarantee - no questions asked.

****INSTALLATION:

Beginning with batch 2107 the files on the distribution disks are now
compressed. The installation program included with CODE-IT will decompress the
files and place them in the directory and drive of your choice. To install
CODE-IT place the disk in your floppy drive and type A:INSTALL (assuming you
are installing from the A: floppy drive. If your using the B: drive then type
B:INSTALL). Follow the instructions on the screen to install the files.

If you are installing over old CODE-IT files the program will ask you if you
want to replace it with the new file. Type "Y" to overwrite the old file or
"N" to skip it.

****UPGRADES:

GETTING A NEW BATCH UPDATE - We are constantly improving existing and adding
new routines to the CODE-IT toolbox. Many times we will have several batch
releases of the same version. These are updates, not program upgrades. A
program upgrade will have a version number change as well as a batch number
change. To find out which batch you have there is a file on the disk set named
BATCH. View it and you will see the version and batch number you have.

You may obtain a batch upgrade for the version of CODE-IT you have or have
registered. If you want to get the newest batch version you can do so by
sending us a letter and $7.00 for Non-Registered users or $5.00 for registered
users. Make sure to tell us either QuickBASIC or BASIC PDS, what disk size,
and if your NOT a registered user, your address. Please mention your current
batch number also, we don't want to charge you for the same one you





already have.

A NOTE TO REGISTERED USERS - If you have not received your two free upgrades
yet you may want to wait for them to come out as they will also have the new
routines and improvements. If you want the newest batch version before the
next upgrade release follow the guidelines mentioned above to obtain one.

VERSION 2.1
Beginning with version 2.1, the data entry windows in CIWIND1.LIB can interact
with the pull down menus in CIMENU1.LIB. This allows the user to select the
pull down menus with the ALT key or mouse while in the middle of updating any
data field or button on the active window without having to first close the
window. If your upgrading from version 2.0 you only need to add a few lines to
your code to make this possible. No other changes need to be made to your
existing code.

A new SUB was needed to make this wizardry possible. This SUB is called
WindowToPull and is located in the CIWIND1.LIB.(CIALLQB.LIB for QuickBASIC or
CIALLB7.LIB for BASIC 7.x contain the CIWIND1.LIB). See your program manual
for details on how to use this file. There is also an additional demo file
called CIDEMOMW.BAS which uses the new interactive format.

MousePut was added to CIMOUSE allowing you to put the mouse cursor anywhere on
the screen at any time, even when the mouse cursor is hidden. Also, the mouse
routines are now all written in assembly language.

NEW KEY DETECTION IN CIWIND1.LIB - This window now detects the pressing of
the Page Up and Page Down keys while the window is active. If one of these
keys has been pressed, a call to WindowEvent will return 23 for Page Up and 24
for Page Down.

Also, CIWIND1 now has CTRL+key press detection fully programmable by you. A
new SUB routine called WindowCtrlKey was added for the purpose of defining
these CTRL keys. Up to 10 CTRL+key combinations can be defined at one time and
are active on all windows created with CIWIND1 during the execution of your
program. Use the following format:

CALL WindowCtrlKey(keyNumber%, ctrlKey$)

EXAMPLE: Suppose you wanted to detect the CTRL+P and CTRL+L keypress when the
window created with CIWIND1 is active. Before you make the window active you
would use the following lines in your code:

CALL WindowCtrlKey(1, "P")
CALL WindowCtrlKey(2, "L")

Now when these key combinations are pressed while the window is active, al
call to WindowEvent would let you know. WindowEvent will





report the keypress of a CTRL key numerically with 31 through 40 (keyNumber 1
= 31, keyNumber 2 = 32, and so on).

****FIXES and NOTES

SCROLLING and TAG WINDOW BUG
The bug which caused junk to appear on the screen when scrolling past the last
window member in the scrolling and tagging windows has now been fixed. The bug
which allowed the mouse to move the highlight bar past the last member in a
scrolling or tagging window has also been fixed.

CREATING CUSTOM LIBRARIES
The CITOOLS library currently uses the routines of QB.LIB (for QuickBASIC) or
QBX.LIB (for BASIC PDS 7.x). If you create custom libraries make sure to
include either of these in it.

BASIC PDS USERS
When compiling and linking your programs created with CODE-IT, make sure to
use the /Fs switch with the BASIC PDS compiler. This switch causes the use of
far strings and is the default from within the QBX.EXE environment.

EDIT FIELD COLORS
When using CIWIND1 make sure to place the call to EditFieldColors before the
call to EditFieldDefine. The demo module included with earlier versions of
CODE-IT showed this incorrectly.

****FILES:

FILE PURPOSE
_________________________________________________________________

MANUAL.DOC This is the main documentation file. Use the DOS
"Print" command to print this file on your dot-matrix
or laser printer. Or you could also use a text viewer
if you wish. This document includes installation
instructions, information about the libraries and how
to use them, and a complete tool box reference section
for each of the libraries.

REGFORM.DOC The registration forms for the CODE-IT Menus & Windows
set. Use the DOS "Print" command to print the file.

VENDOR.DOC An introduction to the CODE-IT Menus & Windows library
set for dealers and distributors.

README.DOC This file.


*.LIB The files with an extension of LIB are the CODE-IT
library files used to build your





programs.

*.QLB Quick libraries for use in either the QuickBASIC or
BASIC PDS environment depending on the version you
currently have. The quick libraries contain all the
CODE-IT libraries combined.

*.BI The include files for the above libraries.

*.BAS The source code files used to demonstrate the
different menu and window tool box libraries.

BATCH The current version's batch number. The same version
may have several batch numbers due to software
updates.

For more detailed information on the files and their uses see the CI.DOC file.