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

                           Data Widgets (TM)

                 Bound Custom Controls for Visual Basic

                            Version 1.00c
                           April 26, 1994

          (C) Copyright 1993, 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 Data 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      New Features/Additions

 2      Documentation Notes

 3      Notes on Running the Sample Programs
 
NOTE:	Refer to HISTORY.TXT for a complete revision history.



=========================================
Part 1 - New Features/Additions
=========================================

In addition to the various fixes included in this maintenance
release, some enhancements and/or additions were also included.
This section describes these enhancements. See the online help
for a complete description of these features and refer to the 
HISTORY.TXT file for a complete revision history.

Version 1.00c:
==============
-	For a non-modifiable DataGrid that has its SelectByCell
	property set to TRUE, when the active cell is in a column
	whose ColBtn() property is TRUE the button will now appear.
	The BtnClicked event will be triggered when the user clicks 
	on the button, presses the space bar or presses any one of the 
	following keys:
		F4
		Alt+down arrow
		Alt+up arrow

-	Topics have been added to the Help file for the Column Layout
	Editor and a new 'Help' button has been added to the main screen
	of Column Layout Editor to access them. This was needed because 
	F1 was already being used for bringing up help on the individual
	column properties (determined by the active cell). However, F1 
	will also now work from the 'Security', 'Fields' and 'Set Color' 
	dialogs	that the Column Layout Editor displays. In addition, 
	sample code has been added to many of the property topics in the
	Help file.   

-	Version 1.0c is primarily a bug fix release (see HISTORY.TXT). 
	However, it corrects some bugs that may affect existing programs 
	if these programs were relying on a previous version's incorrect
	behavior. Therefore, you should be aware of the following:

	    - Setting the Redraw property of a DataGrid to TRUE no 
	      longer causes all the rows to be re-loaded (triggering 
	      RowLoaded events for each visible row). If you were
	      expecting this to happen you now have to refresh the 
	      DataGrid with an SSDatagrid1.Refresh statement.

	    - In order to conform to standard textbox behavior, the
	      Change event of the DataCombo is now fired when the
	      data control (that the DataCombo is bound to) is positioned
	      to a new record as well as when the form is initially loaded.

	    - In your existing apps, you may have had to add code 
	      (e.g. Refresh statements) to work araound some of the
	      painting and initialization problems of earlier versions.
	      In certain situations this code might now cause flicker, 
	      so you may want to remove this unnecessary code.

Version 1.00b:
==============
-	New IsCurrentCellValid property has been added to the
	DataGrid. This is a runtime only property which is used
	to force validation of the current cell and trigger the
	CellUpdated event. This property would typically be
	accessed in the LostFocus event of the DataGrid.

-	New AllowInput property has been added to the DataCombo.
	This allows/disallows changing the edit portion by typing
	via the keyboard. If AllowInput is set to FALSE then
	selections must be made from the drop down list.

-	Also, if the AllowInput property is set to FALSE typing in
	a character will cycle through the entries in the list that
	start with that character. This emulates the behavior of
	the standard combo with a Style of 2 (DropDownList) and
	works whether or not the list is dropped down.
	The DataGrid behaves this way as well when positioned
	on a column that has a DataDropDown attached and that has
	its ColAllowInput() property set to FALSE.

-	Changed the behavior of the DataCombo to respond to the
	up/down arrows by selecting the previous/next list item
	even when the list is not dropped down. This conforms to
	the standard combo box behavior.

-	Changed the behavior of the DataCombo to allow access to the
	ColText() and Row properties even if the list has not been
	dropped down.

-	New FixedCols property has been added to the DataGrid,
	DataCombo, and DataDropDown. This property specifies the
	number of columns that are fixed (do not scroll
	horizontally).

-	New VariableFixedCols property has been added to the
	DataGrid.  When set to TRUE, will provide a splitter bar
	which the user can drag to adjust the # of FixedCols.

-	Added FixedColsChanged event to the DataGrid. This event
	will fire whenever the number of fixed columns has been
	changed or the user has moved the splitter bar (see
	VariableFixedCols above).

-	Added TextFieldType property to the DataCombo. This allows
	the edit portion of the DataCombo to have a field type.
	Works like ColFieldType in the DataGrid.

-	New RowChanged property has been added to the DataGrid.
	Setting this property will cause the modified indicator in
	the Row label to be updated for bound and unbound DataGrids.

-	Added SelStart, SelLength and SelText properties to the
	DataCombo and DataGrid.

-	Added the standard MouseDown, MouseMove and MouseUp events to
	the DataCombo.

-	Added the standard MousePointer property to the DataGrid and
	the DataCombo.

-	Added HdgStyle property to the DataGrid, DataCombo and
	DataDropDown. This property will set the style of the headings
	and row labels to be 2D (using the HdgBackColor) or 3D (ignoring
	the HdgBackColor).

