Tizen Native API  8.0
Functions | Typedefs | Defines
Event
Application

The Event API provides functions to serve publication and subscription of the event.

Required Header

#include <app_event.h>

Overview

The Event API provides functions to broadcast user-defined event.

  • event_publish_app_event()
  • event_publish_trusted_app_event() If you want to send an event to trusted application, you can use event_publish_trusted_app_event() API. Only applications which have same signature with sender application can receive the event. The Event API provides functions to add and remove the event handler for event subscription. The event handler's function will be called when the interested event occurs. Adding multiple event handlers to one event is possible. There are two types of events:
  • User-Event is user-defined event.
  • System-Event is pre-defined platform event. See definitions for system event. NOTE: You can't receive the system-event which is not supported on the target device, even if you register event handler for that event. Some system-events require the privilege. (Refer to Privileged System-Events) The type of event data is bundle type.
  • For System-Event, see definitions for key and value of system event.

The name-format of User-Event

The format of the User-Event's name MUST be "event.{sender's appid}.{user-defined name}", unless the API calls using event_name will fail. The {user-defined name} have some restrictions.

  • Must have length of Min 1 byte and Max 127 bytes.
  • Must only contain the characters("[A~Z][a~z][0~9]_") and not begin with a digit. For example, "event.org.tizen.testapp.user_event_1".

Launch-On-Event (Service Application only)

Service application can be launched by event triggering. For Launch-On-Event,

  • The APP_CONTROL_OPERATION_LAUNCH_ON_EVENT must be defined in the manifest file.
  • The URI name represents event name and the format is "event://{event name"}". For URI example, "event://tizen.system.event.battery_charger_status". (System-Event)
  • The APP_CONTROL_OPERATION_LAUNCH_ON_EVENT can not be requested via app_control_send_launch_request(). How to know the triggered event after launch by event triggering.
  • You can get the event name and data in the first call of app_control_cb, which is called after 'Created' of application states.
 static void
 app_control(app_control_h app_control, void *data)
 {
     // Check "launch on event"
     int ret = 0;
     const char *event_uri = "event://tizen.system.event.battery_charger_status";
     char *operation = NULL;
     char *uri = NULL;
     char *event_value = NULL;

     ret = app_control_get_operation(app_control, &operation);
     if (ret == APP_CONTROL_ERROR_NONE && operation &&
         strcmp(operation, APP_CONTROL_OPERATION_LAUNCH_ON_EVENT) == 0) {
         ret = app_control_get_uri(app_control, &uri);
         if (ret == APP_CONTROL_ERROR_NONE && uri) {
             if (strncmp(uri, event_uri, strlen(event_uri) + 1) == 0) {
                 ret = app_control_get_extra_data(app_control, "battery_charger_status", &event_value);
                 if (ret == APP_CONTROL_ERROR_NONE && event_value)
                     free(event_value);
             }
             free(uri);
         }
         free(operation);
     }
 }

Privileged System-Events

There are some system-events which need the privilege for normal operation. You can know these privileged system-events from the 'privilege' comment of the definition of each system-event. If you try to add event handler for these events without privilege, you will get EVENT_ERROR_PERMISSION_DENIED return when you use the API for adding event handler. Also, if you declare app_control operation and URI in the manifest file for these events to enable 'Launch On Event' without privilege, there will be no real launch.

Supported System-Events.

The supported system-event's name, keys, and values of each event are listed in the table below.

Name Key Value
SYSTEM_EVENT_BATTERY_CHARGER_STATUS EVENT_KEY_BATTERY_CHARGER_STATUS EVENT_VAL_BATTERY_CHARGER_DISCONNECTED
EVENT_VAL_BATTERY_CHARGER_CONNECTED
EVENT_VAL_BATTERY_CHARGER_CHARGING
EVENT_VAL_BATTERY_CHARGER_DISCHARGING
SYSTEM_EVENT_BATTERY_LEVEL_STATUS EVENT_KEY_BATTERY_LEVEL_STATUS EVENT_VAL_BATTERY_LEVEL_EMPTY
EVENT_VAL_BATTERY_LEVEL_CRITICAL
EVENT_VAL_BATTERY_LEVEL_LOW
EVENT_VAL_BATTERY_LEVEL_HIGH
EVENT_VAL_BATTERY_LEVEL_FULL
SYSTEM_EVENT_USB_STATUS EVENT_KEY_USB_STATUS EVENT_VAL_USB_DISCONNECTED
EVENT_VAL_USB_CONNECTED
EVENT_VAL_USB_AVAILABLE
SYSTEM_EVENT_EARJACK_STATUS EVENT_KEY_EARJACK_STATUS EVENT_VAL_EARJACK_DISCONNECTED
EVENT_VAL_EARJACK_CONNECTED
SYSTEM_EVENT_DISPLAY_STATE EVENT_KEY_DISPLAY_STATE EVENT_VAL_DISPLAY_NORMAL
EVENT_VAL_DISPLAY_DIM
EVENT_VAL_DISPLAY_OFF
SYSTEM_EVENT_BOOT_COMPLETED N/A N/A
SYSTEM_EVENT_SYSTEM_SHUTDOWN N/A N/A
SYSTEM_EVENT_LOW_MEMORY EVENT_KEY_LOW_MEMORY EVENT_VAL_MEMORY_NORMAL
EVENT_VAL_MEMORY_SOFT_WARNING
EVENT_VAL_MEMORY_HARD_WARNING
SYSTEM_EVENT_WIFI_STATE EVENT_KEY_WIFI_STATE EVENT_VAL_WIFI_OFF
EVENT_VAL_WIFI_ON
EVENT_VAL_WIFI_CONNECTED
SYSTEM_EVENT_BT_STATE EVENT_KEY_BT_STATE EVENT_VAL_BT_OFF
EVENT_VAL_BT_ON
EVENT_KEY_BT_LE_STATE EVENT_VAL_BT_LE_OFF
EVENT_VAL_BT_LE_ON
EVENT_KEY_BT_TRANSFERING_STATE EVENT_VAL_BT_NON_TRANSFERING
EVENT_VAL_BT_TRANSFERING
SYSTEM_EVENT_LOCATION_ENABLE_STATE EVENT_KEY_LOCATION_ENABLE_STATE EVENT_VAL_LOCATION_DISABLED
EVENT_VAL_LOCATION_ENABLED
SYSTEM_EVENT_GPS_ENABLE_STATE EVENT_KEY_GPS_ENABLE_STATE EVENT_VAL_GPS_DISABLED
EVENT_VAL_GPS_ENABLED
SYSTEM_EVENT_NPS_ENABLE_STATE EVENT_KEY_NPS_ENABLE_STATE EVENT_VAL_NPS_DISABLED
EVENT_VAL_NPS_ENABLED
SYSTEM_EVENT_INCOMING_MSG EVENT_KEY_MSG_TYPE EVENT_VAL_SMS
EVENT_VAL_PUSH
EVENT_VAL_CB
EVENT_KEY_MSG_ID string of unsigned int type value.
SYSTEM_EVENT_TIME_CHANGED N/A N/A
SYSTEM_EVENT_TIME_ZONE EVENT_KEY_TIME_ZONE The value of this key is timezone value of tz database, for example,
"Asia/Seoul", "America/New_York",
. Refer to the Time Zone Database of IANA.
SYSTEM_EVENT_HOUR_FORMAT EVENT_KEY_HOUR_FORMAT EVENT_VAL_HOURFORMAT_12
EVENT_VAL_HOURFORMAT_24
SYSTEM_EVENT_LANGUAGE_SET EVENT_KEY_LANGUAGE_SET The value of this key is full name of locale, for example,
"ko_KR.UTF8" : in case of Korean language
"en_US.UTF8" : in case of USA language,
. Refer to linux locale info.
SYSTEM_EVENT_REGION_FORMAT EVENT_KEY_REGION_FORMAT The value of this key is full name of locale, for example,
"ko_KR.UTF8" : in case of Korean region format
"en_US.UTF8" : in case of USA region format,
. Refer to linux locale info.
SYSTEM_EVENT_SILENT_MODE EVENT_KEY_SILENT_MODE EVENT_VAL_SILENTMODE_ON
EVENT_VAL_SILENTMODE_OFF
SYSTEM_EVENT_VIBRATION_STATE EVENT_KEY_VIBRATION_STATE EVENT_VAL_VIBRATION_ON
EVENT_VAL_VIBRATION_OFF
SYSTEM_EVENT_SCREEN_AUTOROTATE_STATE EVENT_KEY_SCREEN_AUTOROTATE_STATE EVENT_VAL_SCREEN_AUTOROTATE_ON
EVENT_VAL_SCREEN_AUTOROTATE_OFF
SYSTEM_EVENT_MOBILE_DATA_STATE EVENT_KEY_MOBILE_DATA_STATE EVENT_VAL_MOBILE_DATA_OFF
EVENT_VAL_MOBILE_DATA_ON
SYSTEM_EVENT_DATA_ROAMING_STATE EVENT_KEY_DATA_ROAMING_STATE EVENT_VAL_DATA_ROAMING_OFF
EVENT_VAL_DATA_ROAMING_ON
SYSTEM_EVENT_FONT_SET EVENT_KEY_FONT_SET The value of this key is font name of string type by font-config.
SYSTEM_EVENT_NETWORK_STATUS EVENT_KEY_NETWORK_STATUS EVENT_VAL_NETWORK_DISCONNECTED
EVENT_VAL_NETWORK_WIFI
EVENT_VAL_NETWORK_CELLULAR
EVENT_VAL_NETWORK_ETHERNET
EVENT_VAL_NETWORK_BT
EVENT_VAL_NETWORK_NET_PROXY

