Icons for Category and Keywords

Outline Fundamentals > Outline Attributes > Icons for Category and Keywords

Bonsai has support for displaying icons for categories and keywords.  The category and keyword icons can be shown in outline view columns.  Category icons are configured on the Category tab of the Preferences dialog on the desktop and the Icon tab of the Preferences dialog of the handheld. Keyword icons are configured from the keywords dialog.

Bonsai supports the defacto icon standard established by Agendus (formerly Action Names) and now supported by several other Palm OS applications, such as DateBk 5. Free and commercial icon sets are available online from many download sites. Here is an example of the Bonsai dialog used to select an icon from the icon set.

The Palm OS application Icon Manager (authored by Christopher Antos) can be used to create a private set of icons. At the time of this Bonsai release, Icon Manager version 1.6 is a free application available from most download sites. Bonsai can either share the icon set used by other applications or use a private set of icons. Create an icon database named "BonsaiIcons" if you want a private set of icons. If this private icon database does not exist, Bonsai will use the default set of icons.

During synchronization the Bonsai conduit determines what icon set is being used by Bonsai on the handheld. The name of the icon set is saved by the conduit for use by the Bonsai desktop application. When the Bonsai desktop application is run, it will load the icon set from the HotSync Manager backup directory. Your icons must be backed up to the desktop in order to be used by the Bonsai desktop application.

Note:

Bonsai references icons by their resource id.  This allows icons to be moved within icon sets without affecting existing outlines.

Note:

By convention, icons should be given resource id's in the range from 0 to 8999.