Developer

API Reference

ITRIGMLELEMENT_AttachedObjectHandleEvent()

deprecated
Items marked as deprecated have been replaced by a more powerful, alternative feature. Deprecated interfaces include a reference to the replacement interface, which should be used for all new application development. Deprecated features are still supported for backward compatibility, but should be avoided when developing new applications.
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.
Parameters
  • 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

Comment
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.
  • Follow