BITMAP

Syntax

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

Description

The class BITMAP allows the filter developer to place a bitmap in the dialog window. By default, this user control is not actionable.

Class Specific Properties

CENTERIMAGE

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

NOTIFY

Makes the user control actionable and activates tooltip.

Other Properties

Action

The action that the plug-in should take when the bitmap is clicked on.

Image

The path to the image that should be used for the bitmap

Val

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

Example

ctl[0]: BITMAP, Image="Logo.bmp"
ctl[1]: BITMAP(CENTERIMAGE, NOTIFY), Image = "C:\\Programs\\Images\\OK_Button.bmp", Action=APPLY

Notes

Once the bitmap 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 user control) the user control's value.

Currently, only BMP files are supported. Transparency is supported by using the class IMAGE.

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

The image 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

ICON, IMAGE, METAFILE