ICON

Syntax

ctl[n]: ICON(Class Specific Properties), Other Properties

Description

The class ICON allows the filter developer to place an icon in the dialog window. By default, this user control is not actionable.

Class Specific Properties

CENTERIMAGE

Scales the icon to original size and centers the image within the control.

NOTIFY

Makes the user control actionable and activates tooltip.

Other Properties

Val

Assigns a value to the icon, but only when it is disabled. (default = 0)

Example

ctl[0]: ICON, Image="Rubberduck.ico"

Notes

Once the icon is actionable, its value definitions are lost. The reason is that an action returns a specific value and overwrites (once the mouse button is clicked over the icon) the icon's value.

When standalone filters are created, icons are not embedded by default. You can use the Embed: function to embed the icon into the standalone filter file.

The icon file should be present in the active directory or in any of the directories set in the PATH or FM_PATH variables (check your AUTOEXEC.BAT file).

Also see

BITMAP, IMAGE, METAFILE