Table of Contents Copyright - Copyright information Distribution - Copying conditions Disclaimer - Legal Information Trademark - Trademark information Support/Updates - How to get updates and support Author - How to reach the author Description - What is MonthNavigator.mcc? Requirements - Requirements for using MonthNavigator.mcc Installation - How to install MonthNavigator.mcc Beta testers - Installation information for beta testers Preferences - How to configure MonthNavigator.mcc Localization - For catalog translators Developer Info - Information for developers History - Revision history of MonthNavigator.mcc Todo - Todo list Known problems - List of known problems Acknowledgments - Acknowledgments Please rate - Please rate MonthNavigator.mcc Software - Software that uses MonthNavigator.mcc Copyright --------- This software and its documentation are copyright 1996-2000 by Dipl.-Inform. Kai Hofmann. All rights reserved! - Permission for COMMERCIAL USE is only given by an extra available commercial license that must be validated! Contact me directly for this license, because it will be individually handed out per your needs! - Permission is hereby granted, without written agreement and without license, to USE this software and its documentation for any NON-COMMERCIAL purpose, provided that the above copyright notice and the following paragraph appear in all copies of this software (Non-commercial includes Giftware!). Please send me a full version of your product at no cost including free updates! Distribution ------------ Permission is hereby granted, without written agreement and without license or royalty fees, to copy and distribute this software and its documentation for any purpose, provided that the above copyright notice and the following paragraphs appear in all copies of this software, to: - All who will distribute this software for free! - All free accessible INTERNET servers! - All Aminet® sites - Fred Fish for his great Amiga-Software-Library - The German SAAR AG PD-Library - Angela Schmidt's Meeting Pearls serie - All others who do NOT take more than US$ 5.- for one disk that includes this software! DISCLAIMER ---------- THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDER AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. THE AUTHOR HAS NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. Trademark --------- DateLib is a registered trademark of Dipl.-Inform. Kai Hofmann Amiga, AmigaDOS, AmigaGuide and Workbench are registered trademarks of Amiga International, Inc. Aminet is a registered trademark of Stefan Ossowskis Schatztruhe GmbH SAS/C is a registered trademark of SAS Institute Inc. All other trademarked names used herein are used for the purposes of identification and for the benefit of the trademark holder. No infringement of trademarks is intended. Trademarks remain the property of the trademark holder. Support/Updates --------------- - Updates will be available via Aminet® - Support will be available via the authors email address and via http://www.hofmann-int.de/products/MonthNavigator/ Author ------ Dipl.-Inform. Kai Hofmann Arberger Heerstraße 92 28307 Bremen Germany Phone: (+49)-(0)421/480780 EMail: hofmann@hofmann-int.de IRC : PowerStat@#AmigaGer WWW : http://www.hofmann-int.de/ Description ----------- MonthNavigator is a Custom Class of the Magic User Interface © by Stefan Stuntz. It is a subclass of group-class and Date.mcc. 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 weeknumbers 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 28) - Show/Hide weeknumbers - Select the country for the Gregorian calendar reform (not to be used as long as the date.library has not fully implemented this feature) - Set the distance between the day-field and the names of weekdays/weeknumbers - 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. - Choose between american or european layout MonthNavigator supports also the following features which might be of interest for developers: - Based on Date.mcc - 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 * MUI_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) The MonthNavigator also supports three input modes: read-only, relverify and the immediate mode. Requirements ------------ - MUI 3.5 (Version 16) - date.library - Date.mcc (developers only) - To use the Greek catalog/MCC-Install script you need the "Greek Workbench" © AC Software - To use the Russian MCC-Install script you need "Rusifier" © Dmitry Mikhilov Installation ------------ Only use the installer script! (The Installer must be in your system-path!) If you use an Installer prior to V42 you should set the LANGUAGE Tooltype to your language. Installer V42 and better automatically use your current locale. Please note that the installer-script is very special, because: - It features uninstallation - It is automated - It is very flexible - It is very intelligent (for an installer-script ;-) - It uses WrapGuide (if present) for the AmigaGuide® documentation if running under a pre V39 system. - It can be reused by (hopefully) all other MUI custom classes, because the authors of custom classes need to only change a few things: * The #copyright variable * Die #min_os_version and #min_os_revision variables * The #min_mui_version and #min_mui_revision variables * The #language_mcc and #language_mcp variables * The P_CustomExists, P_CustomInstall and P_CustomUninstall procedures * The 'APPNAME' tooltype within the MCC-Install icon. Beta testers ------------ Version numbers of beta release will not change, so you must uninstall an earlier installed beta version before you can install a newer one! Preferences ----------- With the preferences you can customize the MonthNavigator as follows: - Weekdays * Show names of weekdays With this option you can show or hide the names of weekdays that will be displayed above the day-field. * First weekday This option defines which weekday is the first of a week. Normally this will be Monday or Sunday, but you can choose any weekday! Setting 'locale' means to use the preference from the locale.library. * Language Here you can define the language that should be used for the names of the weekdays. Using the locale.library settings here would be enough. - Weeknumbers * Show weeknumbers With this option you can show or hide the number of weeks that will be displayed on the left side of the day-field. - Country support * Country Here you can select the country to use for the Gregorian calendar reform. This reform happens at different times within different countries! The days that were removed from the calendar will be displayed below the cycle gadget. This setting is disabled as long as the DateLib (TM) does not fully implement the country handling for the Gregorian calendar reform. - Spacing * Names of weekdays Here you can change the space (1-18 pixel) that will be displayed between the names of weekdays and the day-field. Enabling the checkmark beside the slider means that a line should be drawn between the names of weekdays and the day-field. 'Show names of weekdays' must be enabled to change these options. * Weeknumbers Here you can change the space (1-18 pixel) that will be displayed between the number of weeks and the day-field. Enabling the checkmark beside the slider means that a line should be drawn between the number of weeks and the day-field. 'Show number of weeks' must be enabled to change these options. - Frames & fields * Layout You can choose between the american (default) layout and the by 90 degrees turned european one. * Fixed to 6 rows The day-field is by default of dynamic high - with this option it will be fixed to a high of 6 rows. * Use frames This options tells MonthNavigator not to use frames around the day-field, the names of weekdays and the number of weeks. Works only for read-only displays! * Show invisible fields The day-fields before the first day in a month and after the last day of a month are mostly empty. This option now displays these empty fields in a button alike style. * Use last/next days When you enable the 'show invisible fields' option you can define if the normally unused day-fields should only look like buttons or if they should be real buttons with the days of the previous/next month. Using 'fillup-only' here means that only empty fields will be used for the days of the previous/next month. Using 'yes' will display an extra day-field line when the first/last line of the month is completely filled. - Highlight prev/next month days 'Show invisible fields' must be enabled if you want to change something on this page. * Underline Underline the days of the previous/next month. * Bold Set the days of the previous/next month in bold style. * Italic Set the days of the previous/next month in italic style. Please have a look at the "Known problems" section before using this option! * Alignment Defines the alignment for the days of the previous/next month. - Highlight today * Underline Underline 'today'. * Bold Set 'today' in bold style. * Italic Set 'today' in italic style. Please have a look at the "Known problems" section before using this option! * Alignment Defines the alignment for 'today'. * ShortHelp Text that should be used on 'today' within MUIs bubble help feature. Localization ------------ The MonthNavigator.mcc custom class uses the date.library, which supports 28 languages for the moment. The date.library also supports the following countries for the moment: Italy, Germany, Switzerland, Denmark, Netherlands, Great Britain If you want your country to be supported, I need the exact days that where removed from the calendar by the Gregorian calendar reform. Pope Gregor XVIII removed the days 5.10.1582-14.10.1582 from the calendar, but this reform happened at different times in different countries. Btw. you will find the catalog to translate in the archiv under Locale/catalogs/MonthNavigator_mcp.ct and if possible please also translate the installer script strings. PLEASE DON'T UPLOAD TRANSLATIONS TO AMINET, SEND THEM DIRECTLY TO ME SO THAT I CAN INCLUDE THEM INTO THE NEXT RELEASE! Information for Developers -------------------------- There is no multiple inheritance for Boopsi/MUI for the moment, so we haven't any chance to create a real Date basis-class. But there is another way to have the same result (compatibility for all classes that are dealing with dates). The solution is called interface inheritance like it was done with IDL for CORBA. MonthNavigator.mcc inherits the interface from Date.mcc! Btw. it would be wise to use a SetAttrs(obj, MUIA_Date_Year, year, MUIA_Date_Month, month, MUIA_Date_Day, day, TAG_DONE ); instead of single set()'s. - The following attributes are filtered out, so that they can't bring a MonthNavigator object into trouble: MUIA_Group_ActivePage, MUIA_Group_Child, MUIA_Group_ChildList, MUIA_Group_Horiz, MUIA_Group_HorizSpacing, MUIA_Group_LayoutHook, MUIA_Group_PageMode, MUIA_Group_Rows, MUIA_Group_SameHeight, MUIA_Group_SameSize, MUIA_Group_SameWidth, MUIA_Group_Spacing, MUIA_Group_VertSpacing, MUIA_ControlChar, MUIA_CycleChain, MUIA_FillArea, MUIA_FixHeight, MUIA_FixHeightTxt, MUIA_FixWidth, MUIA_FixWidthTxt, MUIA_FramePhantomHoriz, MUIA_InputMode, MUIA_MaxHeight, MUIA_MaxWidth, MUIA_Selected, MUIA_ShowSelState - MUIA_CycleChain be forwared to the buttons - During a DragQuery, DragDrop etc. you can only ask the source object for the following MonthNavigator attributes: MUIA_MonthNavigator_Day, MUIA_MonthNavigator_Month, MUIA_MonthNavigator_Year - Using the automatic Drag&Drop mode, a Drag frame will appear when you are pressing a day-button. - When MUIA_ObjectID is defined a MonthNavigator object will load/save the following data during MUIM_Application_Load/MUIM_Application_Save Day, Month, Year History ------- 27.05.1996 - First release on Aminet 04.08.1996 - Second release on Aminet * Drag support * Finnish catalog * Portuguese catalog * Spanish catalog * catalogs recompiled with CatComp 40.5 * linked with amiga.lib 40.15 * Dates of days that are removed by the Gregorian calendar reform are now displayed in localized format or in ISO8601 format if the locale.library was not found. 01.09.1996 - Third release on Aminet * Polish catalog * Complete new library code * Bugfixed cleanup method * Bugfix in day display routine * Demo crash fixed * Removed some stuff from the Autodocs * Swedish translation for MCC-Install * Proofreaded Spanish catalog * Drop support * Drag&Drop support changed! * Full immediate mode support 06.09.1996 - Fourth release on Aminet * Bug fix for immediate mode support * Implementing MUIM_Import, MUIM_Export * Demo updated 21.10.1996 - Fifth release on Aminet * MUIM_Import Enforcer hit fixed * Support for marking days * Using MUIV_Font_Button for buttons * New preference icon + demo icon 27.10.1996 - Sixth release on Aminet * Attributes now overwrite the user preferences! * Support for dropping objects onto days * Fixed ImmediateMode day-selection 26.12.1996 - Seventh release on Aminet * Support last/next month days * Polish translation for MCC-Install * Improved documentation * Internal optimizations * Fixing ReadOnly no frame background bug * Bugfixed MCC-Install script * Adding 68060 support to LibInit() * Compiled with SAS/C® 6.57 * Preferences for buildin highlight-today hook * Adding support for two new languages (Czech, Catalonian) * Support for days of the previous/next month incl. preferences * Replacing all int's for more portability * Fixing memory leak that appears when it is impossible to create the preference object * Adding CycleChain to preferences and demo * Forwarding MUIA_CycleChain * Improved demo code * Weeknumbers and weekdays can now be displyed without frames * Fixed preferences handling * Adding missed Autodocs: MUIA_MonthNavigator_LineWeekdayNames, MUIA_MonthNavigator_LineWeekNumbers * Adding MUIV_MonthNavigator_Country_ defines * Adding MUIV_MonthNavigator_Weekday_ defines * Adding MUIV_MonthNavigator_Lang_ defines * Adding German documentation * Adding more great icons from Eric Gerard * Fixed Assembler interface * Fixed Modula-II interface * Fixed Amiga-E interface * Fixed Oberon interface * Now it needs date.library 33.223+ * Froozen multilanguage support! 28.02.1997 - Eigth release on Aminet * Improving German Disclaimer and MUIReadme text * Czech catalog * Updated Swedish catalog * Czech translation for MCC-Install * Finnish translation for MCC-Install * Fixed Swedish/Norsk bug in MCC-Install * Adding experimental ARexx interface * Adding experimental Cluster interface * Adding experimental Blitz Basic 2 interface * Adding experimental MUIBuilder3 description 27.11.1997 - Ninth release on Aminet * Added MagicWB readme * Added AmigaGuide® V40 features to the documentation * Added "Please rate" section to the documentation * MCC-Install 43.20 * Compiled with MCCLib 12.4 * Improved demo * Now we need date.library 33.286 * Fixed problem on OM_NEW failure in mcp * Now based on Date.mcc 12.1 * Implemented MUIM_Mccprefs_RegisterGadget * Added MUIM_MonthNavigator_Mark, MUIM_MonthNavigator_DragQuery, MUIM_MonthNavigator_DragDrop to replace hooks * Added MUIA_MonthNavigator_MonthAdjust for the new methods * Optimizations 03.01.1998 - Tenth release on Aminet * Today configs are public now * Pen handling completed in mcc and mcp * Added option to fix the day-field to 6 rows * Improved Demo * Updated interfaces * Now needs date.library 33.290 12.03.2000 - Eleventh release on Aminet * European layout * New EMail and WEB-Site * Now based on Date.mcc 12.2 * Now needs date.library 33.324 * MCCLib 12.5 * MCC-Install 43.35 * New supported languages, thanks to ATO * Bugfixes Todo ---- - Preferences for: * Highlight prev/next month days: Background * Highlight today: Background - Different font for last/next month days - Implement country support Known problems -------------- - I heard that using 'test' and then 'cancel' the test settings within the MUI preference manager will not work as expected when in using your MUI classes within Libs:MUI/ instead of MUI:Libs/MUI/ !!! - Dragging is not possible if the MonthNavigator object is in immediate mode and if you only have enabled the Automatic drag mode in the preferences! - If you set the preferences for days of previous/next month or highlight today to italic and right alignment then a digit of a day-number disapears. - Old versions of the program called 'PhoneCost' written by André Schenk installed another 'date.library' into 'Libs:'. Acknowledgments are going to the following people: Rita Reichl : for correcting my English and being my inspiration James Cooper, Steve Krueger, Doug Walker : For supporting SAS/C® after SAS suspends the support. Stefan Stuntz : for the Magic User Interface and for his support Klaus Melchior : for the MUI custom class support Martin Huttenloher : for MagicWB Udo Schuermann : for WrapGuide Stefan Kost : for ag2txt Jürgen Kohrmeyer : for the rexxtricks.library Eric Gerard : for his great icons Jean-Francois PIK : for the French catalog translation and for bug reports Vincenzo Gervasi : for the Italian catalog translation, for bug reports and for updating the MCC-Install translation Massimiliano Origgi : for the second Italian catalog translation Oskar Sundberg : for the Swedish catalog translation Eivind Olsen : for the Norwegian catalog translation Eric Krieger : for translating the Dutch catalog and the installer-script strings Sándor Pogácsás : for the Hungarian catalog translation Ole Friis : for translating the Danish catalog and the installer-script strings Francis Labrie : for improving the French catalog and translating the installer-script strings Paolo Menichetti : for translating the installer-script strings into Italiano Pantelis Kopelias : for translating the Greek catalog and the installer-script strings Marcus Alanen : for (pre-)translating the Finnish catalog Nuno Miguel Namora : for the very fast catalog translation into Portuguese Pedro Luis Mieza : for the Spanish catalog translation ? : for proofreading/revising the Spanish catalog Marcin Orîowski : for translating the Polish catalog, the installer-script strings and bug reports Jesper Jonsson : for translating the installer-script strings into Swedish and updateing the catalog Sindlar Vit : for translating the catalog and the installer-script into Czech Petteri Kallio : for translating the installer-script strings into Finnish Soenke Tesch : for improving the German Disclaimer and MUIReadme Olaf Peters : for the Modula-II interface and his thoughts Oskar Sundberg : for the Amiga-E interface Thore Boeckelmann : for the Oberon interface Henning Thielemann : for the Cluster interface Erwan Fouret : for the Blitz Basic 2 interface Russel Leighton : for his help regarding the ARexx interface Jerome Souquieres : for answering my questions about MUIBuilder3 Gottfried Janik : for beta-testing and bug reports Maik Schreiber : for bug reports Marco De Vitis : for bug reports This software was translated with the help of ATO, the Amiga Translators` Organization. ATO is a non-profit organization that translates for the Amiga community. The following members were involved: Translation and proof-reading: Czech : Vit Sindlar Russian : Oleg Sergeev Alex Plotnikov Bosnian : Alen Hadzihasanovic Estonian : Vassili Smirnov Catalonian : Llorenc Grau Swedish : Jon Åslund Erik Johansson Slovenian : Damir Arh Portuguese : Alfredo Martins Ruben Alvim French : Jean-Marc Mossu Pascal Rullier Serbian : Andrija Antonijevic Ljubomir Jankovic Italian : Marco De Vitis Francesco Mancuso Amiga Translators' Organization - http://ato.vapor.com/ato/ mail: ato-info@ato.vapor.com Please rate ----------- Please rate MonthNavigator.mcc and MCC-Install. To do so, send an email to aminet-server@wuarchive.wustl.edu with the following content: RATE dev/mui/MCC-Install.lha RATE dev/mui/MCC_MonthNavi.lha where is a mark from 0..10 with 10 being the best. You can rate several programs in one mail. Thank you! Software -------- The following software products use MonthNavigator.mcc: MUITime : Replacement for the original Time prefs By Jan Riechers Aminet:util/wb/MUITime.lha MailDemon : Mailerdaemon for ZConnect compatible systems By Maik Schreiber http://home.pages.de/~Fodder/supports/maildemon/ Aminet:comm/mail/maildemon4_11.lha This is a custom class of the MUI - MagicUserInterface Copyright © 1993-1997 by Stefan Stuntz MUI is a system to generate and maintain graphical user interfaces. With the aid of a preferences program, the user of an application has the ability to customize the outfit according to his personal taste. MUI is distributed as shareware. To obtain a complete package containing lots of examples and more information about registration please look for a file called "muiXXusr.lha" (XX means the latest version number) on your local bulletin boards or on public domain disks. If you want to register directly, feel free to send DM 30.- or US$ 20.- to Stefan Stuntz Eduard-Spranger-Straße 7 80935 München GERMANY Support and online registration are available at http://www.sasg.com/ This product is based on or uses parts of MagicWB - The Workbench Enhancer -------------------------------- Copyright © 1992-1997, Martin Huttenloher If you use and like this product you should very much consider to take a look at MagicWB, which is the authentic source of the style, colors and design elements contained in this package. It features hundreds of original icons, patterns, image-drawers, dock-brushes and some specially designed high-quality fonts to improve the comfort & legibility of your daily Workbench session. What is MagicWB? MagicWB is a full replacement for the Graphical User Interface of the Workbench and has become the standard visual interface on the Amiga. Over the last years MagicWB has received various merits and an overwhelming response from Amiga magazines and users worldwide proclaiming it "a must for all Amiga users". Even commercial applications are supporting the multi-colored look & style of MagicWB. Get yourself the latest version of MagicWB and see for yourself the wonders it can do by automatically transforming your old and dull Amiga Workbench into an impressive workstation environment that will be the envy of all PC Windows and Mac users. Update yourself to the state-of-the-art workbench standard everyone uses on the Amiga! It is also your key to enjoy the new look & feel of many applications and other MWB add-ons and extensions. MagicWB is distributed as shareware. Get yourself the latest FREE PUBLIC RELEASE of MagicWB now: It is called ---------------- MagicWB21p.lha ---------------- and can be found everywhere on Aminet (or your local BBS or public domain series). Install it and witness the instant magic it performs on your old Amiga Workbench. Also included is the latest SASG registration program with which you can order and get the full registered version of MagicWB. If you want to order directly, feel free to send DM 30.- or US$ 20.- (cash, no checks!) to Martin Huttenloher Am Hochstraess 4 D-89081 Ulm Germany You may also choose to visit the official MagicWB homepage on the world wide web. There you can find the latest news & support and even register your MagicWB online (which is much more comfortable and faster). You can even benefit from various special offers & discounts for MagicWB if you order through our website! Come and visit MagicWB at: ---------------------- http://www.sasg.com/ ---------------------- Save 20% by using the discounts on our website! Ordering online also saves you a lot of time and work! WrapGuide is Copyright 1994-1995 Udo Schuermann All rights reserved