APPLICATION DESIGN


Displaying an icon in a column
To make certain types of documents stand out in the view, display icons instead of text in a column. The Combined Mail template uses icon columns in the All Documents view to flag different types of documents:

Column icons in the mail template

An icon column has two requirements:


Displaying a predefined column icon

The following formula determines whether a document has an attachment and, if so, displays the attachment icon (number 5):

@If(@Attachments;5;0)

Use 0 as the "false" case when you want to leave the column blank. The formula above returns 0 when the document has no attachments, so nothing is displayed. A column can display multiple icons, so in this example you might replace the 0 with a different icon value, or use nested If statements to establish conditions for displaying various icons. A column can display up to 10 different icons. All of the icons must be predefined icons. IBM® Lotus® Domino(TM) cannot display predefined icons and custom icons in the same column.

Displaying a custom icon

To display a custom icon, create the icon as an image resource, then enter the name of the image resource as the default value for the column. For example:

"logo.bmp"

An image resource can be a GIF, BMP, or JPEG graphic. The recommended size for a column icon is .2 inches wide and .18 inches high. For information on creating an image resource, see "Creating an Image Resource."

Note Icons are accessible to vision-impaired users who use screen reader software. The software "reads" the string names of the icons. Custom icons display on both the IBM® Lotus® Notes® client and Web client.

Table of column icons

The figure below shows the available column icons and their values. The values for the icons in the first column are numbers from 1 to 10. The value for any icon in the rest of the columns starts with the number shown in the column heading, for example 40, and increments by 1 for each row in that column.

Table of column icons

Accessibility tips for view icons

For enhanced accessibility and usability of applications, when a user hovers the mouse pointer over a view icon, the icon image name displays. This feature is enabled as a user preference on the Notes client.

The following are some guidelines to consider when using view icons in an application:


See Also