API Reference | developer.brewmp.com API Reference | developer.brewmp.com

Developer

API Reference

ITRIGMLELEMENT_ATTACHEDOBJECTHANDLEEVENT()

Brew Release
Brew MP 1.0.2
See Also
ITRIGMLELEMENT_AttachObject() ITRIGMLELEMENT_GetAttachedObject()
Description
Passes the event directly to the ITrigmlElement's attached object via its HandleEvent function.
Params
po
[]:
The element from which the attached object will be acquired.
eventId
[]:
The BREW event ID.
wParam
[]:
16-bit BREW event parameter.
dwParam
[]:
32-bit BREW event parameter.
Interface
  • ITRIGMLELEMENT
Prototype
  •    boolean ITRIGMLELEMENT_AttachedObjectHandleEvent(ITrigmlElement* po,
                                                         AEEEvent eventId,
                                                         uint16 wParam,
                                                         uint32 dwParam);
     
Return
  •    TRUE if the event was consumed 
       FALSE if the event was not consumed
    

Comments
The purpose of the this function is to allow the passing of events directly to the attached object. This function assumes that the attached object implements the IHandler interface, if it does not this function will simply return FALSE. It is not possible to pass events directly to the attached object by calling ITRIGMLELEMENT_GetAttachedObject() and then calling HandleEvent on the object that is returned. The reason this won't work is because the ITrigmlElement has been inserted into the front of the attached object's IHandler event handling list therefore any events passed to the attached object would result in the event being first delivered to the ITrigmlElement.