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:

  • 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 column icons, or you must enter the name of an image resource as the value for the column.

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 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. Domino® 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 Notes® client and Web client.

Table of column icons

The figure that follows 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:

  • 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.