An icon column has two requirements:

• You must select the column property "Display values as icons."
• You must use a column formula that results in a number that corresponds to the icon you want to display from the table of predefined icons, or you must enter the name of an image resource as the value for the column.

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 41, and increments by 1 for each row in that column.

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:

• If you designate an existing view icon by number, the default icon description displays.
• When creating custom icons for use in view columns, assign meaningful image names because the names will be used as the hover text.
• If there are multiple icons in a column, hovering the mouse pointer over the icons displays as many icon descriptions as will fit across the user's screen.

Adding programming to columns
Designing views
Creating columns in a view

Glossary