History of 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 ==

<code>

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

</code>

== 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