-	Added HdgBackColor property the DataGrid, DataCombo and
	DataDropDown. This will set the back color of the headings and
	row labels. This property is only used when HdgStyle is set to
	0-2D (HdgBackColor used).

-	The following are new properties that allow control over the font
	and color of each column's heading. These properties are normally
	set in the InitColumnProps event:

	-	HdgCellForeColor(x)=color
	-	HdgCellBold(x) = boolean
	-	HdgCellItalic(x) = boolean
	-	HdgCellUnderline(x) = boolean
	-	HdgCellStrikeThru(x) = boolean


-	The following are property arrays that allow control over the font
	and color of each cell:

	-	RowCellForeColor(x)=color
	-	RowCellBackColor(x)=color
	-	RowCellBold(x) = boolean
	-	RowCellItalic(x) = boolean
	-	RowCellUnderline(x) = boolean
	-	RowCellStrikeThru(x) = boolean

-	NOTE: If the 'RowCell' properties are set within the
	RowLoaded event, they will apply to the row being loaded.
	Otherwise, they apply to the Row specified by the EvalRowNumber
	property.

-	Clicking the right mouse button when the cursor is positioned
	over a column heading in a DataGrid will collapse that
	column to a minimum width. If several columns are selected,
	clicking the right mouse button over one of the selected columns
	will collapse all selected columns.  Clicking over a
	collapsed column (or selected group of columns) will restore
	the column(s) to their previous uncollapsed width.

-	Clicking the right mouse button over the rectangular area
	just to the left of the column headings (and above the
	row labels) will restore all collapsed columns to their
	previous uncollapsed widths (see above).

-	The Data Widgets Column Layout Editor user interface
	has been expanded to support up to 300 columns (the old limit
	was 100 columns).  It also has a new 'Security' option that
	lets you supply a userid and password when accessing
	secure Microsoft Access databases.

-	The ColFieldName field in the Column Layout Editor is
	now modifiable (not forcing a selection from the drop down
	list).

Version 1.00a:
==============
-	New DeleteSelected property has been added to DataGrid
	control to allow programmatical deletions of selected
	rows.

-	Added new property IsItemInList to DataCombo and
	DataGrid to determine if text in edit portion is in the
	list.

-	A new error number has been added to the list of
	potential runtime errors.
	The constant SS_ERR_UPDATECANCELLED is defined in
	SSDATA.BAS.  It is returned from the DataGrid if the
	DataGrid aborts from an attempt to write a row with
	an invalid field.  This message can optionally be
	overridden by setting the Response parameter to 0 in
	the data control's Error event.

-	The Data Widgets Column Layout Editor user interface
	has been improved and now has the option to automatically
	create columns.

Version 1.00
============
	Original release.


=========================================
Part 2 - Documentation Notes
=========================================

Since printing of the final copy of the manual, there have been some changes to the
Data Widgets controls which do not appear in the manual.  These changes are in the
Help file but not in the documentation.

-	The WhereClicked parameter in the Click event for the Enhanced Data Controls
	is incorrectly documented.  The WhereClicked parameter is defined as:

		0 - First row button
		1 - Previous page button
		2 - Previous row button
		3 - Save bookmark button
		4 - Goto saved bookmark button
		5 - Next row button
		6 - Next page button
		7 - Last row button
		8 - Caption
		9 - All other sections (border, etc.)

-	Several additional sample projects have been included.  See the online help
	under the topic "Included Files" for a description.

-	The AutoSize property is missing from the manual.  See the online help for a
	description.

-	The CaptionType property is missing from the manual.  See the online help for a
	description.

-	The Click event for the Enhanced Data Controls (SSVData, SSHData) has a new
	parameter called WhereClicked.  See the online help for a description.

-	The RowsResized property is incorrectly spelled on page 147 of the manual.

-	The manual incorrectly lists a property called BookmarkCurrent in the
	Properties Reference chapter.  There is no longer a BookmarkCurrent property.

-	The MaxRowsEachScroll property is incorrectly spelled as "MaxRowsPerScroll"
	on page 122 in the Properties Reference.

-	SelStartBookmark and SelEndBookmark properties are missing from the manual.
	See the online help for a description of these properties.

-	The AllowNull property is spelled incorrectly on various pages of the manual
	as "AllowNulls".

-	The AllowNull property should be omitted from the property list for the
	DataCombo on page 52.

-	All references to the "Format" property in chapters 11 and 12 should be changed
	to TextFormat.

-	See 'Part 1 - New Features/Additions' for brief descriptions of any new properties
	and events.  Refer to the online help for more complete descriptions.



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

The samples programs are setup so that they refer to VBX files and BIBLIO.MDB in the
Data 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
\SSDATWDG\SAMPLES\DROPDOWN, the working directory must be \SSDATWDG\SAMPLES\DROPDOWN.

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.
