EVT_FLIP: wParam = TRUE if open, FALSE if closed
This type of event is sent when a device's LCD is blocked
when a clamtype device is closed and reexposed when opened
dwParam = AEEFlipInfo (AEEDeviceNotifier.h)
EVT_LOCKED: Deprecated from BREW 3.1
EVT_KEYGUARD: wParam = TRUE if keyguard is on
This type of event is sent when a device's keypad is blocked
when a clamtype device is closed and reexposed when opened.
This event can also be used when keys are locked by software,
not by a piece of physical hardware.
dwParam = AEEFlipInfo (AEEDeviceNotifier.h)
EVT_HEADSET wParam = TRUE if headset is plugged in, FALSE if otherwise
EVT_PEN_DOWN Deprecated, see EVT_POINTER_DOWN. dwParam = position: signed x in upper 16 bits, y in lower
EVT_PEN_MOVE Deprecated, see EVT_POINTER_MOVE. dwParam = position: signed x in upper 16 bits, y in lower
EVT_PEN_UP Deprecated, see EVT_POINTER_UP. dwParam = position: signed x in upper 16 bits, y in lower
EVT_PEN_STALE_MOVE Deprecated, see EVT_POINTER_STALE_MOVE. dwParam = position: signed x in upper 16 bits, y in lower
Stale move events are reported when the event queue contains
additional unprocessed moves
For pen positions, 0,0 is the upper left corner of the active frame
AEE_GET_X() and AEE_GET_Y() macros may be used to extract
the position from dwParam
To support existing applications, BREW will still generate EVT_PEN_XXX events
for every EVT_POINTER_XXX event. EVT_PEN_XXX event will be delivered to the
BREW application before the EVT_POINTER_XXX event. EVT_PEN_XXX events are however
considered deprecated and newer applications should handle EVT_POINTER_XXX events
instead of EVT_PEN_XXX events.
EVT_JOYSTICK_POS dwParam = position: signed x in upper 16 bits, y in lower
wParam = 15 most significant bits of the wParam represent
15 least significant bits of GETUPTIMEMS() and thus can be
used to calculate the time lag between events.
The LSB in wParam is 1 if an EVT_JOYSTICK_POS event was
dropped before the current EVT_JOYSTICK_POS event. If the
previous joystick event is in the event queue, then
the LSB of wParam will be 0.
EVT_JOYSTICK_STALE_POS dwParam = position: signed x in upper 16 bits, y in lower
Stale move events are reported when the event queue contains
additional moves
AEE_GET_X() and AEE_GET_Y() macros may be used to extract
the position from dwParam
EVT_SCR_ROTATE wParam = AEEScrOrientation (Portrait or Landscape)
dwParam = screen ID
EVT_POINTER_DOWN Sent when the pointing device is put down on the
capable screen.
dwParam = NUL-terminated single-byte-character string
with delimiter-based name=hex value pair representing
information about pointing device.
e.g.:"x=00000017,y=FFFFFFFB,time=00003456,clkcnt=2,modifiers=0000000000000000,", where
the decimal equivalents being x = 23 & y = -5.
Helper functions defined in AEEPointerHelpers.h can be
used to obtain the name-value pairs. See AEE_POINTER_GET_XY()
for more details and references to other similar
helper functions.
wParam = size of dwParam string in bytes including
terminating NUL-character.
EVT_POINTER_MOVE Sent when the pointing device is moved across the capable
screen while remaining in contact with the screen. This
is equivalent to dragging the pointing device.
dwParam = NUL-terminated single-byte-character string
with delimiter-based name=hex value pair representing
information about pointing device.
e.g.:"x=00000017,y=FFFFFFFB,time=00003456,clkcnt=2,modifiers=0000000000000000,", where
the decimal equivalents being x = 23 & y = -5.
Helper functions defined in AEEPointerHelpers.h can be
used to obtain the name-value pairs. See AEE_POINTER_GET_XY()
for more details and references to other similar
helper functions.
wParam = size of dwParam string in bytes including
terminating NUL-character.
EVT_POINTER_UP Sent when the pointing device is lifted up from the
capable screen.
dwParam = NUL-terminated single-byte-character string
with delimiter-based name=hex value pair representing
information about pointing device.
e.g.:"x=00000017,y=FFFFFFFB,time=000003456,clkcnt=2,modifiers=0000000000000000,", where
the decimal equivalents being x = 23 & y = -5.
Helper functions defined in AEEPointerHelpers.h can be
used to obtain the name-value pairs. See AEE_POINTER_GET_XY()
for more details and references to other similar
helper functions.
wParam = size of dwParam string in bytes including
terminating NUL-character.
EVT_POINTER_STALE_MOVE Stale move events are reported when the event queue
contains additional unprocessed moves.
dwParam = NUL-terminated single-byte-character string
with delimiter-based name=hex value pair representing
information about pointing device.
e.g.:"x=00000017,y=FFFFFFFB,time=00003456,clkcnt=2,modifiers=0000000000000000,".
Helper functions defined in AEEPointerHelpers.h can be
used to obtain the name-value pairs. See AEE_POINTER_GET_XY()
for more details and references to other similar
helper functions.
wParam = size of dwParam string in bytes including
terminating NUL-character.
EVT_COMMAND: App custom control
EVT_CTL_TAB: App TAB event sent by controls: dwParam = control, wParam = 0-left,
1-right
EVT_CTL_SET_TITLE: Message interface to set title: wParam = ID, dwParam = res file
(if ID != 0) or text
EVT_CTL_SET_TEXT: Message interface to set text: wParam = ID, dwParam = res file (if ID
!= 0) or text
EVT_CTL_ADD_ITEM: Message interface to add item: dwParam = CtlAddItem
EVT_CTL_CHANGING: App dwParam = CtlValChange
EVT_CTL_CHANGING: App dwParam = CtlValChange
EVT_CTL_MENU_OPEN: Sent by text controls before their associated softkey menus are activated
EVT_CTL_SKMENU_PAGE_FULL: Sent by IMenuCtl when SK menu page is full
EVT_CTL_SEL_CHANGED: Sent by IMenuCtl when selection has changed
EVT_CTL_TEXT_MODECHANGED: Sent by ITextCtl when input mode was changed
EVT_ALARM: App wParam = uCode
EVT_NOTIFY: dwParam = AEENotify *
EVT_NOTIFY_FAILURE Notification registration failed - dwParam = AEENotifyFailure *
EVT_BUSY: Sent to app to determine if app can be suspended or stopped
EVT_APP_START: Main App started
EVT_APP_STOP: App stopped : dwParam = (boolean *). On return, app must set *dwParam to FALSE if it does not want to close and desires to become a background app
EVT_APP_SUSPEND: App suspended: wParam == AEESuspendReason, dwParam = AEESuspendInfo *
EVT_APP_RESUME: App resumed: dwParam = ( AEEAppStart * )
EVT_APP_CONFIG: Alternate App Start: configuration screen should be shown
EVT_APP_HIDDEN_CONFIG: Alternate App Start: hidden configuration screen
EVT_APP_BROWSE_URL: Called after EVT_APP_START: dwParam = (const char * pURL)
EVT_APP_BROWSE_FILE: Called after EVT_APP_START
EVT_APP_MESSAGE: Text message: wParam = AEESMSEncoding, dwParam = String format dependant on wParam value
EVT_ASYNC_ERROR: Async error notification - dwParam = AEEAsyncError *
EVT_APP_TERMINATE: Forced version of EVT_APP_STOP. App will be released.
EVT_EXIT: Sent to any loaded apps when BREW terminates
EVT_APP_RESTART: Sent to background apps after upgrades
EVT_EXT_STOP: Sent to all open apps - dwParam == zero terminated list of AEECLSIDs of extension
This event is sent when BREW is about to upgrade extensions from the ADS catalog. A zero
terminated list of extension classid is supplied in dwParam. If app is using any of
these extentions, it must release it in order for upgrade to finish successfully.
EVT_EXT_CREATE: Extension class created
EVT_EXT_RELEASE : Extension class released
EVT_APP_NO_CLOSE : This event is sent to the top visible app, if the screen saver app is attempting
to become top visible. By returning TRUE, the application is prevented from being closed.
EVT_APP_NO_SLEEP : This event notifies the running application to determine if the device may be put in sleep mode or not.
By returning TRUE, the application prevents the device from being be put in sleep mode.
EVT_APP_START_BACKGROUND: App started in background
EVT_APP_WOULD_START: Sent when ISHELL_StartApplet() is called on currently top-visible application
EVT_APP_POST_URL: Event which copies URL, located inside dwParam, before sending it to the handler app
Key Events
EVT_KEY: App keyup: wParam = KEYCODE, dwParam = Bitflags for modifier keys
EVT_KEY_PRESS: App keydown: wParam = KEYCODE, dwParam = Bitflags for modifier keys
EVT_KEY_RELEASE: App keyrelease: wParam = KEYCODE, dwParam = Bitflags for modifier keys
EVT_CHAR: Character Event: wParam = AECHAR, dwParam = Bitflags for modifier keys
EVT_UPDATECHAR: Character update Event: wParam = AECHAR, dwParam = Bitflags for modifier keys
Key filtering/hook events.
These events are sent to running applications with AFLAG_PHONE set.
If an AFLAG_PHONE application handles the key hook event, the key event is not passed
to the current top visible app. This provides a way for privileged apps to provide custom
handling for specific key events such as AVK_END. There should be a very small number
(preferably just one) application(s) on the device that have AFLAG_PHONE set. If not, it can
cause slowness on the device since every key will be first sent to each of the currently
running AFLAG_PHONE apps prior to sending to the top-visible app