|
|
SophiaFramework UNIVERSE 5.3 |
//////////////////////////////////////// Will be deprecated in version 6.0 ////////// enum SFCEventEnum { ///////////////////////////////////////////////////////////////////////////////////// //enum { SFEVT_BEGIN = 0x0000, // BREW Applet Class SFEVT_APPLET_CLASS_BEGIN = 0x0000, SFEVT_APP_START = EVT_APP_START, SFEVT_APP_STOP = EVT_APP_STOP, SFEVT_APP_SUSPEND = EVT_APP_SUSPEND, SFEVT_APP_RESUME = EVT_APP_RESUME, SFEVT_APP_CONFIG = EVT_APP_CONFIG, SFEVT_APP_HIDDEN_CONFIG = EVT_APP_HIDDEN_CONFIG, SFEVT_APP_BROWSE_URL = EVT_APP_BROWSE_URL, SFEVT_APP_BROWSE_FILE = EVT_APP_BROWSE_FILE, SFEVT_APP_MESSAGE = EVT_APP_MESSAGE, #if TARGET_VERSION_GE(2, 1, 0) SFEVT_ASYNC_ERROR = EVT_ASYNC_ERROR, SFEVT_APP_TERMINATE = EVT_APP_TERMINATE, SFEVT_EXIT = EVT_EXIT, #endif #if TARGET_VERSION_GE(3, 0, 0) SFEVT_APP_RESTART = EVT_APP_RESTART, SFEVT_EXT_STOP = EVT_EXT_STOP, SFEVT_EXT_CREATE = EVT_EXT_CREATE, SFEVT_EXT_RELEASE = EVT_EXT_RELEASE, #endif #if TARGET_VERSION_GE(3, 1, 0) SFEVT_APP_MESSAGE_EX = EVT_APP_MESSAGE_EX, SFEVT_APP_START_BACKGROUND = EVT_APP_START_BACKGROUND, SFEVT_APP_WOULD_START = EVT_APP_WOULD_START, SFEVT_APP_POST_URL = EVT_APP_POST_URL, #endif #if TARGET_VERSION_GE(4, 0, 0) SFEVT_APP_START_WINDOW = EVT_APP_START_WINDOW, #endif SFEVT_APPLET_CLASS_END = 0x00FF, // BREW Key Class SFEVT_KEY_CLASS_BEGIN = 0x0100, SFEVT_KEY = EVT_KEY, SFEVT_KEY_PRESS = EVT_KEY_PRESS, SFEVT_KEY_RELEASE = EVT_KEY_RELEASE, #if TARGET_VERSION_LT(3, 0, 0) SFEVT_KEY_HELD = EVT_KEY_HELD, #endif SFEVT_CHAR = EVT_CHAR, SFEVT_UPDATECHAR = EVT_UPDATECHAR, #if TARGET_VERSION_GE(3, 1, 0) SFEVT_KEY_HOOK = EVT_KEY_HOOK, SFEVT_KEY_HOOK_PRESS = EVT_KEY_HOOK_PRESS, SFEVT_KEY_HOOK_RELEASE = EVT_KEY_HOOK_RELEASE, #endif SFEVT_KEY_CLASS_END = 0x01FF, // BREW Control Class SFEVT_CONTROL_CLASS_BEGIN = 0x0200, SFEVT_COMMAND = EVT_COMMAND, SFEVT_CTL_TAB = EVT_CTL_TAB, SFEVT_CTL_SET_TITLE = EVT_CTL_SET_TITLE, SFEVT_CTL_SET_TEXT = EVT_CTL_SET_TEXT, SFEVT_CTL_ADD_ITEM = EVT_CTL_ADD_ITEM, SFEVT_CTL_CHANGING = EVT_CTL_CHANGING, SFEVT_CTL_MENU_OPEN = EVT_CTL_MENU_OPEN, SFEVT_CTL_SKMENU_PAGE_FULL = EVT_CTL_SKMENU_PAGE_FULL, SFEVT_CTL_SEL_CHANGED = EVT_CTL_SEL_CHANGED, SFEVT_CTL_TEXT_MODECHANGED = EVT_CTL_TEXT_MODECHANGED, SFEVT_CONTROL_CLASS_END = 0x02FF, // BREW Dialog Class SFEVT_DIALOG_CLASS_BEGIN = 0x0300, SFEVT_DIALOG_INIT = EVT_DIALOG_INIT, SFEVT_DIALOG_START = EVT_DIALOG_START, SFEVT_DIALOG_END = EVT_DIALOG_END, SFEVT_COPYRIGHT_END = EVT_COPYRIGHT_END, SFEVT_DIALOG_CLASS_END = 0x03FF, // BREW Shell Class SFEVT_SHELL_CLASS_BEGIN = 0x0400, SFEVT_ALARM = EVT_ALARM, SFEVT_NOTIFY = EVT_NOTIFY, SFEVT_APP_NO_CLOSE = EVT_APP_NO_CLOSE, SFEVT_APP_NO_SLEEP = EVT_APP_NO_SLEEP, SFEVT_MOD_LIST_CHANGED = EVT_MOD_LIST_CHANGED, #if TARGET_VERSION_GE(4, 0, 0) SFEVT_NOTIFY_FAILURE = EVT_NOTIFY_FAILURE, #endif SFEVT_SHELL_CLASS_END = 0x04FF, // BREW Device Class SFEVT_DEVICE_CLASS_BEGIN = 0x0500, SFEVT_FLIP = EVT_FLIP, SFEVT_LOCKED = EVT_LOCKED, SFEVT_KEYGUARD = EVT_KEYGUARD, #if TARGET_VERSION_GE(3, 0, 0) SFEVT_HEADSET = EVT_HEADSET, SFEVT_PEN_DOWN = EVT_PEN_DOWN, SFEVT_PEN_MOVE = EVT_PEN_MOVE, SFEVT_PEN_UP = EVT_PEN_UP, #endif #if TARGET_VERSION_GE(3, 1, 0) SFEVT_PEN_STALE_MOVE = EVT_PEN_STALE_MOVE, SFEVT_JOYSTICK_POS = EVT_JOYSTICK_POS, SFEVT_JOYSTICK_STALE_POS = EVT_JOYSTICK_STALE_POS, SFEVT_SCR_ROTATE = EVT_SCR_ROTATE, #endif SFEVT_DEVICE_CLASS_END = 0x05FF, // BREW Clipboard Class SFEVT_CLIPBOARD_CLASS_BEGIN = 0x0600, SFEVT_CB_CUT = EVT_CB_CUT, SFEVT_CB_COPY = EVT_CB_COPY, SFEVT_CB_PASTE = EVT_CB_PASTE, SFEVT_CLIPBOARD_CLASS_END = 0x06FF, #if TARGET_VERSION_GE(4, 0, 0) // BREW OEM Class SFEVT_OEM_CLASS_BEGIN = EVT_OEM_START, SFEVT_OEM_CLASS_END = EVT_OEM_END, #endif #if TARGET_VERSION_GE(3, 0, 0) // BREW Dynamic Class SFEVT_DYNAMIC_CLASS_BEGIN = EVT_DYNAMIC_START, SFEVT_DYNAMIC_CLASS_END = EVT_DYNAMIC_END, #endif // SophiaFramework UNIVERSE Responder Class SFEVT_RESPONDER_CLASS_BEGIN = 0x7000, SFEVT_RESPONDER_OWNER, SFEVT_RESPONDER_BOUND, SFEVT_RESPONDER_MARGIN, SFEVT_RESPONDER_STATE, SFEVT_RESPONDER_FOCUS, SFEVT_RESPONDER_RENDER, SFEVT_RESPONDER_STYLE, SFEVT_RESPONDER_VALUE, SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_SOFTKEY, SFEVT_RESPONDER_SCROLLBAR, SFEVT_RESPONDER_FRAME, SFEVT_RESPONDER_BROWSER_NOTIFY, SFEVT_RESPONDER_CLASS_END = 0x7FFF, // SophiaFramework UNIVERSE User Class SFEVT_USER_CLASS_BEGIN = 0x8000, SFEVT_USER, SFEVT_USER_CLASS_END = 0xFFFE, SFEVT_NONE = 0xFFFF, //////////////////////////////////////// Will be deprecated in version 6.0 ////////// // SophiaFramework UNIVERSE Responder Class SREVT_CLASS_BEGIN = 0x7000, SREVT_RESPONDER = 0x7000, SREVT_RESPONDER_INITIALIZE, SREVT_RESPONDER_TERMINATE, SREVT_RESPONDER_RENDER, SREVT_RESPONDER_STATUS, SREVT_APPLICATION = 0x7100, SREVT_WINDOW = 0x7200, SREVT_DIALOG = 0x7300, SREVT_MENU = 0x7400, SREVT_PANE = 0x7500, SREVT_CONTROL = 0x7600, SREVT_CLASS_END = 0x7FFF, ///////////////////////////////////////////////////////////////////////////////////// SFEVT_END = 0xFFFF };
SFCEventEnum is the enumerative type denoting event types. Event types from 0x0000 to 0x6FFF are reserved for BREW, and ones from 0x7000 to 0x7FFF are reserved for SophiaFramework UNIVERSE too. If a user-defined event type is needed, event types from 0x8000 to 0xFFFF are available as the SFEVT_USER event.
Table 288. Starting event number and ending event number
| Event name | Description |
|---|---|
| SFEVT_BEGIN | Starting event number |
| SFEVT_END | Ending event number |
Table 289. BREW-defined event: Events of the BREW applet class
| Event name | Description |
|---|---|
| SFEVT_APPLICATION_CLASS_BEGIN | Starting event number of the BREW applet |
| SFEVT_APP_START | Main App started |
| SFEVT_APP_STOP | App stopped |
| SFEVT_APP_SUSPEND | App suspended |
| SFEVT_APP_RESUME | App resume |
| SFEVT_APP_CONFIG | Alternate App Start - configuration screen should be shown... |
| SFEVT_APP_HIDDEN_CONFIG | Alternate App Start - hidden configuration screen... |
| SFEVT_APP_BROWSE_URL | Called after EVT_APP_START - P32 = (const char * pURL) |
| SFEVT_APP_BROWSE_FILE | Called after EVT_APP_START |
| SFEVT_APP_MESSAGE | Text message - P16 = AEESMSEncoding, P32 = String format dependant on P16 value |
| SFEVT_ASYNC_ERROR | Async error notification (valid for BREW SDK version 2.1 or above) |
| SFEVT_APP_TERMINATE | Forcefully terminate app terminate (valid for BREW SDK version 2.1 or above) |
| SFEVT_EXIT | BREW shutdown/exit message (valid for BREW SDK version 2.1 or above) |
| SFEVT_APP_RESTART | Sent to background apps after upgrades |
| SFEVT_EXT_STOP | Sent to all open apps |
| SFEVT_EXT_CREATE (valid for BREW SDK version 3.1 or above) | Extension class created |
| SFEVT_EXT_RELEASE (valid for BREW SDK version 3.1 or above) | Extension class released |
| SFEVT_APP_MESSAGE_EX | Text message - P16 = 0, P32 = Transaction ID (valid for BREW SDK version 3.1 or above) |
| SFEVT_APP_START_BACKGROUND | App started in the background (valid for BREW SDK version 3.1 or above) |
| SFEVT_APP_WOULD_START | Notification to top-visible app of ISHELL_StartApplet() of same app (valid for BREW SDK version 3.1 or above) |
| SFEVT_APP_POST_URL | Called with P32 as (const char * pURL) but no EVT_APP_START |
| SFEVT_APP_START_WINDOW | Start event for window application (valid for BREW SDK version 4.0 or above) |
| SFEVT_APPLICATION_CLASS_END | Ending event number of the BREW applet |
Table 290. BREW-defined event: Events of the BREW key class
| Event name | Description |
|---|---|
| SFEVT_KEY_CLASS_BEGIN | Starting number of the SFEVT_KY_CLASS event |
| SFEVT_KEY | App key - P16 = KEYCODE, P32 = Bitflags for modifier keys |
| SFEVT_KEY_PRESS | App keydown - P16= KEYCODE, P32 = Bitflags for modifier keys |
| SFEVT_KEY_RELEASE | App keyRelease - P16 = KEYCODE, P32 = Bitflags for modifier keys |
| SFEVT_KEY_HELD | key held (valid for BREW SDK version 2.1 or below) |
| SFEVT_CHAR | Character Event P16 = AECHAR, P32 = Bitflags for modifier keys |
| SFEVT_UPDATECHAR | Char update Event P16 = AECHAR, P32 = Bitflags for modifier keys |
| SFEVT_KEY_HOOK | hook key - P16 = KEYCODE, P32 = Bitflags for modifier keys |
| SFEVT_KEY_HOOK_PRESS | hook keydown - P16 = KEYCODE, P32 = Bitflags for modifier keys |
| SFEVT_KEY_HOOK_RELEASE | Hook key release |
| SFEVT_KEY_CLASS_END | hook keyRelease - P16 = KEYCODE, P32 = Bitflags for modifier keys |
Table 291. BREW-defined event: Events of the BREW control class
| Event name | Description |
|---|---|
| SFEVT_CONTROL_CLASS_BEGIN | Starting number of the SFEVT_CONTROL_CLASS event |
| SFEVT_COMMAND | App custom control... |
| SFEVT_CTL_TAB | App TAB event sent by controls - P32 = control, P16 = 0-left, 1-right |
| SFEVT_CTL_SET_TITLE | Message interface to set title - P16 = ID, P32 = res file (if ID != 0) or text |
| SFEVT_CTL_SET_TEXT | Message interface to set text - P16 = ID, P32 = res file (if ID != 0) or text |
| SFEVT_CTL_ADD_ITEM | Message interface to add item - P32 = CtlAddItem |
| SFEVT_CTL_CHANGING | App P32 = CtlValChange |
| SFEVT_CTL_MENU_OPEN | Sent by ITextCtl before menu activated... |
| SFEVT_CTL_SKMENU_PAGE_FULL | Sent by IMenuCtl when SK menu page is full (P32 = IMenuCtl *) |
| SFEVT_CTL_SEL_CHANGED | Menu - P16 - selection ID, (P32 = IMenuCtl *) |
| SFEVT_CTL_TEXT_MODECHANGED | Sent by ITextCtl when mode was changed - P16 = AEETextInputMode, (P32 = ITextCtl *) |
| SFEVT_CONTROL_CLASS_END | Ending number of the SFEVT_CONTROL_CLASS event |
Table 292. BREW-defined event: Events of the BREW dialog class
| Event name | Description |
|---|---|
| SFEVT_DIALOG_CLASS_BEGIN | Starting number of the SFEVT_DIALOG_CLASS event |
| SFEVT_DIALOG_INIT | Dialog Event - Controls created, pre-init values, flags, etc. |
| SFEVT_DIALOG_START | Dialog Event - Dialog opening - wShortData = ID, P32 = IDialog * |
| SFEVT_DIALOG_END | Dialog Event - Dialog completed normally - wShortData = ID, P32 = IDialog * |
| SFEVT_COPYRIGHT_END | Dialog Event - Copyright dialog ended |
| SFEVT_DIALOG_CLASS_END | Ending number of the SFEVT_DIALOG_CLASS event |
Table 293. >BREW-defined event: Events of the BREW shell class
| Event name | Description |
|---|---|
| SFEVT_SHELL_CLASS_BEGIN | Starting number of the SFEVT_SHELL_CLASS event |
| SFEVT_ALARM | App wShortData = uCode |
| SFEVT_NOTIFY | P32 = AEENotify * |
| SFEVT_APP_NO_CLOSE | App should not be closed |
| SFEVT_APP_NO_SLEEP | App is working - called after long periods of non-idle app |
| SFEVT_MOD_LIST_CHANGED | List of modules changed. May be sent while app suspended! |
| SFEVT_NOTIFY_FAILURE | Notification registration failed - P32 = AEENotifyFailure * (valid for BREW SDK version 4.0 or above) |
| SFEVT_SHELL_CLASS_END | Ending number of the SFEVT_SHELL_CLASS event |
Table 294. BREW-defined event: Events of the BREW device class
| Event name | Description |
|---|---|
| SFEVT_DEVICE_CLASS_BEGIN | Starting number of the SFEVT_DEVICE_CLASS event |
| SFEVT_FLIP | Flip open/close: P16 = TRUE if open, FALSE if closed. |
| SFEVT_LOCKED | User interface locked: Deprecated from BREW 3.1 |
| SFEVT_KEYGUARD | Key locked: P16 = TRUE if keyguard is on |
| SFEVT_HEADSET | Headphone connected: P16 = TRUE if headset is plugged in, FALSE if otherwise |
| SFEVT_PEN_DOWN | Pen down: P32 = position: signed x in upper 16 bits, y in lower |
| SFEVT_PEN_MOVE | Pen moved: P32 = position: signed x in upper 16 bits, y in lower |
| SFEVT_PEN_UP | Pen up: P32 = position: signed x in upper 16 bits, y in lower |
| SFEVT_PEN_STALE_MOVE | Stale pen moved: P32 = position: signed x in upper 16 bits, y in lower |
| SFEVT_JOYSTICK_POS | Joystick exists: P32 = position: signed x in upper 16 bits, y in lower |
| SFEVT_JOYSTICK_STALE_POS | Stale joystick exists: P32 = position: signed x in upper 16 bits, y in lower |
| SFEVT_SCR_ROTATE | Screen rotated: P16 = AEEScrOrientation (Portrait or Landscape) P32 = screen ID |
| SFEVT_DEVICE_CLASS_END | Ending number of the SFEVT_DEVICE_CLASS event |
Table 295. BREW-defined event: Events of the BREW clipboard class
| Event name | Description |
|---|---|
| SFEVT_CLIPBOARD_CLASS_BEGIN | Starting number of the SFEVT_CLIPBOARD_CLASS event |
| SFEVT_CB_CUT | Cut request - P32 = (const char *)preferred format, NULL for all |
| SFEVT_CB_COPY | Copy request - P32 = (const char *)preferred format, NULL for all |
| SFEVT_CB_PASTE | Paste request - no parameters |
| SFEVT_CLIPBOARD_CLASS_END | Ending number of the SFEVT_CLIPBOARD_CLASS event |
Table 296. BREW-defined event: Events of BREW OEM class
| Event name | Description |
|---|---|
| SFEVT_OEM_CLASS_BEGIN | Starting number of the SFEVT_OEM_CLASS event |
| SFEVT_OEM_CLASS_END | Ending number of the SFEVT_OEM_CLASS event |
Table 297. BREW-defined event: Events of the BREW dynamic class
| Event name | Description |
|---|---|
| SFEVT_DYNAMIC_CLASS_BEGIN | Starting number of the SFEVT_DYNAMIC_CLAS event |
| SFEVT_DYNAMIC_CLASS_END | Ending number of the SFEVT_DYNAMIC_CLAS event |
Table 298. Responder-defined event: Events of the SFY responder class
| Event name | Description |
|---|---|
| SFEVT_RESPONDER_CLASS_BEGIN | Starting number of the SFEVT_RESPONDER_CLASS event |
| SFEVT_RESPONDER_OWNER | Parent Child Event |
| SFEVT_RESPONDER_MARGIN | Margin Event |
| SFEVT_RESPONDER_BOUND | Region Event |
| SFEVT_RESPONDER_STATE | State Event |
| SFEVT_RESPONDER_FOCUS | Focus Event |
| SFEVT_RESPONDER_RENDER | Drawing Event |
| SFEVT_RESPONDER_STYLE | Style Event |
| SFEVT_RESPONDER_VALUE | Value Event |
| SFEVT_RESPONDER_RESULT | Result Event |
| SFEVT_RESPONDER_SOFTKEY | SoftKey Event |
| SFEVT_RESPONDER_SCROLLBAR | Scroll Bar Event |
| SFEVT_RESPONDER_CLASS_END | Ending number of the SFEVT_RESPONDER_CLASS event |
Table 299. Responder-defined event: Events of the SFR responder class
| Event name | Description |
|---|---|
| SREVT_CLASS_BEGIN | Starting number of the SREVT_CLASS event |
| SREVT_RESPONDER | Responder inherent event |
| SREVT_RESPONDER_TERMINATE | Responder terminating event |
| SREVT_RESPONDER_RENDER | Responder redrawing event |
| SREVT_APPLICATION | Application inherent event |
| SREVT_WINDOW | Window inherent event |
| SREVT_DIALOG | Dialog inherent event |
| SREVT_MENU | Menu inherent event |
| SREVT_CONTROL | Control inherent event |
| SREVT_CLASS_END | Ending number of the SREVT_CLASS event |
|
Copyright(c) 2002 - 2024 Sophia Cradle Incorporated All Rights Reserved. |
|