Functions

int event_add_event_handler (const char *event_name, event_cb callback, void *user_data, event_handler_h *event_handler)
 Adds the event handler for receiving event-data of interested events.
int event_remove_event_handler (event_handler_h event_handler)
 Removes the registered event handler.
int event_publish_app_event (const char *event_name, bundle *event_data)
 Sends the User-Event to receiver applications.
int event_publish_trusted_app_event (const char *event_name, bundle *event_data)
 Sends the User-Event to trusted receiver-applications.
int event_keep_last_event_data (const char *event_name)
 Keeps last User-Event data for receiver applications.

Typedefs

typedef struct event_handler * event_handler_h
 Event handle.
typedef void(* event_cb )(const char *event_name, bundle *event_data, void *user_data)
 Event callback.

Defines

#define SYSTEM_EVENT_BATTERY_CHARGER_STATUS   "tizen.system.event.battery_charger_status"
 Definition for system-event of battery : charger status.
#define EVENT_KEY_BATTERY_CHARGER_STATUS   "battery_charger_status"
 Definition for key of SYSTEM_EVENT_BATTERY_CHARGER_STATUS.
#define EVENT_VAL_BATTERY_CHARGER_DISCONNECTED   "disconnected"
 Definition for value of EVENT_KEY_BATTERY_CHARGER_STATUS.
#define EVENT_VAL_BATTERY_CHARGER_CONNECTED   "connected"
 Definition for value of EVENT_KEY_BATTERY_CHARGER_STATUS.
#define EVENT_VAL_BATTERY_CHARGER_CHARGING   "charging"
 Definition for value of EVENT_KEY_BATTERY_CHARGER_STATUS.
#define EVENT_VAL_BATTERY_CHARGER_DISCHARGING   "discharging"
 Definition for value of EVENT_KEY_BATTERY_CHARGER_STATUS.
#define SYSTEM_EVENT_BATTERY_LEVEL_STATUS   "tizen.system.event.battery_level_status"
 Definition for system-event of battery : level status.
#define EVENT_KEY_BATTERY_LEVEL_STATUS   "battery_level_status"
 Definition for key of SYSTEM_EVENT_BATTERY_LEVEL_STATUS.
#define EVENT_VAL_BATTERY_LEVEL_EMPTY   "empty"
 Definition for value of EVENT_KEY_BATTERY_LEVEL_STATUS.
#define EVENT_VAL_BATTERY_LEVEL_CRITICAL   "critical"
 Definition for value of EVENT_KEY_BATTERY_LEVEL_STATUS.
#define EVENT_VAL_BATTERY_LEVEL_LOW   "low"
 Definition for value of EVENT_KEY_BATTERY_LEVEL_STATUS.
#define EVENT_VAL_BATTERY_LEVEL_HIGH   "high"
 Definition for value of EVENT_KEY_BATTERY_LEVEL_STATUS.
#define EVENT_VAL_BATTERY_LEVEL_FULL   "full"
 Definition for value of EVENT_KEY_BATTERY_LEVEL_STATUS.
#define SYSTEM_EVENT_USB_STATUS   "tizen.system.event.usb_status"
 Definition for system-event of USB : status of USB connection.
#define EVENT_KEY_USB_STATUS   "usb_status"
 Definition for key of SYSTEM_EVENT_USB_STATUS.
#define EVENT_VAL_USB_DISCONNECTED   "disconnected"
 Definition for value of EVENT_KEY_USB_STATUS.
#define EVENT_VAL_USB_CONNECTED   "connected"
 Definition for value of EVENT_KEY_USB_STATUS.
#define EVENT_VAL_USB_AVAILABLE   "available"
 Definition for value of EVENT_KEY_USB_STATUS.
#define SYSTEM_EVENT_EARJACK_STATUS   "tizen.system.event.earjack_status"
 Definition for system-event of ear-jack : status of ear-jack connection.
#define EVENT_KEY_EARJACK_STATUS   "earjack_status"
 Definition for key of SYSTEM_EVENT_EARJACK_STATUS.
#define EVENT_VAL_EARJACK_DISCONNECTED   "disconnected"
 Definition for value of EVENT_KEY_EARJACK_STATUS.
#define EVENT_VAL_EARJACK_CONNECTED   "connected"
 Definition for value of EVENT_KEY_EARJACK_STATUS.
#define SYSTEM_EVENT_DISPLAY_STATE   "tizen.system.event.display_state"
 Definition for system-event of display : state of display.
#define EVENT_KEY_DISPLAY_STATE   "display_state"
 Definition for key of SYSTEM_EVENT_DISPLAY_STATE.
#define EVENT_VAL_DISPLAY_NORMAL   "normal"
 Definition for value of EVENT_KEY_DISPLAY_STATE.
