Program Description:

Clarion Windows Bitmap Buttons (CWBB) VBX is a custom VBX
Control demonstrating the use of an industry standard Level 1 VBX
control to create Buttons in CW which have Bitmaps and Text. The
Sample demonstrates a main screen Button Bar, but the VBX can be
for any Buttons in a CW Application.

Legal Notice:

CWBB is copyrighted(c) 1994 by Robert Butler & Kevin Stilwell
This Program is freeware and may be freely used and distributed,
including as part of a commercial program, as long as you do not
remove the copyright notice, or attempt to sell CWBB as a
separate program.  No warranties are expressed or implied.
No Technical Support is provided.  Use this CWBB at your own risk.
CWBB has not been put through normal testing as of this Release.
Robert Butler can be contacted on CompuServ CIS @ 76660,1514.

Current Release:

This release of CWBB VBX is dated 25JUL94.

Development Systems Used:

Developed and tested using Clarion for Windows Beta 3, Build 530
and Microsoft Visual C-C++ Release 1.0

Incorporating CWBB VBX:

The CWBB VBX is incorporated into your CW Application just
like any other Level 1 VBX, and complies with CW documentation
for VBX use.  Incorporate the CODE in CWBB.CLW into your CW
Application, register CWBB.VBX in the Clarion environment, and
use the VBX tool in the Clarion Screen Formatter.

Customizing Your VBX Button Bar

Use the Clarion Screen Formatter to add, delete, and position
the buttons. Use any industry standard Windows Resource Editor
to change the Bitmap and Text shown on each Button. The
Button's size and appearance cannot be changed without re-
making the VBX (If there is enough interest, we will release
the source code for the VBX.  However, it would be a lot of
work to explain and comment the code.  Also, since Clarion may
soon offer a Bitmap/Text button feature, we'll wait to see
what Clarion does).

The size of the button is optimized for a Button Bar
considering the following factors:

     Size of the Bitmap corresponds to the size of an Icon so
     that there is a matching Icon for when a Window is closed
     down to an Icon.

     Maximum word size without having the Button size
     overpowering the Bitmap, allowing 7 or 8 characters
     depending on Font.

     A generally square shape with space for 3D hinting which
     is common for Button Bars.

     Maximum number of Buttons at 640x480 given the above
     considerations and equally divides the Button Bar area
     with a very small left and right margin.

Unfortunately meeting the above criteria does not create a
Button that fits into any of the CW Screen Formatter grids.
You can turn the Grid on for top and bottom alignment of the
Buttons, but left and right alignment may work best by setting
the X/Y coordinates in the Screen Code using the Editor.

Changing the Bitmap and Text

A VBX is really just a C language DLL program that adheres to
certain calling conventions.  Just like any Windows EXE or
DLL, Windows Resources, (i.e. Icons, Bitmaps, Diaglogs, etc)
are "binded" into the EXE or DLL during the final link.	 These
can be edited by any Windows Resource Editor, such as
Microsoft's, App Studio or Borland's Visual Resource Editor.

Simply start the Resource Editor, select open file and choose
CWBB.VBX (just like any *.RC file).  There will be two types
of resources listed, Bitmaps and Strings.  Select Bitmaps and
you will see a list of Bitmaps starting with reference 5000.
Select String Text and you'll see strings starting with
reference 5500.	 You cannot change these numbers.  The
following is the relation of the reference numbers and the
button:


    Bitmap Ref	String Ref  Button No.	Default Text

	5000	    5500	 0	   New
	5001	    5501	 1	   Open
	5002	    5502	 2	   Save
	5003	    5503	 3	   File
	5004	    5504	 4	   Print
	5005	    5505	 5	   Setup
	5006	    5506	 6	   Tools
	5007	    5507	 7	   Custom
	5008	    5508	 8	   Timer
	5009	    5509	 9	   Action
	5010	    5510	 10	   Notes
	5011	    5511	 11	   Calc
	5012	    5512	 12	   E-Mail

CWBB.VBX itself does NOT have to be re-compiled if only the
Windows Resources are changed.	However, if the VBX is changed
even by a Resource Editor, you must make sure you do the
following in your CW Application:

     Copy the modified CWBB.VBX to \WINDOWS\SYSTEM or your
     Program directory with Path settings that enable your CW
     Application and Windows to find the VBX.

IMPORTANT NOTES:

(1) CW Beta 3 does not release VBX's from memory, even after
you exit the CW Application that called the VBX.  If you have
started a CW Application that uses the VBX, you must
completely exit Windows, before you will be able to edit the
VBX.  Likewise, after you have edited the VBX, you may have to
completely exit Windows, so that the newly modified VBX can be
reloaded into memory to replace the unmodified one which might
be remaining in memory.

(2) A GPF error listing CDDWVBX.DLL when starting a CW
is usually the result of failure to copy the new VBX to the
proper directories, or the CW Application cannot find the VBX.

Files Included With This Sample VBX:

The following Files should be included with this Sample VBX.

	       CWBB.VBX		    25JUL94
	       CWBBTEST.EXE	    25JUL94
	       CWBBTEST.PRJ	    25JUL94
	       CWBBTEST.CLW	    25JUL94
	       README.TXT	    25JUL94

ENJOY and GOOD LUCK!!!

All The Best... Bob & Kevin, DATA.TXT Corporation

