IMAGECOLUMN attribute

The IMAGECOLUMN attribute defines the form field containing the image for the current field.

Syntax

IMAGECOLUMN = column-name
  1. column-name is a form field name.

Usage

The IMAGECOLUMN attribute allows an image to be displayed on the left of the value of the column value. The image can be different for each row.

A typical usage is the TREE container: IMAGECOLUMN will allow a row-specific image to be displayed left of the tree node text. You defined only one image column for a tree node decoration.

When used in the definition of a TABLE column, the image and the column will be displayed in the same table cell. There can be several TABLE columns using an IMAGECOLUMN.

For TREE containers, the images defined by the IMAGECOLLAPSED, IMAGEEXPANDED and IMAGELEAF attributes take precedence over the images defined by the IMAGECOLUMN cell.

This attribute references form field that contains the name of an image. This form field must be defined as a PHANTOM form field, that will be part of the screen record definition in the INSTRUCTIONS section.

For more details about image resource specification in the PHANTOM column, see Providing the image resource.

Example

...
ATTRIBUTES
PHANTOM FORMONLY.icon;
EDIT FORMONLY.file_name, IMAGECOLUMN=icon;
...
END
INSTRUCTIONS
SCREEN RECORD sr(FORMONLY.icon, FORMONLY.file_name, ...);
...