History of METAFILE

== Syntax ==

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

== Description ==

:The class METAFILE allows one to place a metafile in the dialog window. By default, this user control is not actionable.

== Class Specific Properties ==

:CENTERIMAGE

::Scales the image to original size and centers it 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. Possible values include APPLY and CANCEL.

:Image

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

:Val

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

== Example ==

<code>

ctl[0]: METAFILE, Image="Airplane.wmf"

ctl[1]: METAFILE(MODALFRAME, NOTIFY), Image="D:\\Graphics\\Button2.emf", Action=CANCEL

</code>

== Notes ==

:WARNING: METAFILE support is currently broken in 64-bit versions of FilterMeister, and will cause the compiler to hang the graphics program. METAFILE still works in 32-bit versions of FM.

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

:Currently the windows metafile (.WMF) and enhanced metafile (.EMF) formats are supported.

:When standalone filters are created, metafiles are not embedded by default. You can use the Embed: function to embed the icon 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 ==

:BITMAP, ICON, IMAGE