==========================================================================

                         Designer Widgets (TM)

                    Custom Controls for Visual Basic

                             Version 1.00a	
                              May 23, 1994

          (C) Copyright 1994 by Sheridan Software Systems, Inc.
                            35 Pinelawn Road
                       Melville, N.Y. 11747   USA

                        Voice   (516) 753-0985
                        Fax     (516) 753-3661
                        BBS     (516) 753-5452

==========================================================================

This document contains release notes for Designer Widgets Custom Controls.
Information in this document is more current than that in the manuals or
online Help.

------------------------
How to Use This Document
------------------------
To view README.TXT on screen in Windows Notepad, maximize the Notepad window.

To print README.TXT, open it in Windows Write, Microsoft Word, or another
word processor.  Then select the entire document and format the text in
10-point Courier before printing.


========
Contents
========

Part    Description
----    -----------

 1	About Designer Widgets

 2	Enhancements

 3	Sample Program Listing

 4	Revision History

 5	Documentation Notes

 6      Notes on Running the Sample Programs


=========================================
Part 1 - About Designer Widgets
=========================================

Designer Widgets consists of three custom controls to provide state-of-the-art 
interfaces much like the interfaces found in most of today's hottest commercial
Windows applications.  The custom controls are:

	1.	SSToolbar - The Dockable Toolbar Control
		
		This control is a toolbar that can be docked at the top, left, 
		bottom, or right of an MDI application or detached from a docking 
		area to become a free floating toolbar.  The control can also
		be used on a regular form to provide a stationary toolbar.

	2.	SSIndexTab - The Index Tab Control

		The Index Tab control lets you provide the same state-of-the art
		interface that many of todays commercial applications provide. 
		This interface is based on a metaphor that is familiar to all 
		users, that of a series of index cards.

	3.	SSFormFX - The FormFX Control

		The FormFX control allows customizing of the caption and client 
		areas of a non MDI form. In addition, FormFX allows you to control 
		the behavior of the form at runtime by restricting size and movement.  


=========================================
Part 2 - Enhancements
=========================================

This section lists all the enhancements made to Designer Widgets for each release of
the software.  See the new help file for more information on some of these features.

Version 1.00a:
==============

1.	Designer Widgets now comes with a utility called the Toolset Bitmap Editor.  
	This program is used to create toolset bitmaps containing to be	used with the 
	Dockable Toolbar control.  The new Toolset Bitmap Editor automatically creates
	buttons for you from an image you supply.  You can either draw the image, or 
	simply capture it from the screen.

	This program (TSEDITOR.EXE) resides in your main Designer Widgets directory
	(usually \SSDESWDG) and can be accessed via File Manager or from the 'Run' 
	command in the 'File' menu of Program Manager.  

2.	FloatingWidth and FloatingHeight properties have been added to the Dockable 
	Toolbar.  These properties are read only and return the the width and height 
	of the toolbar in its floating state.

3.	The Toolbar Designer now allows you to move buttons to different locations on 
	the toolbar by dragging them.  You can also remove buttons from the toolbars
	by dragging them off the toolbar.



Version 1.0:
============
	Original 1.0 release.  No enhancements.


=========================================
Part 3 - Sample Program Listing
=========================================

Below is a list of all the directories that contain sample projects included with 
Designer Widgets and a brief description of what they contain.  All of these
directories can be found under the SAMPLES directory in your main Designer Widgets 
directory.


TBARCONF - This subdirectory contains a project that shows how to allow the user
	   to select buttons from a dialog box at runtime and position then buttons
	   on a toolbar in an MDI application.

TBARDYNA - The project in this directory shows how to configure a toolbar at runtime
	   using individual bitmaps for each button and button state.

TBARSAVE - This sample project contains routines to save the properties of your toolbars
	   in a Windows INI file so that you can configure them at start-up to appear as
	   the user left them.

CHAPTER5 - These are the sample projects described in chapter 5 of the manual.

CHAPTER6 - These are the sample projects described in chapter 6 of the manual.

CHAPTER7 - These are the sample projects described in chapter 7 of the manual.


=========================================
Part 4 - Revision History
=========================================

Version 1.00a:
==============

1.	Dockable Toolbar now fires click event for 'Push' 
	type buttons when its mnemonic character is 
	pressed.

2.	Fixed GPF when clicking on last button on a 
	Dockable Toolbar and in the MouseUp event 
	decreasing Btns by 1.

