PrevNextUpHome BREW C++ Class Library & GUI Framework & XML Middleware : SophiaFramework 4.1
SFCEventEnum
Event constants.
enum SFCEventEnum {
    SFEVT_BEGIN                         = 0x0000,
    // BREW Application Class
    SFEVT_APPLICATION_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
    SFEVT_APPLICATION_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,
    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(3, 0, 0)
    // BREW Dynamic Class
    SFEVT_DYNAMIC_CLASS_BEGIN           = EVT_DYNAMIC_START,
    SFEVT_DYNAMIC_CLASS_END             = EVT_DYNAMIC_END,
    #endif
    // SophiaFramework 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,
    // SophiaFramework User Class
    SFEVT_USER_CLASS_BEGIN              = 0x8000,
    SFEVT_USER                          = 0x8000,
    SFEVT_USER_CLASS_END                = 0xFFFF,
    SFEVT_END                           = 0xFFFF
};

Description

SFCEventEnum is the enumerative type denoting event types. 0x0000-0x6FFF (event type) is reserved for BREW, 0x7000-0x7FFF is reserved for SophiaFramework. When creating user defined event types, please use from 0x8000 (SFEVT_USER).

Table 105. Begin number and end number of the event

Event name Description
SFEVT_BEGIN Begin number of the event
SFEVT_END End number of the event

Table 106. Events of the BREW application class

Event name Description
SFEVT_APPLICATION_CLASS_BEGIN Begin number
SFEVT_APP_START Application start
SFEVT_APP_STOP Application stop
SFEVT_APP_SUSPEND Application suspend
SFEVT_APP_RESUME Application resume
SFEVT_APP_CONFIG Initial event of a special application: displaying the setting screen is required
SFEVT_APP_HIDDEN_CONFIG Initial event of a special application: hidden setting screen is required
SFEVT_APP_BROWSE_URL Browse a specified URL (called after the application started)
SFEVT_APP_BROWSE_FILE Browse a specified file (called after the application started)
SFEVT_APP_MESSAGE Text message
SFEVT_ASYNC_ERROR Asynchronous error notification (valid for BREW SDK version 2.1 or latter)
SFEVT_APP_TERMINATE Application terminate (valid for BREW SDK version 2.1 or latter)
SFEVT_EXIT BREW exit (valid for BREW SDK version 2.1 or latter)
SFEVT_APP_RESTART Send to the background application after upgrading
SFEVT_EXT_STOP Send to all running applications
SFEVT_EXT_CREATE Created extension class
SFEVT_EXT_RELEASE Released extension class
SFEVT_APP_WOULD_START The currently topmost application is started
SFEVT_APP_POST_URL Without sending the SFEVT_APP_START event, set the URL in the dwParam and notify to the application
SFEVT_APPLICATION_CLASS_END End number

Table 107. Events of BREW key class

Event name Description
SFEVT_KEY_CLASS_BEGIN Begin number
SFEVT_KEY Key input
SFEVT_KEY_PRESS Key press
SFEVT_KEY_RELEASE Key release
SFEVT_KEY_HELD key held (valid for BREW SDK version 3.1 or less)
SFEVT_CHAR Character input
SFEVT_UPDATECHAR Character update
SFEVT_KEY_HOOK Hook key
SFEVT_KEY_HOOK_PRESS Hook key press
SFEVT_KEY_HOOK_RELEASE Hook key release
SFEVT_KEY_CLASS_END End number

Table 108. Events of BREW control class

Event name Description
SFEVT_CONTROL_CLASS_BEGIN Begin number
SFEVT_COMMAND Custom event
SFEVT_CTL_TAB Tab processing
SFEVT_CTL_SET_TITLE Set title
SFEVT_CTL_SET_TEXT Set text
SFEVT_CTL_ADD_ITEM Add item
SFEVT_CTL_CHANGING Changing
SFEVT_CTL_MENU_OPEN Menu becomes active
SFEVT_CTL_SKMENU_PAGE_FULL Menu page is full
SFEVT_CTL_SEL_CHANGED Selection item changed
SFEVT_CTL_TEXT_MODECHANGED Text input mode changed
SFEVT_CONTROL_CLASS_END End number

Table 109. Events of BREW dialog class

Event name Description
SFEVT_DIALOG_CLASS_BEGIN Begin number
SFEVT_DIALOG_INIT Dialog initializing
SFEVT_DIALOG_START Dialog start
SFEVT_DIALOG_END Dialog end
SFEVT_COPYRIGHT_END Copyright dialog end
SFEVT_DIALOG_CLASS_END End number

Table 110. >Events of BREW shell class

Event name Description
SFEVT_SHELL_CLASS_BEGIN Begin number
SFEVT_ALARM Alarm
SFEVT_NOTIFY Notify
SFEVT_APP_NO_CLOSE Enquire if the application may end
SFEVT_APP_NO_SLEEP Enquire if the terminal may enter the sleep mode
SFEVT_APP_START_BACKGROUND Start the application in background
SFEVT_SHELL_CLASS_END End number

Table 111. Events of BREW device class

Event name Description
SFEVT_DEVICE_CLASS_BEGIN Begin number
SFEVT_FLIP Flip open/shut
SFEVT_LOCKED User interface locked(unusable with BREW 3.1)
SFEVT_KEYGUARD Key locked
SFEVT_HEADSET Headphone connected
SFEVT_PEN_DOWN Pen down
SFEVT_PEN_MOVE Pen moved
SFEVT_PEN_UP Pen up
SFEVT_PEN_STALE_MOVE Stale pen moved
SFEVT_JOYSTICK_POS There is a joystick
SFEVT_JOYSTICK_STALE_POS There is a stale joystick
SFEVT_SCR_ROTATE Screen rotated
SFEVT_DEVICE_CLASS_END End number

Table 112. Events of BREW clipboard class

Event name Description
SFEVT_CLIPBOARD_CLASS_BEGIN Begin number
SFEVT_CB_CUT Cut request
SFEVT_CB_COPY Copy request
SFEVT_CB_PASTE Paste request
SFEVT_CLIPBOARD_CLASS_END End number

Table 113. Events of SophiaFramework responder class

Event name Description
SREVT_CLASS_BEGIN Begin number
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 End number

Table 114. Events of SophiaFramework user class

Event name Description
SFEVT_USER_CLASS_BEGIN Begin number of user class events
SFEVT_USER Begin number of events that user can freely use
SFEVT_USER_CLASS_END End number of user class events

Table 115. The first parameter of the SophiaFramework responder event

Event name Description
SRP16_TERMINATE_INVOKE Request for terminating responder
SRP16_TERMINATE_TRY Enquiry termination notifying and continuing
SRP16_RENDER_INVOKE Request for redrawing
SRP16_RENDER_BASE Base region redrawing
SRP16_RENDER_CONTENT Content region redrawing
SRP16_RENDER_VIRTUAL Virtual region redrawing
SRP16_ESCAPE Is escaped
SRP16_CANCEL Is canceled
SRP16_OK Is acknowledged

Reference

SFXEvent