#define EVENT_VAL_DISPLAY_DIM   "dim"
 Definition for value of EVENT_KEY_DISPLAY_STATE.
#define EVENT_VAL_DISPLAY_OFF   "off"
 Definition for value of EVENT_KEY_DISPLAY_STATE.
#define SYSTEM_EVENT_BOOT_COMPLETED   "tizen.system.event.boot_completed"
 Definition for system-event of system : boot completion.
#define SYSTEM_EVENT_SYSTEM_SHUTDOWN   "tizen.system.event.system_shutdown"
 Definition for system-event of system : shutdown.
#define SYSTEM_EVENT_LOW_MEMORY   "tizen.system.event.low_memory"
 Definition for system-event of system : low memory.
#define EVENT_KEY_LOW_MEMORY   "low_memory"
 Definition for key of SYSTEM_EVENT_LOW_MEMORY.
#define EVENT_VAL_MEMORY_NORMAL   "normal"
 Definition for value of EVENT_KEY_LOW_MEMORY.
#define EVENT_VAL_MEMORY_SOFT_WARNING   "soft_warning"
 Definition for value of EVENT_KEY_LOW_MEMORY.
#define EVENT_VAL_MEMORY_HARD_WARNING   "hard_warning"
 Definition for value of EVENT_KEY_LOW_MEMORY.
#define SYSTEM_EVENT_WIFI_STATE   "tizen.system.event.wifi_state"
 Definition for system-event of wifi : state of wifi.
#define EVENT_KEY_WIFI_STATE   "wifi_state"
 Definition for key of SYSTEM_EVENT_WIFI_STATE.
#define EVENT_VAL_WIFI_OFF   "off"
 Definition for value of EVENT_KEY_WIFI_STATE.
#define EVENT_VAL_WIFI_ON   "on"
 Definition for value of EVENT_KEY_WIFI_STATE.
#define EVENT_VAL_WIFI_CONNECTED   "connected"
 Definition for value of EVENT_KEY_WIFI_STATE.
#define SYSTEM_EVENT_BT_STATE   "tizen.system.event.bt_state"
 Definition for system-event of bluetooth : status of bluetooth.
#define EVENT_KEY_BT_STATE   "bt_state"
 Definition for key of SYSTEM_EVENT_BT_STATE.
#define EVENT_VAL_BT_OFF   "off"
 Definition for value of EVENT_KEY_BT_STATE.
#define EVENT_VAL_BT_ON   "on"
 Definition for value of EVENT_KEY_BT_STATE.
#define EVENT_KEY_BT_LE_STATE   "bt_le_state"
 Definition for key of SYSTEM_EVENT_BT_STATE.
#define EVENT_VAL_BT_LE_OFF   "off"
 Definition for value of EVENT_KEY_BT_LE_STATE.
#define EVENT_VAL_BT_LE_ON   "on"
 Definition for value of EVENT_KEY_BT_LE_STATE.
#define EVENT_KEY_BT_TRANSFERING_STATE   "bt_transfering_state"
 Definition for key of SYSTEM_EVENT_BT_STATE.
#define EVENT_VAL_BT_NON_TRANSFERING   "non_transfering"
 Definition for value of EVENT_KEY_BT_TRANSFERING_STATE.
#define EVENT_VAL_BT_TRANSFERING   "transfering"
 Definition for value of EVENT_KEY_BT_TRANSFERING_STATE.
#define SYSTEM_EVENT_LOCATION_ENABLE_STATE   "tizen.system.event.location_enable_state"
 Definition for system-event of location : enable state of location.
#define EVENT_KEY_LOCATION_ENABLE_STATE   "location_enable_state"
 Definition for key of SYSTEM_EVENT_LOCATION_ENABLE_STATE.
#define EVENT_VAL_LOCATION_DISABLED   "disabled"
 Definition for value of EVENT_KEY_LOCATION_ENABLE_STATE.
#define EVENT_VAL_LOCATION_ENABLED   "enabled"
 Definition for value of EVENT_KEY_LOCATION_ENABLE_STATE.
#define SYSTEM_EVENT_GPS_ENABLE_STATE   "tizen.system.event.gps_enable_state"
 Definition for system-event of location : enable state of gps.
#define EVENT_KEY_GPS_ENABLE_STATE   "gps_enable_state"
 Definition for key of SYSTEM_EVENT_GPS_ENABLE_STATE.
#define EVENT_VAL_GPS_DISABLED   "disabled"
 Definition for value of EVENT_KEY_GPS_ENABLE_STATE.
#define EVENT_VAL_GPS_ENABLED   "enabled"
 Definition for value of EVENT_KEY_GPS_ENABLE_STATE.
#define SYSTEM_EVENT_NPS_ENABLE_STATE   "tizen.system.event.nps_enable_state"
 Definition for system-event of location : enable state of nps.
#define EVENT_KEY_NPS_ENABLE_STATE   "nps_enable_state"
 Definition for key of SYSTEM_EVENT_NPS_ENABLE_STATE.
#define EVENT_VAL_NPS_DISABLED   "disabled"
 Definition for value of EVENT_KEY_NPS_ENABLE_STATE.
#define EVENT_VAL_NPS_ENABLED   "enabled"
 Definition for value of EVENT_KEY_NPS_ENABLE_STATE.
#define SYSTEM_EVENT_INCOMING_MSG   "tizen.system.event.incoming_msg"
 Definition for system-event of message : incoming msg.
#define EVENT_KEY_MSG_TYPE   "msg_type"
 Definition for key of SYSTEM_EVENT_INCOMING_MSG.
#define EVENT_VAL_SMS   "sms"
 Definition for value of EVENT_KEY_MSG_TYPE.
#define EVENT_VAL_MMS   "mms"
 Definition for value of EVENT_KEY_MSG_TYPE.
#define EVENT_VAL_PUSH   "push"
 Definition for value of EVENT_KEY_MSG_TYPE.
#define EVENT_VAL_CB   "cb"
 Definition for value of EVENT_KEY_MSG_TYPE.
#define EVENT_KEY_MSG_ID   "msg_id"
 Definition for key of SYSTEM_EVENT_INCOMING_MSG.
#define SYSTEM_EVENT_OUTGOING_MSG   "tizen.system.event.outgoing_msg"
 Definition for system-event of message : outgoing msg.
#define EVENT_KEY_OUT_MSG_TYPE   "msg_type"
 Definition for key of SYSTEM_EVENT_OUTGOING_MSG.
#define EVENT_VAL_OUT_MSG_SMS   "sms"
 Definition for value of EVENT_KEY_OUT_MSG_TYPE.
#define EVENT_VAL_OUT_MSG_MMS   "mms"
 Definition for value of EVENT_KEY_OUT_MSG_TYPE.
#define EVENT_KEY_OUT_MSG_ID   "msg_id"
 Definition for key of SYSTEM_EVENT_OUTGOING_MSG.
#define SYSTEM_EVENT_TIME_CHANGED   "tizen.system.event.time_changed"
 Definition for system-event of setting : time changed.
#define SYSTEM_EVENT_TIME_ZONE   "tizen.system.event.time_zone"
 Definition for system-event of setting : timezone setting.
#define EVENT_KEY_TIME_ZONE   "time_zone"
 Definition for key of SYSTEM_EVENT_TIME_ZONE.
