MonthNavigator.mcc

Description

MonthNavigator is a Custom Class of the Magic User Interface © by Stefan Stuntz.
It's a subclass of group-class.

The idea of this class was born during developing my Gregor application.

MUI public custom class showing a field with the days of a specified month in a specified year.
The user decides if the names of the weekdays and the numbers of the weeks will be shown. Also it is possible for the user to set which weekday should be the day on which a week was started - the language for the weekday names can also be chosen.

A special feature of this class is, that it correctly handles October 1582. In this month the days 5-14 didn't exist, because they were removed by the Gregorian calendar reform. This calendar reform happens in different years for different countries, so the user can set his country with the user preferences.

Users can change the display of MonthNavigator with the following features:

Show/Hide names of the weekdays
Select name of weekday with which a week starts
Select the language to use for the names of weekdays (out of 19)
Show/Hide numbers of weeks
Select the country for the Gregorian calendar reform (unusable as long as the date.library has not fully implemented this feature)
Set the distance between the day-field and the names of weekdays/numbers of weeks
Choose between american and european layout
Fix the day-field to 6 rows
Use frames for day-fields
Show/Hide unused day-fields
Display the last/first days of the previous/next month within the unused day-fields.
Define how days of the previous/next month should be highlighted
Define how the internal 'mark today' hook should highlight today

MonthNavigator supports also the following features which might be of interest for developers:

Dropping a date-object onto a MonthNavigator will set this date as the actual one
Objects can be dropped onto the days
Days can be dragged around
Days can be marked by changing the following attributes:
- MUIA_Text_PreParse
- MUIA_Background
- MUIA_ShortHelp
- MUIA_Disabled
Supporting MUIM_Import and MUIM_Export
Dates can be correctly selected from 0008-01-01 to 8000-12-31 by using the DateLib (TM)