3.	FloatingWidthInBtns property in the Dockable 
	Toolbar now returns the corrrect number of 
	buttons across if the property is initially set 
	to 0.

4.	Balloon Help did not appear again after you click 
	on a button in the Dockable Toolbar until the 
	mouse moved off the button and returned.  Balloon 
	Help now displays after a click but not until the 
	first mouse move.

5.	The Refresh Method works correctly on the 
	Dockable Toolbar.

6.	The GPF that occurred if you unload the form in 
	any event of the Dockable Toolbar is fixed.

7.	Fixed bug that caused the grouping of buttons on 
	a floating toolbar to be incorrectly positioned.

8.	Displaying a PopupMenu in the MouseDown event of 
	the Dockable Toolbar now works correctly.

9.	Fixed GPF that occurred when you run two EXE's 
	each with a Dockable Toolbar and close one of 
	them.

10.	Fixed bug that caused the dock ordering to be 
	incorrect when setting the DockRank and 
	DockRankSeq properties.

11.	Fixed lock up problem when setting the TabPicture 
	property of the Index Tab to a Picture property 
	from another control.

12.	Fixed GPF that occurred when you place a Combo 
	Box on an Index Tab control.  This GPF only 
	occurred when the combo was in a container 
	control and when you close the form that the 
	Index Tab control is on.

13.	Fixed bug where TabsPerRow returned the wrong 
	value if you set the TabsPerRow property less 
	than the number of tabs in the Index Tab control.

14.	The Index Tab control now paints itself correctly 
	when setting the TabBackColor(), TabForeColor(), 
	or TabPicture() properties in a loop.

15.	Fixed GPF that occurred when running 2 EXE's, 
	both containing an Index Tab control, then 
	closing one of them.

16.	Changed the Dockable Toolbar so that when a 
	toolbar with no buttons becomes floating, the 
	floating toolbar size is at least one button high 
	and wide.

17.	Dockable Toolbar no longer appears when you 
	initially set the Visible property to False at 
	design time.

18.	The Index Tab control now fires the MouseDown, 
	MouseMove, MouseUp and DblClick events when the 
	mouse is over the tab portion of the control.  
	The coordinates returned are relative to the 
	client area of the Index Tab control, therefore 
	the Y-coordinates will be negative.

19.	Setting the TabPicture property of the Index Tab 
	control to the Picture property of another 
	control more than once caused a GPF.

20.	DblClick event now gets triggered when you double 
	click anywhere on the Index Tab control.

21.	Dockable Toolbar now does not show up at runtime 
	when you set the Visible property to False at 
	design time.

22.	Floating toolbars with the Toolbar3D property set 
	to True did not repaint when a modal form was 
	show.



Version 1.0:
============
	Original 1.0 release.  No revisions.



=========================================
Part 5 - Documentation Notes
=========================================

Since printing of the manual, there have been some changes to the Designer Widgets 
controls which do not appear in the manual or are incorrectly documented:

-	The standard Left, Top, Width, and Height properties onlye apply to stationary
	toolbars (non-floating/non-dockable).  If you want to get the dimensions of a 
	floating or docked toolbar, you need to call the Windows API GetWindowRect.  See
	the Windows SDK Reference for a complete description of this API function.

-	The WordWrap property has been added to the Index Tab control.  This property
	causes text on each tab to automatically wrap to the next line if the tab is 
	not wide enough to fit it.  

-	The ClientLeft and ClientTop properties have been added to the Index Tab control.
	See the online help for a complete explanation of these properties.

-	The ClientHeight and ClientWidth properties have been added to the Index Tab control.
	See the online help for a complete explanation of these properties.



=============================================
Part 6 - Notes on Running the Sample Programs
=============================================

The samples programs are setup so that they refer to VBX files in the Designer 
Widgets install directories.  In order to load the project files correctly, your
"working directory" must be the directory that contains the sample programs.  For
example, if you want to load the project in the samples directory called
\SSDESWDG\SAMPLES\CHAPTER5, the working directory must be \SSDESWDG\SAMPLES\CHAPTER5.

To ensure the working directory is correct, you can either load the sample project
by double clicking on the project MAK file in File Manager, or set the working
directory in the Properties dialog in Program Manager for your Visual Basic icon.
For more information on setting the working directory, see your Windows documentation.


