Defining new commands with the DDE API

 

Through the DDE API, you can add external commands to the Imagenation command table. After adding external commands, you can work with them through the API.

External commands are identified with any integer greater than or equal to 4096. The following procedure describes how to add a new command, with the identifier 4097, to the Imagenation command table using the DDE API.

To create an external command using Imagenation’s DDE API:

1. Set up a notification on NotifyIM – MenuIntercept.

2. Send the transaction [SetMenuStatus(4097,1)] to Imagenation to enable the command.

3. Send the transaction [InterceptMenuAction(4097, 1)] to Imagenation. It tells Imagenation to send you menu intercepts.

In the SRC file:

4. Add the user interface text for the external command, including the name, Status Bar message, and ToolTip. For details, see Configure Commands.

5. Add the external command to an Imagenation menu. For details, see Configure Menu Bars and Menus.

A NotifyIM - MenuIntercept notification will be received whenever the user selects 4097 in a menu. If you want to enable or disable the external command, your integration must handle this functionality.

Note that all of the user interface elements that you can define in a CFG file for an external command can also be defined using DDE API transactions. For more information, refer to the Imagenation DDE API Help (ddeapi.hlp).

See also

Configuring Imagenation through the API

Defining new commands with the C API