CapeSoft Accessories Logo

ProDomus One-Touch
Date, Time and Scheduling Tools

This page was archived from the original ProDomus web page and is provided "as was".



One Touch Date Handling

Goal: Create a “One Step” global template solution to date handling.


Date and Time Handling

Goal: Create a tool that handles all types of date and time calculations and provides the basis for applications requiring scheduling procedures.



Goal: Create a base integrated set of calendaring classes that can be used as the basis for any type of calendar.



Goals: Results:


Templates. The PD “One Step” templates handle all date entries by simply populating one global extension template. Calendar Classes. Calendar Classes support a file drop calendar, a window calendar, and a popup calendar. Drop Calendars. The drop calendar and its associated button are created at run-time. Scrolling Class. The Scrolling Class uses an array of alerted keys to scroll change the current day by specified amounts. The Scrolling Class is used for date entries and all of the calendar List controls. Schedule Class. Provides date, time, and scheduling methods for both DATE and TIME and LONG data types. The class includes methods for handling holidays, scheduled items, business days, day and time duration recurring dates without the creation of duplicate records. It optionally checks whether new scheduled items conflict with existing scheduled items.

Date Class Date Rules. Rules for date calculations vary from country to country -- the US standard of Sunday being the first day of the week and the first week of the year being the one in which January 1 appears does not apply in most other countries. The Date Class functions for calculating the Week Of The Year or the Day Of The Week recognize these rules.

True or False Date Functions. Is it a holiday? The Date Class will calculate US holidays and any other holidays added at run time. Holidays affect the calculation of business days: whether a date is a business day and the number of elapsed business days between dates. The Date Class also provide functions for determining whether it is a leap year, valid date, or week day.

Recurring Date. A special True or False function determines whether a date B is a recurring instance of date A Time Zone Information. 32-bit applications may retrieve local names for Standard and Daylight Savings time, the UTC (Universal Time) bias, the date and time of transitions, and the user's current set up. The Time Zone Code Template retrieves the user's time zone information. The template allows you to perform different actions depending on function call results: unknown time zone, standard time, daylight time, and function failure.

Source Code. ProDomus Date Tools include source code for all classes except the Date Class.

Appointment Class Add On. An Appointment Class, derived from the Schedule Class, provides a file handling interface that makes creation of an appointment list virtually the same as creating any other browse list.

Popup Button and Calendar

Popup calendar buttons are automatically created at run time buy simply adding the global extension (population may be overridden) - a great time saver. The popup calendar itself displays immediately below or above the entry depending on available space making it clear to the user what date is being entered. All calendars, whether popup or calendar controls populated on a window share common features: A Threaded popup may also be populated as a control template or a drop calendar populated instead of the popup calendar.

Calendar Context Popup Menu

All list based calendars have a context sensitive popup menu making basic functions available to end users. Some of these duplicate the over 30 built-in alert keys such as the Quicken keys for going to today's date, scrolling to the end of the week, or changing to the beginning or end of the year, and more.

Go To Jump Window

The "Go To" or "Jump To:" window associated with each calendar allows user to jump forward or back an number of specified periods whether its 10 business days or 30 weeks, months, or years.

List Calendar Control Template

Use the list control template to put a calendar on any window. Give it whatever functionality you like. Let the Class library handle Scheduled Dates and Holidays. Drag and Drop dates to any date entry in the application. The list control also allows you to add other scroll buttons such as scroll by year.

You may populate more than one list control on a window and interlink their functionality. Among other things, you could design your own popup calendar if you don't like what is provided.

The List Control has the same common features found in the popup calendar.

Drop Calendar

Auto populating drop button calendars for every date entry is an alternative option at the global and procedure level. Disable the date entry and the button will be disabled at the same time. Right click the calendar and get a easily jump ahead 50 business days or back to the beginning of the year. Press HOME and get back to the original date or "T" to go to Today's date. Both the calendar and entry will have entry specific range limits.

The drop lists are created at run time as well as the calendar button.

Other Features

Month-Day-Year Class and Control Template

Appointment Class and Control Template

The appointment control template and class creates a daily appointment schedule in a browse format. Scheduled items may having starting and ending dates and times and well as recurrence built into the schedule class library. Visual indication of items durations display in the form of brackets down the left side of the browse. The browse may use range limits and filters as needed. Date entry may use control templates provided or designed by the developer. Following is al list of some of the appointment class and template features.

Recurrence Control Template

The recurrence control template adds From entries for setting the recurrence of a date.