#define SYSTEM_EVENT_HOUR_FORMAT   "tizen.system.event.hour_format"
 Definition for system-event of setting : hour format.
#define EVENT_KEY_HOUR_FORMAT   "hour_format"
 Definition for key of SYSTEM_EVENT_HOUR_FORMAT.
#define EVENT_VAL_HOURFORMAT_12   "12"
 Definition for value of EVENT_KEY_HOUR_FORMAT.
#define EVENT_VAL_HOURFORMAT_24   "24"
 Definition for value of EVENT_KEY_HOUR_FORMAT.
#define SYSTEM_EVENT_LANGUAGE_SET   "tizen.system.event.language_set"
 Definition for system-event of setting : language setting.
#define EVENT_KEY_LANGUAGE_SET   "language_set"
 Definition for key of SYSTEM_EVENT_LANGUAGE_SET.
#define SYSTEM_EVENT_REGION_FORMAT   "tizen.system.event.region_format"
 Definition for system-event of setting : region format.
#define EVENT_KEY_REGION_FORMAT   "region_format"
 Definition for key of SYSTEM_EVENT_REGION_FORMAT.
#define SYSTEM_EVENT_SILENT_MODE   "tizen.system.event.silent_mode"
 Definition for system-event of setting : silent_mode.
#define EVENT_KEY_SILENT_MODE   "silent_mode"
 Definition for key of SYSTEM_EVENT_SILENT_MODE.
#define EVENT_VAL_SILENTMODE_ON   "on"
 Definition for value of EVENT_KEY_SILENT_MODE.
#define EVENT_VAL_SILENTMODE_OFF   "off"
 Definition for value of EVENT_KEY_SILENT_MODE.
#define SYSTEM_EVENT_VIBRATION_STATE   "tizen.system.event.vibration_state"
 Definition for system-event of setting : state of vibration.
#define EVENT_KEY_VIBRATION_STATE   "vibration_state"
 Definition for key of SYSTEM_EVENT_VIBRATION_STATE.
#define EVENT_VAL_VIBRATION_ON   "on"
 Definition for value of EVENT_KEY_VIBRATION_STATE.
#define EVENT_VAL_VIBRATION_OFF   "off"
 Definition for value of EVENT_KEY_VIBRATION_STATE.
#define SYSTEM_EVENT_SCREEN_AUTOROTATE_STATE   "tizen.system.event.screen_autorotate_state"
 Definition for system-event of setting : state of screen's auto-rotation.
#define EVENT_KEY_SCREEN_AUTOROTATE_STATE   "screen_autorotate_state"
 Definition for key of SYSTEM_EVENT_SCREEN_AUTOROTATE_STATE.
#define EVENT_VAL_SCREEN_AUTOROTATE_ON   "on"
 Definition for value of EVENT_KEY_SCREEN_AUTOROTATE_STATE.
#define EVENT_VAL_SCREEN_AUTOROTATE_OFF   "off"
 Definition for value of EVENT_KEY_SCREEN_AUTOROTATE_STATE.
#define SYSTEM_EVENT_MOBILE_DATA_STATE   "tizen.system.event.mobile_data_state"
 Definition for system-event of setting : state of mobile data.
#define EVENT_KEY_MOBILE_DATA_STATE   "mobile_data_state"
 Definition for key of SYSTEM_EVENT_MOBILE_DATA_STATE.
#define EVENT_VAL_MOBILE_DATA_OFF   "off"
 Definition for value of EVENT_KEY_MOBILE_DATA_STATE.
#define EVENT_VAL_MOBILE_DATA_ON   "on"
 Definition for value of EVENT_KEY_MOBILE_DATA_STATE.
#define SYSTEM_EVENT_DATA_ROAMING_STATE   "tizen.system.event.data_roaming_state"
 Definition for system-event of setting : state of data roaming.
#define EVENT_KEY_DATA_ROAMING_STATE   "data_roaming_state"
 Definition for key of SYSTEM_EVENT_DATA_ROAMING_STATE.
#define EVENT_VAL_DATA_ROAMING_OFF   "off"
 Definition for value of EVENT_KEY_DATA_ROAMING_STATE.
#define EVENT_VAL_DATA_ROAMING_ON   "on"
 Definition for value of EVENT_KEY_DATA_ROAMING_STATE.
#define SYSTEM_EVENT_FONT_SET   "tizen.system.event.font_set"
 Definition for system-event of setting : font setting.
#define EVENT_KEY_FONT_SET   "font_set"
 Definition for key of SYSTEM_EVENT_FONT_SET.
#define SYSTEM_EVENT_NETWORK_STATUS   "tizen.system.event.network_status"
 Definition for system-event of network : status of network.
#define EVENT_KEY_NETWORK_STATUS   "network_status"
 Definition for key of SYSTEM_EVENT_NETWORK_STATUS.
#define EVENT_VAL_NETWORK_DISCONNECTED   "disconnected"
 Definition for value of EVENT_KEY_NETWORK_STATUS.
#define EVENT_VAL_NETWORK_WIFI   "wifi"
 Definition for value of EVENT_KEY_NETWORK_STATUS.
#define EVENT_VAL_NETWORK_CELLULAR   "cellular"
 Definition for value of EVENT_KEY_NETWORK_STATUS.
#define EVENT_VAL_NETWORK_ETHERNET   "ethernet"
 Definition for value of EVENT_KEY_NETWORK_STATUS.
#define EVENT_VAL_NETWORK_BT   "bt"
 Definition for value of EVENT_KEY_NETWORK_STATUS.
#define EVENT_VAL_NETWORK_NET_PROXY   "net_proxy"
 Definition for value of EVENT_KEY_NETWORK_STATUS.

Define Documentation

#define EVENT_KEY_BATTERY_CHARGER_STATUS   "battery_charger_status"

Definition for key of SYSTEM_EVENT_BATTERY_CHARGER_STATUS.

Since :
2.4
See also:
EVENT_VAL_BATTERY_CHARGER_DISCONNECTED
EVENT_VAL_BATTERY_CHARGER_CONNECTED
EVENT_VAL_BATTERY_CHARGER_CHARGING
EVENT_VAL_BATTERY_CHARGER_DISCHARGING
#define EVENT_KEY_BATTERY_LEVEL_STATUS   "battery_level_status"

Definition for key of SYSTEM_EVENT_BATTERY_LEVEL_STATUS.

Since :
2.4
See also:
EVENT_VAL_BATTERY_LEVEL_EMPTY
EVENT_VAL_BATTERY_LEVEL_CRITICAL
EVENT_VAL_BATTERY_LEVEL_LOW
EVENT_VAL_BATTERY_LEVEL_HIGH
EVENT_VAL_BATTERY_LEVEL_FULL
#define EVENT_KEY_BT_LE_STATE   "bt_le_state"

Definition for key of SYSTEM_EVENT_BT_STATE.

Since :
2.4
See also:
EVENT_VAL_BT_LE_OFF
EVENT_VAL_BT_LE_ON
#define EVENT_KEY_BT_STATE   "bt_state"

Definition for key of SYSTEM_EVENT_BT_STATE.

Since :
2.4
See also:
EVENT_VAL_BT_OFF
EVENT_VAL_BT_ON
#define EVENT_KEY_BT_TRANSFERING_STATE   "bt_transfering_state"

