WhatzUp (c)1999 Mark Shillingburg

e-mail: mshill@my-dejanews.com

Datebook/ToDo List Frontend Program

Version 1.01  - Optionally show current time in title instead of WhatzUp.

                Optionally have Appointment and ToDo criteria synchronized.

                Custom criteria can be set to view the next 30, 60, 90 or 
                120 Days.

                Fixed ToDo Table Disable bug when no ToDos in database.

                Fixed spelling errors in German version.
              

Version 1.00  - New pulldown controls for Hardware Buttons option view.
                
                DateBook and ToDo hardware buttons are programmable when 
                assigned to WhatzUp.  They can either launch the respective
                program or cycle through criteria or categories in the case
                of the ToDo button.

                Added 'This Month' criteria for Appointment table.  This 
                will automatically prepend the appointment date to each
                record displayed.                
                
                Added option to disable ToDo table.  If disabled the 
                ToDo Label, Controls and Table are not displayed and the 
                Appointment table becomes 11 rows deep.
                
Version 0.95c - Hardware scroll buttons will both scroll in the positive
                direction if assigned to different controls.

Version 0.95b - Fixed issue with opening Datebook database on Palm V.

Version 0.95  - Added optional auto-time scrolling for Appointment Table.
             
                If DateBook hardware button is assigned to WhatzUp repeated 
		presses will change appointment criteria.
                
                If ToDo List hardware button is assigned to WhatzUp repeated
                presses will change ToDo Category.
                
                Hardware scroll buttons can now be independently assigned to
                table scrollbars which will autowrap.
          

Version 0.94c - Fixed missing ToDo category on first entry.

Version 0.94b - Fixed disappearing date bug.

Version 0.9.4  - Seperate views for Appointment/ToDo/Scroll Button 
                 options.

                 Scroll buttons can now be assigned to different controls.

                 ToDo categories can be optionally displayed (per ToDo List)

                 Filter ToDo priority items (set a maximum priority to display)

                 ToDo and Appointment applications (those launched when item
                 or table label is tapped) are independently selectable from a
                 list of all applications loaded in Palm Pilot.  Set Appontments
                 to start Datebk3 and ToDos to start ToDo Plus.
                 
                 First day of week (Sunday/Monday) is extracted from system
                 preferences.  This only affects the 'This Week' criteria.

                 Fixed bug relating to over-locking chunk when going between 
                 preferences/options and WhatzUp main view.
                 
                 Fixed bug which dislpayed exceptions to repeating appointments.

Version 0.9.3c - Fixed scrollbar bug.
                 Fixed over-locked chunck bug due to Category List not being
                 freed when application is switched out.
                 Fixed various minor display issues.
                 Appointment and ToDo labels are now hot and start appropriate
                 applications.

Version 0.9.3b - Fixed bug relating to exceptions to repeating appointments.

Version 0.9.3 - All date/time formats come from system preferences.
                Also shows am/pm (a/p) when in 12 hour format.
                Added option for undated ToDo items to be shown.

Version 0.9.2 - Fixed minor bug in Date Criteria scrolling with 
                hardware buttons.  Optimized for speed. Now as fast 
                as built-in apps.

Version 0.9.1 - Added Datebk3 support for Appointment item selection.

Version 0.9.0 - Initial Release



Overview

WhatzUp provides a one screen view of both your Datebook and ToDo 
databases on your Palm Pilot.  The WhatzUp main view is completely 
configurable and very small, only 13K bytes.  WhatzUp gives you a 
quick view of upcoming appointments and dated ToDo items.

WhatzUp lets you view your appointments for today, tomorrow, to the
end of the current week or for the coming week (next seven days).  The
format of the displayed appointments is also configurable.  View the 
day of the week, start/end times, note, alarm and repeat indicators are
all user selectable.

WhatzUp lets you view your ToDo items for today, tomorrow, to the 
end of the week, for the upcoming week (next seven days) or through the 
end of the month.  Additionally, you may select the ToDo categories you
want to have displayed.  The ToDo items can be displayed with or without
the priority, note indicator, category, and/or due date.  Past due items 
may optionally be displayed.

WhatzUp is Lefty (c) compatible http://www.strout.net/ making it ideal 
for the lefthanded user.  Lefty permits WhatzUp to display scrollbars
on the left side of the screen.  The Lefty.prc file is included in this
zip file and can be optionally installed if needed.


Installation

Hotsync the WhatzUp.prc (20K) and the Lefty.prc (4K) if needed
to your Palm device.

For instant access to WhatzUp, assign it to either the Appointment
or ToDo List hardware buttons. 
 

WhatzUp Main View 

The WhatzUp view contains seperate tables for appointments and ToDo
items.  Each table has associated controls which provide particular 
selection criteria for the records to diplay.  

The Appointment table has a single control which permits the user 
to choose from appointments for "Today", "Tomorrow", "This Week"
(through Saturday), "Coming Week" (next seven days), "This
Month" (through the last day of the current month) or the next
30, 60, 90, or 120 days set by the custom criteria.  The pulldown
list control is on the right edge of the screen even with the 
"Appointment" label.

The ToDo table has two controls which filter the items from the 
ToDo List application.  The ToDo category select control just to the
right of the "ToDo" label.  Select the "All" to view ToDo items 
from all of the categories.  Select another category from the category
pulldown list to view only the ToDo items from a particular category.
The ToDo criteria control permits the user to view ToDo items that 
are due "Today", "Tomorrow", "This Week" (through Saturday), "Coming 
Week" (next seven days), or "This Month" (through the end of the 
current month).  ToDo items appear in the WhatzUp ToDo table in the 
same sort order as the ToDo list.  

