***************************************************************************
*
*  McKean Consulting
*  Robin W. McKean
*  1042 Braddock Circle
*  Woodstock GA  30188
*
*  TBTN.VBX
*
*  Toolbar Button Control for Visual Basic 3.0
*
***************************************************************************

TBTN is a custom control which allows the Visual Basic developer to place
true "buttons" on a toolbar.  No longer will you have to write code to
swap out pictures when the mouse button is pressed or released.  Additionally,
the focus is not transferred to the TBTN control when it is selected with the
mouse.

***************************************************************************

This ZIP file contains:

	TBTN.VBX     	VB version of the TBTN custom control
	PROJECT1.MAK	Sample project file for TBTN
	FORM1.FRM	Form used by the sample project
	READ.ME		This file
	*.BMP		Various bitmap files used by the sample project


***************************************************************************

REGISTRATION

Time for the sob story.  This Toolbar Button Control is Shareware.  It is
NOT crippled in anyway.  When you download this custom control, you have
the same custom control that I am using in my everyday VB programming.
As a Shareware contributor, I am counting on the honor and moral fiber of
every person who downloads this custom control to do the right thing.  I
have contributed and participated in the Shareware arena for years now.
Your small contribution can make a difference to me and my family...

If you like and appreciate this custom control...

  1)  Send $7.00 to the address listed above
  2)  Register in the SWREG conference on Compuserve.  (ID 1611)

For Source...

  Send $25.00 to me at the above address.

***************************************************************************

ENHANCEMENTS and PROBLEMS

The control, as is, works the way that I want it to.  This does not mean
that it will work the way that you want it to.   Along those lines, I
totally disclaim that the control will do anything whatsoever.  This
includes any implied abilities and any WARRANTIES, including those for
SUITABILITY for a particular purpose, MERCHANTIBILITY, and all that other
bull crap.

With that aside, I would love positive criticism.  I will enhance the
control if I receive enough request to do so.  As I said, it works the way
I want to, and I hope some of you will find a positive use for it as well.
Contact me at the above address, Compuserve, or Shareware South here in
Atlanta if you feel the need to do so.

***************************************************************************

PROGRAMMER'S NOTES (or, what I need to know to use this custom control)

The following is a desciption of each additional property, what it does,
and how touse it in your own VB programming.


Picture

This property should be set at design or run-time to the bitmap you want
displayed when the button is in the UP, DOWN and DISABLED state.  The bitmap
should be evenly divisible by three.  The first third is the UP bitmap.  The
second third is the DOWN bitmap, and the final third is the DISABLED bitmap.

Enabled

This property, as it implies, enables and disables the button.  Enabling
the button causes the PictureUp bitmap to be displayed, and disabling
causes the PictureDisabled bitmap to be displayed.

Sticky

This property determines if the button remains in the toggled state when
pressed.  When pressed again it becomes "untoggled".

Toggled

This property is true if the button is in the toggled state.  Setting this
property to true causes the button to be toggled.

***************************************************************************

REACHING THE AUTHOR

I can be reached via U.S. Mail at the address listed above.  You can reach
me via E-Mail at the following locations...

Compuserve:		Robin W. McKean
			72622,1403

Shareware South:	Robin W. McKean
			Atlanta, GA

***************************************************************************

REVISION HISTORY

3.00.0000	Initial release of the TBTN.VBX custom control
3.01.0000	Removed PictureUp, PictureDown, and PictureDisabled in
		favor of one bitmap with three "button" pictures in it.
		This saves on load time and memory requirements.
3.02.0000	Added sticky qualities, border, and toggled property

***************************************************************************
