ApproveMenuAction

All Editions image\bltlrgss.gif Related Transactions  image\bltlrgss.gif Example

The ApproveMenuAction transaction approves the specified command after it has been intercepted, and performs the associated action.

Type XTYP_EXECUTE

Syntax [ApproveMenuAction(docwinID, commandID)]

Parameter

Data type

Values

Meaning

docwinID

DWORD

0 | docwinID

active | specific (ignored)

commandID

WORD

Command IDs

identifier of the command to approve

Remarks

This transaction should only be used in response to a NotifyIM -- MenuIntercept. This notification must be registered, and it must be attached to the command to be intercepted. Using this transaction at any other time will produce no action.

The docwinID should match the docwinID given in the notify message.

If this transaction is not called, then it is up to the integration to take the appropriate action to complete the command. (No action may be required.) If this transaction is called, Imagenation proceeds as though the command was never intercepted.

Release information

Added in Release 3.80.

See also

Customizing menu bars

Intercepting commands