|
Readme
|
Calendar Bean Suite Version 2.0
Calendar Bean Suite Version 2.0 contains a basic class
called Calendar and additional theme and plugin beans. The Calendar bean, when used
on its own, provides date and year information. Additional beans
are used to customize and increase the functionality of the calendar.
See the documentation
provided with this package for system requirements and installation instructions.
What's New in This Release?
- A holiday editor has been implemented for handling holiday dates. Now any dates (also relative and yearly repeating dates) can be added
to or deleted from Calendar. See "How to use the Holiday Editor?" for details.
- A new customizable property (firstDayOfWeek) has been introduced to set the required day of week as the first day of week.
If it is not set, Calendar gets the first day of week from getFirstDayOfWeek() method of java.util.Calendar class according to the regional settings of the operating system.
- A new customizable property (selectType) has been introduced to determine what type of days can be selected.
If it is set to every day (it is the default), any day can be selected. If it is set to workday, only workdays can be selected.
If it is set weekend/holiday, only Sundays, Saturdays and holidays can be selected. There is no automatic selection any more. User should select a date.
- Double click on a selectable day generates an event (dateSelectedEvent) which can be used for a required action.
- New colors have been applied to give better distinction of special days (backgrounds, current day, holidays, weekend days).
- Drawing defects of the day focus circle have been eliminated.
Changes Made in Previous Releases
- The calendar is drawn according to the current country settings.
- A Win2000 bug has been fixed.
- Several documentation bugs have been fixed.
- Property bugs have been fixed - now the beans work flawlessly in BeanBox.
- There was a very serious bug that blocked the bean from loading theme JPG's from the JAR (lack of using ClassLoader to be independent of the source). This was fixed.
- When the bean was first displayed, it took a while to draw itself in Java 2. This bug was eliminated by using Media Trackers.
- Method setSelectedDate() now works fine.
Late Breaking News
Known limitations
-
The calendar is drawn according to the regional setting if firstDayOfWeek property is not set: that is, it draws Monday as the first day of week in French,
and Sunday in English-speaking countries. Due to a nasty bug in java.util.GregorianCalendar.getFirstDayOfWeek(), in small European countries that use Monday (like Hungary) Sunday will be drawn as the first day.
This is a bug of Java, and not the bean. This was why the firstDayOfWeek property has been introduced. Also, the automatic switch and the firstDayOfWeek property doesn't work with custom, pre-drawn themes, because they don't draw anything
programmatically, but from a JPEG file. This feature only works with the default theme.
-
Symantec Visual Cafe (Datebase Edition 3.0)
Simplest test class (Calendar bean in a Frame) can run but only with the default
settings of the firstDayOfWeek and the selectType properties. After setting holidays
these holidays are displayed in the same color as other dates.
-
JBuilder (Professional 2.0)
The holidays and the initialDate properties are not displayed in the property
sheet. The simplest test class (Calendar bean in a Frame) can't run. (No errors
are reported.)