DemoGL::Reference::Functions::DEMOGL_MessageHandlerEnable

DEMOGL_MessageHandlerEnable

DEMOGL_MessageHandlerEnable enables message handling for the given registered effect object. All received messages by DemoGL and messages generated by music syncs are delivered to the effect object by calling it's method MessageHandler().

void
DEMOGL_MessageHandlerEnable(
	const char *pszEffectName
);
	
Parameters.
pszEffectName
Pointer to a zero-terminated string which contains the name of the registered effect which message handler should be enabled.

Return values.

Remarks.
When you want to process the windows messages received by the main window, and thus by DemoGL, inside an effect object, enable that effects message handler, by calling DEMOGL_MessageHandlerEnable(). DemoGL will then pass on every message received by its message handler to the effect object, by calling the effect objects method MessageHandler and passing all the data related to the message to the method. You can disable the message handler of an effect object by calling DEMOGL_MessageHandlerDisable. Message handlers for all registered effect objects are disabled by default. Effect objects who are not on a visible layer will not receive any messages. When an effect is running on more than 1 layer, it will receive the messages as much times as it runs on different layers, starting from the layer with the lowest number.

Example.

Requirements.
DemoGL v1.3 (build 0112 or higher)

See also.
DEMOGL_MessageHandlerDisable, CEffect

Last changed on 20-jan-2001

©1999-2001 Solutions Design