Definition for key of SYSTEM_EVENT_BT_STATE.

Since :
2.4
Remarks:
If it's already transferring state before you register this event, you can't receive the event regarding current transfer but you can receive the following transfers.
See also:
EVENT_VAL_BT_NON_TRANSFERING
EVENT_VAL_BT_TRANSFERING
#define EVENT_KEY_DATA_ROAMING_STATE   "data_roaming_state"

Definition for key of SYSTEM_EVENT_DATA_ROAMING_STATE.

Since :
2.4
See also:
EVENT_VAL_DATA_ROAMING_OFF
EVENT_VAL_DATA_ROAMING_ON
#define EVENT_KEY_DISPLAY_STATE   "display_state"

Definition for key of SYSTEM_EVENT_DISPLAY_STATE.

Since :
2.4
See also:
EVENT_VAL_DISPLAY_NORMAL
EVENT_VAL_DISPLAY_DIM
EVENT_VAL_DISPLAY_OFF
#define EVENT_KEY_EARJACK_STATUS   "earjack_status"

Definition for key of SYSTEM_EVENT_EARJACK_STATUS.

Since :
2.4
See also:
EVENT_VAL_EARJACK_DISCONNECTED
EVENT_VAL_EARJACK_CONNECTED
#define EVENT_KEY_FONT_SET   "font_set"

Definition for key of SYSTEM_EVENT_FONT_SET.

Since :
2.4
Remarks:
The value of this key is font name of string type by font-config.
#define EVENT_KEY_GPS_ENABLE_STATE   "gps_enable_state"

Definition for key of SYSTEM_EVENT_GPS_ENABLE_STATE.

Since :
2.4
See also:
EVENT_VAL_GPS_DISABLED
EVENT_VAL_GPS_ENABLED
#define EVENT_KEY_HOUR_FORMAT   "hour_format"

Definition for key of SYSTEM_EVENT_HOUR_FORMAT.

Since :
2.4
See also:
EVENT_VAL_HOURFORMAT_12
EVENT_VAL_HOURFORMAT_24
#define EVENT_KEY_LANGUAGE_SET   "language_set"

Definition for key of SYSTEM_EVENT_LANGUAGE_SET.

Since :
2.4
Remarks:
The value of this key is full name of locale, for example, "ko_KR.UTF8" : in case of Korean language "en_US.UTF8" : in case of USA language, refer to linux locale info.
#define EVENT_KEY_LOCATION_ENABLE_STATE   "location_enable_state"

Definition for key of SYSTEM_EVENT_LOCATION_ENABLE_STATE.

Since :
2.4
See also:
EVENT_VAL_LOCATION_DISABLED
EVENT_VAL_LOCATION_ENABLED
#define EVENT_KEY_LOW_MEMORY   "low_memory"

Definition for key of SYSTEM_EVENT_LOW_MEMORY.

Since :
2.4
Remarks:
If there is earlier occurrence regarding this event, you will receive the event as soon as you register event handler for this event. You can use this earlier event-data as initial value.
See also:
EVENT_VAL_MEMORY_NORMAL
EVENT_VAL_MEMORY_SOFT_WARNING
EVENT_VAL_MEMORY_HARD_WARNING
#define EVENT_KEY_MOBILE_DATA_STATE   "mobile_data_state"

Definition for key of SYSTEM_EVENT_MOBILE_DATA_STATE.

Since :
2.4
See also:
EVENT_VAL_MOBILE_DATA_OFF
EVENT_VAL_MOBILE_DATA_ON
#define EVENT_KEY_MSG_ID   "msg_id"

Definition for key of SYSTEM_EVENT_INCOMING_MSG.

Since :
2.4
Remarks:
The value of this key is a string of unsigned int value : new message id.
#define EVENT_KEY_MSG_TYPE   "msg_type"

Definition for key of SYSTEM_EVENT_INCOMING_MSG.

Since :
2.4
See also:
EVENT_VAL_SMS
EVENT_VAL_PUSH
EVENT_VAL_CB
#define EVENT_KEY_NETWORK_STATUS   "network_status"

Definition for key of SYSTEM_EVENT_NETWORK_STATUS.

Since :
3.0
Remarks:
The values of this event indicate the type of the current profile for data connection.
See also:
EVENT_VAL_NETWORK_DISCONNECTED
EVENT_VAL_NETWORK_WIFI
EVENT_VAL_NETWORK_CELLULAR
EVENT_VAL_NETWORK_ETHERNET
EVENT_VAL_NETWORK_BT
EVENT_VAL_NETWORK_NET_PROXY
#define EVENT_KEY_NPS_ENABLE_STATE   "nps_enable_state"

Definition for key of SYSTEM_EVENT_NPS_ENABLE_STATE.

Since :
2.4
See also:
EVENT_VAL_NPS_DISABLED
EVENT_VAL_NPS_ENABLED
#define EVENT_KEY_OUT_MSG_ID   "msg_id"

Definition for key of SYSTEM_EVENT_OUTGOING_MSG.

Since :
3.0
Remarks:
The value of this key is a string of unsigned int value : new message id.
#define EVENT_KEY_OUT_MSG_TYPE   "msg_type"

Definition for key of SYSTEM_EVENT_OUTGOING_MSG.

Since :
3.0
See also:
EVENT_VAL_OUT_MSG_SMS
EVENT_VAL_OUT_MSG_MMS
#define EVENT_KEY_REGION_FORMAT   "region_format"

Definition for key of SYSTEM_EVENT_REGION_FORMAT.

Since :
2.4
Remarks:
The value of this key is full name of locale, for example, "ko_KR.UTF8" : in case of Korean region format "en_US.UTF8" : in case of USA region format, refer to linux locale info.
#define EVENT_KEY_SCREEN_AUTOROTATE_STATE   "screen_autorotate_state"

Definition for key of SYSTEM_EVENT_SCREEN_AUTOROTATE_STATE.

Since :
2.4
See also:
EVENT_VAL_SCREEN_AUTOROTATE_ON
EVENT_VAL_SCREEN_AUTOROTATE_OFF
#define EVENT_KEY_SILENT_MODE   "silent_mode"

Definition for key of SYSTEM_EVENT_SILENT_MODE.

Since :
2.4
See also:
EVENT_VAL_SILENTMODE_ON
EVENT_VAL_SILENTMODE_OFF
#define EVENT_KEY_TIME_ZONE   "time_zone"

Definition for key of SYSTEM_EVENT_TIME_ZONE.

Since :
2.4
Remarks:
The value of this key is timezone value of tz database, for example, "Asia/Seoul", "America/New_York", refer to the Time Zone Database of IANA.
#define EVENT_KEY_USB_STATUS   "usb_status"

Definition for key of SYSTEM_EVENT_USB_STATUS.

Since :
2.4
See also:
EVENT_VAL_USB_DISCONNECTED
EVENT_VAL_USB_CONNECTED
EVENT_VAL_USB_AVAILABLE
#define EVENT_KEY_VIBRATION_STATE   "vibration_state"

Definition for key of SYSTEM_EVENT_VIBRATION_STATE.

