Navigation     Documentation - Projects for Palm OS
   (sf) Project
   (sf) CVS Tree
   (sf) All Files
   (sf) News-List
   (sf) General-List
   (sf) Bugs
   (sf) Features
   (sf) Support
Convert Logo
Projects for Palm OS
<<< PreviousNext >>>

MainForm (Project List)


The top level view in Projects is called MainForm or Project List. It shows you the available projects registered by the application. The format consists of several columns, each showing different information about the projects. On colored versions, some projects may be grayed out, indicating that a project is not "active". This will be described more fully later.

Priority column

The first column indicates the priority of a project. Projects' priorities range from 1 to 5, with 1 being the highest and 5 being the lowest priority. You can set the priority of a project directly by tapping on the number and choosing one of the values from the pop-up list. By default, projects are sorted by their priority. If you change the priority of a project, the item will be reordered into its proper position in the list. If you feel you don't need this column and want to have more space for other columns, you can turn it off. (See Preferences).

Begin date column

The next available column shows you the begin date of each project. Every project must have this value set to a valid date; it cannot be set to "no date". The column displays only the day and month of the date. Because of the small screen on PDAs, I've decided not to show the year portion of the date. Tapping in a cell of this column will open up the appropriate project and bring you directly to the GeneralPage. This column is turned off (hidden) by default so you need to check the Preferences to make it appear.

Project name

The most important column displays the Project name. Tapping on it will open up the project to the ToDoPage. This column cannot be turned off; it is always visible.

ToDo information

In the same column (at the end of the Project name column) you will find something like "2/16" or "7/26". This is referred to as the To-Do information and displays the number of to-dos for the appropriate project. While the first number counts the completed items, the second number shows the total amount of (all) to-dos for a project. These "To-Do Numbers" can be used as a kind of status, telling you how far a project has progressed. You may be wondering why this information is not shown as a graphical progress bar, or something similar. Well, remember that PDAs have a very limited screen size and resolution where small graphics are sometimes hard to read. You may then wonder why it it is not displyed as something like "84\%" to show that a project is 84 percent complete. This would be a possible solution, but it is not very practical since it is not accurate enough. Reading that 8 tasks out of 28 are completed is more helpful information, in my view. Once again, if you do not need this information you can turn it off. (See Preferences).

State column

As of version v1.8.2a you are able to define your own project states. The column next to the project name (or ToDo Information) shows the first letter of the current state of a project. You can also turn this column off. By tapping the column, a list with already defined states will appear. If you choose the last entry in the list you can edit the states, in the same way that you edit categories. Note that there can be only 16 states. On colored devices you can also define a color for each state. The same color will be used to draw the projects' information on the MainForm.

In previous version (v1.8.1 and below) you could choose to hide all projects that were not active. This option has been changed. Now you can filter projects by their states. Just check the Preferences.

Note icon column

There may be a note icon in the last column. If there is such an icon it indicates that a text memo is associated with the project. Tapping in that column opens the project directly to the MemoPage. This column is always visible; it cannot be hidden.

Category column

As of version v1.8.1 of Projects, you can display an additional column which will show the category of each item in the project list. Tapping on a category cell, you can select and assign a new category to the appropriate project on the fly, just like you can set the state or the priority of an item. This column can also be hidden from view by using the Preferences dialog. If this column should be shown, it will be displayed only if your are viewing "All" items.


Tapping on the Show... button will pop up the Preferences dialog. Here you may set the sort order of the project list. Beside choosing to have Projects sort the list automatically, you can also do it by hand (manually). If you choose to sort manually, new projects will be created at the top of the list. To reposition a project in the list, tap on its name, then hold down the pen and drag it to the desired position. This works much like in the built-in Memo application. Note that you need to tap into the project name column to make it work. The abbreviation "asce." stands for ascending while "desc." means descending. Further, you can turn off some of the previously mentioned columns by unhooking the appropriate check boxes. One special check box is ...Only. If you check this box, only projects in the defined state will be listed. If this checkbox is unhooked all projects will be shown.

Create a new projects

Finally, to create a project all you need to do is to tap on the New... button. A small dialog will appear where you need to enter a name for the new project. Project names must be unique whithin the Projects application, they may be up to 27 characters long, and may contain any characters available on the Palm OS.

QuickView - Viewing to-dos of listed projects

As of version 1.8.0 there is a small ToDos button beside the New... button. Tapping this will open up the QuickView, which lists all the currently shown projects along with their to-dos. This enables the viewing of items across project boundaries. This view has no caption associated with it. To show the menu you need to tap on the "Menu" soft button in the left bottom corner beside the Graffiti area. The two horizontal arrows allow you to quickly jump to the next or previous project in the list. Tapping the check boxes of to-do items allows you to mark an item as "complete". Tapping on the item itself will open up the ProjectForm to the ToDoPage with the cursor on that item, if it was a to-do item. If you tap on the project name it simply opens the ToDoPage but does not select an item. As of version v1.8.1, if you choose a paritcular to-do category for a project while in QuickView, you will see listed only the corresponding to-do items for each project. With the v1.8.2 version you can also filter to-do items by their priority.

Switching current category

To switch the category currently displayed on the MainForm you can use the popup trigger in the upper right corner of the form. If you have set a hardware button on your PDA to launch Projects, then pressing the button repeatedly will cause the MainForm to cycle through all available cateories, while skipping those which are empty. Just have a try.

Menu items on MainForm


This will open up the dialog where you define categories, just as in the standard Palm applications. The main difference here is that these categories will be used for new projects. Maybe this seems a little bit useless, but it was implemented for the following reason: Since I use Projects mainly for keeping track of my programming projects, I used the default categories "Basic, Optional, Planned". This means that any new project I create receives those categories for its to-do list. But there are people who would like to have other default categories ... once you have configured those default categories all your new projects' to-do lists will have these categories. There is only one thing to out for: each time you (re)install Projects these default categories are lost! This means that you have to review this menu item again to make sure that next time you create a new project it gets the default categories you want.

Scan for DBs

This is a special menu item that you will probably rarely use. It can be very useful when you have installed or beamed a projects database and the project does not appear in the projects list. If you perform this action Projects will look for all project databases in RAM of your PDA (not on extension cards), and insert these databases into the application's projects list if they aren't already there.


Here you can select a font that will be used to draw the items on the MainForm.


This item displays a form that allows you to determine whether to show, hide or mask projects marked as "private". You will see this menu item only on devices running the Palm OS version 3.5 or greater. On devices with an earlier OS version you will need to go to the Security application to define the state of private records.


... displays the About dialog.

Updated Sun Mar 9 11:03:46 CET 2003
"Peter Novotnik "peternov1 (at)"