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 displaying an image on the left of the value of this column value. The image can be different for each row.

A typical usage is the TREE container: IMAGECOLUMN will allow to display a row-specific image 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, ...);
...