Since :
2.4
See also:
EVENT_VAL_VIBRATION_ON
EVENT_VAL_VIBRATION_OFF
#define EVENT_KEY_WIFI_STATE   "wifi_state"

Definition for key of SYSTEM_EVENT_WIFI_STATE.

Since :
2.4
See also:
EVENT_VAL_WIFI_OFF
EVENT_VAL_WIFI_ON
EVENT_VAL_WIFI_CONNECTED
#define EVENT_VAL_BATTERY_CHARGER_CHARGING   "charging"

Definition for value of EVENT_KEY_BATTERY_CHARGER_STATUS.

Since :
2.4
Remarks:
charging is enabled
#define EVENT_VAL_BATTERY_CHARGER_CONNECTED   "connected"

Definition for value of EVENT_KEY_BATTERY_CHARGER_STATUS.

Since :
2.4
Remarks:
charger connected
#define EVENT_VAL_BATTERY_CHARGER_DISCHARGING   "discharging"

Definition for value of EVENT_KEY_BATTERY_CHARGER_STATUS.

Since :
2.4
Remarks:
charging is disabled
#define EVENT_VAL_BATTERY_CHARGER_DISCONNECTED   "disconnected"

Definition for value of EVENT_KEY_BATTERY_CHARGER_STATUS.

Since :
2.4
Remarks:
charger disconnected
#define EVENT_VAL_BATTERY_LEVEL_CRITICAL   "critical"

Definition for value of EVENT_KEY_BATTERY_LEVEL_STATUS.

Since :
2.4
#define EVENT_VAL_BATTERY_LEVEL_EMPTY   "empty"

Definition for value of EVENT_KEY_BATTERY_LEVEL_STATUS.

Since :
2.4
#define EVENT_VAL_BATTERY_LEVEL_FULL   "full"

Definition for value of EVENT_KEY_BATTERY_LEVEL_STATUS.

Since :
2.4
#define EVENT_VAL_BATTERY_LEVEL_HIGH   "high"

Definition for value of EVENT_KEY_BATTERY_LEVEL_STATUS.

Since :
2.4
#define EVENT_VAL_BATTERY_LEVEL_LOW   "low"

Definition for value of EVENT_KEY_BATTERY_LEVEL_STATUS.

Since :
2.4
#define EVENT_VAL_BT_LE_OFF   "off"

Definition for value of EVENT_KEY_BT_LE_STATE.

Since :
2.4
#define EVENT_VAL_BT_LE_ON   "on"

Definition for value of EVENT_KEY_BT_LE_STATE.

Since :
2.4
#define EVENT_VAL_BT_NON_TRANSFERING   "non_transfering"

Definition for value of EVENT_KEY_BT_TRANSFERING_STATE.

Since :
2.4
#define EVENT_VAL_BT_OFF   "off"

Definition for value of EVENT_KEY_BT_STATE.

Since :
2.4
#define EVENT_VAL_BT_ON   "on"

Definition for value of EVENT_KEY_BT_STATE.

Since :
2.4
#define EVENT_VAL_BT_TRANSFERING   "transfering"

Definition for value of EVENT_KEY_BT_TRANSFERING_STATE.

Since :
2.4
#define EVENT_VAL_CB   "cb"

Definition for value of EVENT_KEY_MSG_TYPE.

Since :
2.4
#define EVENT_VAL_DATA_ROAMING_OFF   "off"

Definition for value of EVENT_KEY_DATA_ROAMING_STATE.

Since :
2.4
#define EVENT_VAL_DATA_ROAMING_ON   "on"

Definition for value of EVENT_KEY_DATA_ROAMING_STATE.

Since :
2.4
#define EVENT_VAL_DISPLAY_DIM   "dim"

Definition for value of EVENT_KEY_DISPLAY_STATE.

Since :
2.4
#define EVENT_VAL_DISPLAY_NORMAL   "normal"

Definition for value of EVENT_KEY_DISPLAY_STATE.

Since :
2.4
#define EVENT_VAL_DISPLAY_OFF   "off"

Definition for value of EVENT_KEY_DISPLAY_STATE.

Since :
2.4
#define EVENT_VAL_EARJACK_CONNECTED   "connected"

Definition for value of EVENT_KEY_EARJACK_STATUS.

Since :
2.4
#define EVENT_VAL_EARJACK_DISCONNECTED   "disconnected"

Definition for value of EVENT_KEY_EARJACK_STATUS.

Since :
2.4
#define EVENT_VAL_GPS_DISABLED   "disabled"

Definition for value of EVENT_KEY_GPS_ENABLE_STATE.

Since :
2.4
#define EVENT_VAL_GPS_ENABLED   "enabled"

Definition for value of EVENT_KEY_GPS_ENABLE_STATE.

Since :
2.4
#define EVENT_VAL_HOURFORMAT_12   "12"

Definition for value of EVENT_KEY_HOUR_FORMAT.

Since :
2.4
#define EVENT_VAL_HOURFORMAT_24   "24"

Definition for value of EVENT_KEY_HOUR_FORMAT.

Since :
2.4
#define EVENT_VAL_LOCATION_DISABLED   "disabled"

Definition for value of EVENT_KEY_LOCATION_ENABLE_STATE.

Since :
2.4
#define EVENT_VAL_LOCATION_ENABLED   "enabled"

Definition for value of EVENT_KEY_LOCATION_ENABLE_STATE.

Since :
2.4
#define EVENT_VAL_MEMORY_HARD_WARNING   "hard_warning"

Definition for value of EVENT_KEY_LOW_MEMORY.

Since :
2.4
#define EVENT_VAL_MEMORY_NORMAL   "normal"

Definition for value of EVENT_KEY_LOW_MEMORY.

Since :
2.4
#define EVENT_VAL_MEMORY_SOFT_WARNING   "soft_warning"

Definition for value of EVENT_KEY_LOW_MEMORY.

Since :
2.4
#define EVENT_VAL_MMS   "mms"

Definition for value of EVENT_KEY_MSG_TYPE.

Since :
3.0
#define EVENT_VAL_MOBILE_DATA_OFF   "off"

Definition for value of EVENT_KEY_MOBILE_DATA_STATE.

Since :
2.4
#define EVENT_VAL_MOBILE_DATA_ON   "on"

Definition for value of EVENT_KEY_MOBILE_DATA_STATE.

Since :
2.4
#define EVENT_VAL_NETWORK_BT   "bt"

Definition for value of EVENT_KEY_NETWORK_STATUS.

Since :
3.0
#define EVENT_VAL_NETWORK_CELLULAR   "cellular"

Definition for value of EVENT_KEY_NETWORK_STATUS.

Since :
3.0
#define EVENT_VAL_NETWORK_DISCONNECTED   "disconnected"

Definition for value of EVENT_KEY_NETWORK_STATUS.

Since :
3.0
#define EVENT_VAL_NETWORK_ETHERNET   "ethernet"

Definition for value of EVENT_KEY_NETWORK_STATUS.

Since :
3.0
#define EVENT_VAL_NETWORK_NET_PROXY   "net_proxy"

Definition for value of EVENT_KEY_NETWORK_STATUS.

Since :
3.0
#define EVENT_VAL_NETWORK_WIFI   "wifi"

Definition for value of EVENT_KEY_NETWORK_STATUS.

