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

Developer

API Reference

IAPPLET_HANDLEEVENT()

Brew Release
Brew MP 1.0.2
See Also
ISHELL_SendEvent() AEEEvent
Description
This function provides the main event processing for a BREW applet. It is called when any event is passed to the applet. Events can include system-level notifications, keypress events, and so on. System alarms or system notifications call this function to respond. If the applet is not currently running, the applet is loaded and the event is sent to the applet. In such cases, EVT_APP_STOP event is not sent to the applet, and unless the applet starts itself, the applet terminates after the completion of the event. The IApplet_HandleEvent() function must be implemented by all applets. The IApplet_HandleEvent() function is also used to support applet startup, shutdown, suspend, and resume.
Params
pIApplet
[]:
Pointer to the IApplet Interface object.
evt
[]:
Event code.
wp
[]:
16-bit event-specific parameter.
dwp
[]:
32-bit event-specific parameter.
Interface
Prototype
  •     boolean IApplet_HandleEvent
        (
        IApplet * pIApplet,
        AEEEvent evt,
        uint16 wp,
        uint32 dwp
        )
    
Return
  • TRUE, If the event was handled by the applet.
    FALSE, if otherwise.
    It is very important to return FALSE if the operation did not process the event. This allows the AEE to do further processing of the event. A typical example occurs when the AVK_CLR key is received. If the application did not handle the event, the return of FALSE helps the AEE close the application.
Side Effect
  • None.
Comments
This function can be called only by the AEE Shell.