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

Calendar Widgets (TM)

Sheridan Reusable Components

Version 1.00
Tuesday, June 6, 1995

(C) Copyright 1995 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
CompuServe       GO SHERIDAN

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

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

Please read this entire document first. There are many new features that you do not 
want to miss.

------------------------------------
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 Calendar Widgets
 2      Sample Program Listing
 3      Revision History
 4      Documentation Notes


=========================================
Part 1 - About Calendar Widgets
=========================================

Calendar Widgets is a set of custom controls which allow you 
to create applications that display and manage date and time 
information.  It is designed to facilitate the creation of a 
wide range of systems including data entry, accounting, 
billing, etc., where there may be a need to keep track of and 
view dates and times.

There are four controls that make up Calendar Widgets.  The 
following is a brief description of the features of each control.

1. MonthView Control - The MonthView control allows you to 
display dates in a monthly view.  Up to 3 months may be displayed 
at once.  Special days, holidays and other events can be made 
to visually stand out by assigning colors, fonts and pictures.  
Additionally, any day or day of the week can be disabled, for 
restrictive date selection.

2. YearView Control - The YearView control has all the features 
of the MonthView control with the added functionality of 
displaying one year at a time.  With the ability to add color 
and pictures, this control can be the foundation of any 
year-planning application.  In addition, the YearView control 
is also data aware.

3. DateCombo Control - The DateCombo is especially suited for 
designing data entry forms.  A full-featured version of the 
MonthView control is available as a dropdown for easy selection 
of dates.  The DateCombo is also data aware.

4. DayView Control - The DayView control displays a daily time 
schedule.  An adjustable time scale allows you to view schedules 
to varying amounts of detail.  Multiple tasks can be scheduled at 
any time.


=========================================
Part 2 - Sample Program Listing
=========================================

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

SSCWDEMO - This subdirectory contains two projects that show how to
use the controls in Calendar Widgets.

SSCWDEMO - This sample project demonstrates the major features of 
the controls in Calendar Widgets.

DATEPAD  - This sample project shows how the various Calendar 
Widgets controls can be used together to create a Personal 
Information Manager (PIM).

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.

CHAPTER8 - These are the sample projects described in chapter 8 of the manual.

NOTE:	If you receive a "Can't find CALENDAR.MDB" error when 
running SSCWDEMO from the VB design mode, you need to make sure 
that VB is started from the directory containing SSCWDEMO.MAK.


=========================================
Part 3 - Revision History
=========================================

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


=========================================
Part 4 - Documentation Notes
=========================================

Since printing of the manual, there have been some changes to 
the Calendar Widgets controls which do not appear in the manual 
or are incorrectly documented.  All corrections have been made 
to the Calendar Widgets on-line Help file.

- A correction has been made to Page 33 of the Programmer's Guide.  
Step 3 of 'Exercise 3: Maneuvering The DayView Control' should 
read "Set the Caption property of the DayView control to 'Daily Schedule.'

- Corrections have been made to Page 36 of the Programmer's Guide.  
The If-Then-Else block in the code should read:

	If AutoFlag = False Then
	   SSDay1.X.Tasks.Add StartTime, EndTime, Description, MyColor
	Else
	   SSDay1.X.Tasks.Add StartTime, EndTime, Description
	End If

- A correction has been made to Page 37 of the Programmer's Guide.  
The block of code in Step 9 should read:

	Sub Form_Load()
	   Combo1.AddItem "Auto"
	   Combo1.AddItem "Red"
	   Combo1.AddItem "Green"
	   Combo1.AddItem "Blue"
	   Combo1.ListIndex = 0
	End Sub

- Corrections have been made to Appendix A of the Programmer's Guide.  
New files have been added to the list of files that are copied to 
the WINDOWS\SYSTEM directory.  Additional files will also now be 
copied to the WINDOWS\SYSTEM32 directory. See 'Included Files' under 
'Technical Specifications' in the Calendar Widgets Help file for details.

- In addition to the above correction, a new section has been added 
to the Calendar Widgets Help file called "Distribution Notes." This 
section lists Microsoft files that need to be shipped with your 
applications. This new section can be found under the Technical 
Specifications section of the Help file.

- A 'Note' has been added to the 'X Object' section of Appendix C in 
the Programmer's Guide regarding the use of the X object from a Visual 
Basic BAS module.

- A new error message has been added to the list of Trappable errors.
SS_ERR_BADHOST (Error Number 32020) is displayed when you attempt to set
the Format property in a host enviroment that does not support date
formatting.

- The Reset method has been added to the StyleSets collection.  
This method turns all properties of a particular StyleSet off although 
the StyleSet itself can still be accessed later on.

- The SelChanged event has been added to the MonthView control.  This 
event is fired after a change in selection status has occurred.  This 
event will not fire if the RtnCancel parameter of the SelChange 
event is set to TRUE.

- The ShowTaskColor property has been added to the DayView control.  
This property determined whether a rectangle with the Task BackColor 
appears to the left of tasks.

- The CloseEdit and ShowEdit events of the DayView control now pass 
in Index and Action parameters. The first is the index of the task 
in the task collection. The second is an indicator of whether the 
task was added or edited. The CloseEdit event also now passes in the 
Cancelled and Changed parameters. The first indicates whether the 
user has pressed <ESC> to cancel changes made to a task. The second 
indicates whether or not a change was made.

- The WeekNumber method of the DateCombo, MonthView and YearView control
now has its parameters correctly documented.  The default value of the 
FirstWeek parameter is '1-First four day week from Sunday.'  The default
value of the FirstMonth parameter is '1-StartMonth.'

- The AutoSelect property is now correctly documented as defaulting to TRUE
for the DateCombo control and FALSE for the MonthView and YearView 
controls.

- The Month object is now correctly documented as supporting the Picture and
PictureStyleSet properties for the MonthView control only.

- The TagVariant property is now correctly documented as being able to store 
any data type except user defined types.

- The 'Keyboard Interface' of the DateCombo is now correctly documented as
moving the cursor to the beginning or end of the edit portion, when the
CTRL+LEFT ARROW/HOME or CTRL+RIGHT ARROW/END keys are pressed, only when
the EditMode property is set to '0 - Whole Date'.

- Variant parameters passed into the WhereIs, TaskFromPos, TimeFromPos,
TimeHeight, TimeLeft, TimeTop, TimeWidth, TaskHeight, TaskLeft, TaskTop 
and TaskWidth methods are correctly documented as needing use the
CVar function to overcome problems experienced when using Visual Basic.

- When passing values returned from an X object to a Method invoked through
an X object, the value must first be placed into a variable.  This is 
correctly documented in 'Passing Values to Methods Using the X Object' in
the 'X Object' section under 'Compatibility Issues.'

- The 'Pictures' section of Appendix C (Compatibility Issues in the help 
file) is now correctly documented.  When using the VBX version of a 
Calendar Widgets control, a picture in a sub-object that is set via 
the Picture property can be removed by setting the Picture property 
to an empty sting ("").

- The 'Index' parameter of the ShowEdit and CloseEdit events of the
DayView control has been changed to 'TaskIndex'.

- The 'Clear' property listed in the SelectedDays Collection of the 
control reference should be listed as the 'Count' property.

- The See Also, Example, and Applies To lists in the help file now work
correctly.

- The Search and Browse functions of the help file now work correctly.