Since :
3.0
#define EVENT_VAL_NPS_DISABLED   "disabled"

Definition for value of EVENT_KEY_NPS_ENABLE_STATE.

Since :
2.4
#define EVENT_VAL_NPS_ENABLED   "enabled"

Definition for value of EVENT_KEY_NPS_ENABLE_STATE.

Since :
2.4
#define EVENT_VAL_OUT_MSG_MMS   "mms"

Definition for value of EVENT_KEY_OUT_MSG_TYPE.

Since :
3.0
#define EVENT_VAL_OUT_MSG_SMS   "sms"

Definition for value of EVENT_KEY_OUT_MSG_TYPE.

Since :
3.0
#define EVENT_VAL_PUSH   "push"

Definition for value of EVENT_KEY_MSG_TYPE.

Since :
2.4
#define EVENT_VAL_SCREEN_AUTOROTATE_OFF   "off"

Definition for value of EVENT_KEY_SCREEN_AUTOROTATE_STATE.

Since :
2.4
#define EVENT_VAL_SCREEN_AUTOROTATE_ON   "on"

Definition for value of EVENT_KEY_SCREEN_AUTOROTATE_STATE.

Since :
2.4
#define EVENT_VAL_SILENTMODE_OFF   "off"

Definition for value of EVENT_KEY_SILENT_MODE.

Since :
2.4
#define EVENT_VAL_SILENTMODE_ON   "on"

Definition for value of EVENT_KEY_SILENT_MODE.

Since :
2.4
#define EVENT_VAL_SMS   "sms"

Definition for value of EVENT_KEY_MSG_TYPE.

Since :
2.4
#define EVENT_VAL_USB_AVAILABLE   "available"

Definition for value of EVENT_KEY_USB_STATUS.

Since :
2.4
#define EVENT_VAL_USB_CONNECTED   "connected"

Definition for value of EVENT_KEY_USB_STATUS.

Since :
2.4
Remarks:
Connected but not-available.
#define EVENT_VAL_USB_DISCONNECTED   "disconnected"

Definition for value of EVENT_KEY_USB_STATUS.

Since :
2.4
#define EVENT_VAL_VIBRATION_OFF   "off"

Definition for value of EVENT_KEY_VIBRATION_STATE.

Since :
2.4
#define EVENT_VAL_VIBRATION_ON   "on"

Definition for value of EVENT_KEY_VIBRATION_STATE.

Since :
2.4
#define EVENT_VAL_WIFI_CONNECTED   "connected"

Definition for value of EVENT_KEY_WIFI_STATE.

Since :
2.4
#define EVENT_VAL_WIFI_OFF   "off"

Definition for value of EVENT_KEY_WIFI_STATE.

Since :
2.4
#define EVENT_VAL_WIFI_ON   "on"

Definition for value of EVENT_KEY_WIFI_STATE.

Since :
2.4
#define SYSTEM_EVENT_BATTERY_CHARGER_STATUS   "tizen.system.event.battery_charger_status"

Definition for system-event of battery : charger status.

Since :
2.4
Remarks:
If there is earlier occurrence regarding this event, you will receive the event as soon as you register event handler for this event. You can use this earlier event-data as initial value.
See also:
EVENT_KEY_BATTERY_CHARGER_STATUS
#define SYSTEM_EVENT_BATTERY_LEVEL_STATUS   "tizen.system.event.battery_level_status"

Definition for system-event of battery : level status.

Since :
2.4
See also:
EVENT_KEY_BATTERY_LEVEL_STATUS
#define SYSTEM_EVENT_BOOT_COMPLETED   "tizen.system.event.boot_completed"

Definition for system-event of system : boot completion.

Since :
2.4
Remarks:
There is no corresponding key/value.
You can treat the initial value as "false" before you receive this event.
If it's already boot-completed state before you register event handler, you can receive the event as soon as you register the event handler.
#define SYSTEM_EVENT_BT_STATE   "tizen.system.event.bt_state"

Definition for system-event of bluetooth : status of bluetooth.

Since :
2.4
See also:
EVENT_KEY_BT_STATE
EVENT_KEY_BT_LE_STATE
EVENT_KEY_BT_TRANSFERING_STATE
#define SYSTEM_EVENT_DATA_ROAMING_STATE   "tizen.system.event.data_roaming_state"

Definition for system-event of setting : state of data roaming.

Since :
2.4
See also:
EVENT_KEY_DATA_ROAMING_STATE
#define SYSTEM_EVENT_DISPLAY_STATE   "tizen.system.event.display_state"

Definition for system-event of display : state of display.

Since :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/display
Remarks:
If you want to receive this event, you must declare this privilege.
See also:
EVENT_KEY_DISPLAY_STATE
#define SYSTEM_EVENT_EARJACK_STATUS   "tizen.system.event.earjack_status"

Definition for system-event of ear-jack : status of ear-jack connection.

Since :
2.4
See also:
EVENT_KEY_EARJACK_STATUS
#define SYSTEM_EVENT_FONT_SET   "tizen.system.event.font_set"

Definition for system-event of setting : font setting.

Since :
2.4
See also:
EVENT_KEY_FONT_SET
#define SYSTEM_EVENT_GPS_ENABLE_STATE   "tizen.system.event.gps_enable_state"

Definition for system-event of location : enable state of gps.

Since :
2.4
See also:
EVENT_KEY_GPS_ENABLE_STATE
#define SYSTEM_EVENT_HOUR_FORMAT   "tizen.system.event.hour_format"

Definition for system-event of setting : hour format.

Since :
2.4
See also:
EVENT_KEY_HOUR_FORMAT
#define SYSTEM_EVENT_INCOMING_MSG   "tizen.system.event.incoming_msg"

Definition for system-event of message : incoming msg.

Since :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/message.read
Remarks:
If you want to receive this event, you must declare this privilege.
See also:
EVENT_KEY_MSG_TYPE
EVENT_KEY_MSG_ID
#define SYSTEM_EVENT_LANGUAGE_SET   "tizen.system.event.language_set"

Definition for system-event of setting : language setting.

Since :
2.4
See also:
EVENT_KEY_LANGUAGE_SET
#define SYSTEM_EVENT_LOCATION_ENABLE_STATE   "tizen.system.event.location_enable_state"

Definition for system-event of location : enable state of location.

Since :
2.4
See also:
EVENT_KEY_LOCATION_ENABLE_STATE
#define SYSTEM_EVENT_LOW_MEMORY   "tizen.system.event.low_memory"

Definition for system-event of system : low memory.

Since :
2.4
See also:
EVENT_KEY_LOW_MEMORY
#define SYSTEM_EVENT_MOBILE_DATA_STATE   "tizen.system.event.mobile_data_state"

Definition for system-event of setting : state of mobile data.

Since :
2.4
See also:
EVENT_KEY_MOBILE_DATA_STATE
#define SYSTEM_EVENT_NETWORK_STATUS   "tizen.system.event.network_status"

Definition for system-event of network : status of network.

Since :
3.0
See also:
EVENT_KEY_NETWORK_STATUS
#define SYSTEM_EVENT_NPS_ENABLE_STATE   "tizen.system.event.nps_enable_state"

Definition for system-event of location : enable state of nps.