When the selection criteria for either of the tables changes, the 
tables are automatically updated, and resized as needed.  If one 
of the tables contains less than five entries, the other is expanded
as needed to show more on the screen.  If both table have more than 
five entries (or either has more entries than can be displayed at 
once in the table) scrollbars are added.

Tapping on either the Appointment or ToDo labels at the top of each
table, will start the respective application.  Which application is 
started is programmable from the options menu for each table.

Selecting an item from either list starts the application and goes to 
the specified record.  In the case of a repeating record it will select
the first occurence after the current date (ie. a daily repeat from the 
"This Week" view may bring up the record on Tuesday when the Thursday
is selected if today is Monday).  

WARNING: Some applications other than the default DateBook and ToDo List 
may not handle launching with a record number properly.  If you are 
going to launch applications other than the default ones be certain that
they use the DateBook and ToDo built-in databases.

ISSUE: Datebk3 will not launch and go to a specified record in the 
ToDo database.  It only goes to records in the DateBook database. 
This is a shortcoming of DateBk3 and the author is aware of it.

The hardware scroll buttons can be programmed to control any one of 
the three pulldown list boxes of the WhatzUp main view or the scrollbars
associated with the tables when they are visible.  By pressing
the Scroll-Up or Scroll-Down hardware buttons, the selected control will
cycle through the selection list and update the screen.  Each button can 
be assigned to one of the three controls or two scrollbars.


Just for Lefty's...

Install the Lefty.prc program.  Run it and check the box.  The WhatzUp
scrollbars will now be on the left side of the display when they appear. 


Setting Display Preferences

To set the display options, tap the Menu silkscreen button and 
select one of the items from the "Options" menu.  This will 
bring up the corresponding options view related to either the Appointment
Table, ToDo Table or the hardware scroll buttons.


Appointment Display Options

DateBook -    This pulldown control has a list of all the programs
              on the Palm Pilot device.  Selecting one of the programs
              will cause that program to be the default application
              for the Appointment Table.  It becomes the program launched
              when the Appointment Label or an appointment item is tapped.

Day of Week - Check this box if you wish the Day of the week to be 
              displayed for each appointment.  This is automatically
              displayed if "This Week" or "Coming Week" criteria are 
              selected for the appointment table.

Stop Time   - Check this box if the stop time for the appointment is
              to be displayed along with the start time.  This has no
              affect on untimed events.

Note Indicator - Check this box if the note symbol is to be displayed 
                 for appointments that have notes attached to them.

Alarm Indicator - Check this box if the alarm symbol is to be displayed
                  for appointments that have alarms attached to them.

Repeat Indicator - Check this box if the repeat symbol is to be displayed
                   for repeating appointments. 


Auto Scroll - Check this box if you desire the Appointment table to auto-scroll
              past appointments whose end time has already passed.





ToDo Display Options:

ToDo List -  This pulldown control has a list of all the programs
             on the Palm Pilot device.  Selecting one of the programs
             will cause that program to be the default application
             for the ToDo Table.  It becomes the program launched
             when the ToDo Label or a ToDo item is tapped.

Priority - Check this box if the Priority of a ToDo item is to be  
           displayed.

Category - Check this box if the category of a ToDo item is to be displayed.

Note Indicator - Check this box if the note symbol is to be displayed 
                 for ToDo items that have notes attached to them.

Due Date - Check this box to show the due date of a ToDo item.

Past Due Items - Check this box if you wish past due items to be displayed
                 as well as the other criteria selected.  So, the "Today"
                 criteria selection will show ToDo items past due in 
                 addition to todays due items.  The same holds true of the 
                 other criteria.

Undated ToDos  - Check this box if you wish to have the ToDo items
                 without a due date appear in the Todo table.

Maximum Priority - Select the Maximum priority of the ToDo items to be
                   displayed.  A maximum of 5 will display all ToDo items
                   where a maximum priority of 3 will only show items with
                   priority of 3 or greater.

Disable ToDo Table - Check this box if you wish to completely disable 
                     the ToDo table.  This option makes the ToDo table
                     completely disappear, and allocates all the screen
                     space to the Appointment table.


Hardware Button Options:

There are four pulldown controls, one for each of the two scroll buttons,
one for the DateBook hardware botton, and one for the ToDo hardware button.

Since the scroll buttons can be programmed independently of each other,
if the scroll buttons are programmed to control different controls, they
will both scroll in the positive direction.

Scroll Up/Down Buttons

ToDo Category - Hardware scroll button control the ToDo category control.

ToDo Criteria - Hardware scroll button control the ToDo criteria control.

ToDo Scrollbar- Hardware scroll button control the ToDo Scrollbar if visible.

Date Criteria - Hardware scroll button control the Date Criteria control.

Date Scrollbar- Hardware scroll button control the Date Scrollbar if visible.


DateBook Application Button - If the DateBook hardware button is assigned to 
                              the WhatzUp program, then subsequent presses of
                              the button can be programmed to either 1) Launch
                              the DateBook program; or 2) Cycle to the next 
                              criteria for the Appointment table.

ToDo List Application Button- If the ToDo List Application button is assigned to
                              the WhatzUp program, then subsequent presses of 
                              the button can be programmed to either 1) Launch
                              the ToDo program; or 2) Cycle to the next 
                              criteria for the ToDo table; or 3) Cycle to the 
                              next Category for the ToDo table.

