 |
AddGadgetMessageHandlerCore |
AddGadgetMessageHandler adds a given Gadget to the list of message handlers for another Gadget. Messages that are sent directly to hgadMsg will also be sent to hgadHandler as an GMF_EVENT.
MSGID AddGadgetMessageHandler(
HGADGET hgadMsg, // Gadget to attach to
MSGID nMsg, // Message to watch for
HGADGET hgadHandler) // Gadget to notify
);
Parameters
- hgadMsg
- [in] Gadget to attach to
- nMsg
- [in] Message to watch for
- hgadHandler
- [in] Gadget to notify
Return Values
Handler was successfully added.
Remarks
A message handler can be any Gadget. Once registered, hgadHandler will receive all messages sent to hgadMsg with a corresponding MSGID. Any valid public or private message can be listened it. If nMsg==0, all messages will be sent to hgadHandler.
A single hgadHandler may be registered multiple times to handle different messages from hgadMsg.