Since :
2.4
See also:
EVENT_KEY_NPS_ENABLE_STATE
#define SYSTEM_EVENT_OUTGOING_MSG   "tizen.system.event.outgoing_msg"

Definition for system-event of message : outgoing msg.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/message.read
Remarks:
If you want to receive this event, you must declare this privilege.
See also:
EVENT_KEY_OUT_MSG_TYPE
EVENT_KEY_OUT_MSG_ID
#define SYSTEM_EVENT_REGION_FORMAT   "tizen.system.event.region_format"

Definition for system-event of setting : region format.

Since :
2.4
See also:
EVENT_KEY_REGION_FORMAT
#define SYSTEM_EVENT_SCREEN_AUTOROTATE_STATE   "tizen.system.event.screen_autorotate_state"

Definition for system-event of setting : state of screen's auto-rotation.

Since :
2.4
See also:
EVENT_KEY_SCREEN_AUTOROTATE_STATE
#define SYSTEM_EVENT_SILENT_MODE   "tizen.system.event.silent_mode"

Definition for system-event of setting : silent_mode.

Since :
2.4
See also:
EVENT_KEY_SILENT_MODE
#define SYSTEM_EVENT_SYSTEM_SHUTDOWN   "tizen.system.event.system_shutdown"

Definition for system-event of system : shutdown.

Since :
2.4
Remarks:
There is no corresponding key/value.
You can treat the initial value as "false" before you receive this event.
If it's already shutting-down state before you register event handler, you can receive the event as soon as you register the event handler.
#define SYSTEM_EVENT_TIME_CHANGED   "tizen.system.event.time_changed"

Definition for system-event of setting : time changed.

Since :
2.4
Remarks:
There is no corresponding key/value.
You can use a alarm_get_current_time() API for checking new time after receiving this event.
#define SYSTEM_EVENT_TIME_ZONE   "tizen.system.event.time_zone"

Definition for system-event of setting : timezone setting.

Since :
2.4
See also:
EVENT_KEY_TIME_ZONE
#define SYSTEM_EVENT_USB_STATUS   "tizen.system.event.usb_status"

Definition for system-event of USB : status of USB connection.

Since :
2.4
See also:
EVENT_KEY_USB_STATUS
#define SYSTEM_EVENT_VIBRATION_STATE   "tizen.system.event.vibration_state"

Definition for system-event of setting : state of vibration.

Since :
2.4
See also:
EVENT_KEY_VIBRATION_STATE
#define SYSTEM_EVENT_WIFI_STATE   "tizen.system.event.wifi_state"

Definition for system-event of wifi : state of wifi.

Since :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.get
Remarks:
If you want to receive this event, you must declare this privilege.
See also:
EVENT_KEY_WIFI_STATE

Typedef Documentation

typedef void(* event_cb)(const char *event_name, bundle *event_data, void *user_data)

Event callback.

Since :
2.4
Parameters:
[in]event_nameThe interested event name
[in]event_dataThe data of interested event
[in]user_dataThe user data set by event_add_event_handler()
See also:
event_add_event_handler()
typedef struct event_handler* event_handler_h

Event handle.

Since :
2.4

Enumeration Type Documentation

enum event_error_e

Enumeration for Event Error.

Since :
2.4
Enumerator:
EVENT_ERROR_NONE 

Successful

EVENT_ERROR_INVALID_PARAMETER 

Invalid parameter

EVENT_ERROR_OUT_OF_MEMORY 

Out of memory

EVENT_ERROR_TIMED_OUT 

Time out

EVENT_ERROR_IO_ERROR 

IO error

EVENT_ERROR_PERMISSION_DENIED 

Permission denied

Function Documentation

int event_add_event_handler ( const char *  event_name,
event_cb  callback,
void *  user_data,
event_handler_h *  event_handler 
)

Adds the event handler for receiving event-data of interested events.

Since :
2.4
Remarks:
If you want to add the privileged event, you MUST declare right privilege first. Unless that, this function returns EVENT_ERROR_PERMISSION_DENIED. The privileged events are commented on remarks of it's definitions.
Parameters:
[in]event_nameThe interested event name
[in]callbackThe event callback called when the event occurs
[in]user_dataThe user data for passing to callback
[out]event_handlerThe event handler
Returns:
0 on success, otherwise a negative error value
Return values:
EVENT_ERROR_NONESuccessful
EVENT_ERROR_PERMISSION_DENIEDPermission denied
EVENT_ERROR_INVALID_PARAMETERInvalid parameter
EVENT_ERROR_IO_ERRORAdding handler failed
EVENT_ERROR_OUT_OF_MEMORYOut of memory
int event_keep_last_event_data ( const char *  event_name)

Keeps last User-Event data for receiver applications.

Since :
3.0
Remarks:
The receiver applications will receive this last event data after adding their new handlers via event_add_event_handler() since the sender application called this function.
If a sender application sends same event via trusted API and non-trusted API, then a trusted receiver will get latest data regardless of trusted or non-trusted, but non-trusted receiver will get the last data only from non-trusted API.
The effect of this function continues during runtime. That means when the sender application process restarts, the sender application needs to call this function again to make the event to keep the last event.
Parameters:
[in]event_nameThe event's name to keep last event data
Returns:
0 on success, otherwise a negative error value
Return values:
EVENT_ERROR_NONESuccessful
EVENT_ERROR_INVALID_PARAMETERInvalid parameter
EVENT_ERROR_IO_ERRORSending operation failed
EVENT_ERROR_OUT_OF_MEMORYOut of memory
int event_publish_app_event ( const char *  event_name,
bundle *  event_data 
)

Sends the User-Event to receiver applications.

Since :
2.4
Remarks:
The format of User-Event's name MUST be "event.{sender's appid}.{user-defined name}", refer to 'The name-format of User-Event' section, If the event_name is invalid, the function returns EVENT_ERROR_IO_ERROR.
Parameters:
[in]event_nameThe event's name to send
[in]event_dataThe event's data to send
Returns:
0 on success, otherwise a negative error value
Return values:
EVENT_ERROR_NONESuccessful
EVENT_ERROR_INVALID_PARAMETERInvalid parameter
EVENT_ERROR_IO_ERRORSending operation failed
int event_publish_trusted_app_event ( const char *  event_name,
bundle *  event_data 
)

Sends the User-Event to trusted receiver-applications.

Since :
2.4
Remarks:
The application which has same certification with sender can receive the event.
The format of User-Event's name MUST be "event.{sender's appid}.{user-defined name}", refer to 'The name-format of User-Event' section, If the event_name is invalid, the function returns EVENT_ERROR_IO_ERROR.
Parameters:
[in]event_nameThe event's name to send
[in]event_dataThe event's data to send
Returns:
0 on success, otherwise a negative error value
Return values:
EVENT_ERROR_NONESuccessful
EVENT_ERROR_INVALID_PARAMETERInvalid parameter
EVENT_ERROR_IO_ERRORSending operation failed
int event_remove_event_handler ( event_handler_h  event_handler)

Removes the registered event handler.

Since :
2.4
Parameters:
[in]event_handlerThe event handler
Returns:
0 on success, otherwise a negative error value
Return values:
EVENT_ERROR_NONESuccessful
EVENT_ERROR_INVALID_PARAMETERInvalid parameter