Tizen Native API  9.0
Functions | Typedefs
System Settings
System

The System Settings API provides APIs for sharing configuration over a system. system_settings_key_e shows all of the supporting APIs in System-Settings.

Required Header

#include <system_settings.h>

Overview

System Settings API provides functions for getting the system configuration related to user preferences. The main features of the System Settings API include accessing system-wide configurations, such as ringtones, wallpapers, and etc.

Related Features

This API is related with the following features:

  • http://tizen.org/feature/systemsetting
  • http://tizen.org/feature/systemsetting.home_screen
  • http://tizen.org/feature/systemsetting.lock_screen
  • http://tizen.org/feature/systemsetting.incoming_call
  • http://tizen.org/feature/systemsetting.notification_email
  • http://tizen.org/feature/systemsetting.font
  • http://tizen.org/feature/network.wifi
  • http://tizen.org/feature/network.ethernet
  • http://tizen.org/feature/network.telephony
  • http://tizen.org/feature/accessibility.grayscale
  • http://tizen.org/feature/accessibility.negative

It is recommended to design feature related codes in your application for reliability.

You can check if a device supports the related features for this API by using System Information,thereby controlling the procedure of your application.

To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.

More details on featuring your application can be found from Feature Element.

The table below shows additional related features on which System Settings keys depend.

Additional Related Feature System-Settings Keys
http://tizen.org/feature/systemsetting.home_screen SYSTEM_SETTINGS_KEY_WALLPAPER_HOME_SCREEN
http://tizen.org/feature/systemsetting.lock_screen SYSTEM_SETTINGS_KEY_WALLPAPER_LOCK_SCREEN
SYSTEM_SETTINGS_KEY_LOCKSCREEN_APP
http://tizen.org/feature/systemsetting.incoming_call SYSTEM_SETTINGS_KEY_INCOMING_CALL_RINGTONE
SYSTEM_SETTINGS_KEY_SOUND_NOTIFICATION
http://tizen.org/feature/systemsetting.notification_email SYSTEM_SETTINGS_KEY_EMAIL_ALERT_RINGTONE
http://tizen.org/feature/systemsetting.font SYSTEM_SETTINGS_KEY_DEFAULT_FONT_TYPE
SYSTEM_SETTINGS_KEY_FONT_TYPE
SYSTEM_SETTINGS_KEY_FONT_SIZE
http://tizen.org/feature/network.wifi SYSTEM_SETTINGS_KEY_NETWORK_WIFI_NOTIFICATION
http://tizen.org/feature/network.telephony SYSTEM_SETTINGS_KEY_ULTRA_DATA_SAVE
SYSTEM_SETTINGS_KEY_ULTRA_DATA_SAVE_PKG_LIST
http://tizen.org/feature/network.wifi ||
http://tizen.org/feature/network.telephony ||
http://tizen.org/feature/network.ethernet 		SYSTEM_SETTINGS_KEY_AUTOMATIC_TIME_UPDATE
http://tizen.org/feature/accessibility.grayscale SYSTEM_SETTINGS_KEY_ACCESSIBILITY_GRAYSCALE
http://tizen.org/feature/accessibility.negative SYSTEM_SETTINGS_KEY_ACCESSIBILITY_NEGATIVE_COLOR
http://tizen.org/feature/input.rotating_bezel SYSTEM_SETTINGS_KEY_ROTARY_EVENT_ENABLED
http://tizen.org/feature/profile == "wearable"

Functions

int system_settings_set_value_int (system_settings_key_e key, int value)
 Sets the system settings value associated with the given key as an integer.
int system_settings_get_value_int (system_settings_key_e key, int *value)
 Gets the system settings value associated with the given key as an integer.
int system_settings_set_value_bool (system_settings_key_e key, bool value)
 Sets the system settings value associated with the given key as a boolean.
int system_settings_get_value_bool (system_settings_key_e key, bool *value)
 Gets the system settings value associated with the given key as a boolean.
int system_settings_set_value_string (system_settings_key_e key, const char *value)
 Sets the system settings value associated with the given key as a string.
int system_settings_get_value_string (system_settings_key_e key, char **value)
 Gets the system settings value associated with the given key as a string.
int system_settings_set_changed_cb (system_settings_key_e key, system_settings_changed_cb callback, void *user_data)
 Sets a change event callback for the given system settings key.
int system_settings_unset_changed_cb (system_settings_key_e key)
 Unsets the callback function.
int system_settings_foreach_value_string (system_settings_key_e key, system_settings_iter_cb callback, void *user_data)
 Iterate the system settings value associated with the given key as a string type.
int system_settings_add_value_string (system_settings_key_e key, const char *value)
 Adds the system settings value associated with the given key as a string type if it supports List iteration.
int system_settings_delete_value_string (system_settings_key_e key, const char *value)
 Delete the system settings value associated with the given key as an string type if it supports List iteration.
int system_settings_add_changed_cb (system_settings_key_e key, system_settings_changed_cb callback, void *user_data)
 Adds a change event callback for the given system settings key.
int system_settings_remove_changed_cb (system_settings_key_e key, system_settings_changed_cb callback)
 Removes a change event callback function.

Typedefs

typedef void(* system_settings_changed_cb )(system_settings_key_e key, void *user_data)
 Called when the system settings changes.
typedef bool(* system_settings_iter_cb )(int index, const char *value, void *cb_data)
 Called to get each string value from string typed list.

Typedef Documentation

typedef void(* system_settings_changed_cb)(system_settings_key_e key, void *user_data)

Called when the system settings changes.

Since :
2.3
Parameters:
[in]keyThe key name of the system settings changed system settings
[in]user_dataThe user data passed from the callback registration function
Precondition:
system_settings_set_changed_cb() will invoke this callback function.
See also:
system_settings_set_changed_cb()
system_settings_unset_changed_cb()
typedef bool(* system_settings_iter_cb)(int index, const char *value, void *cb_data)

Called to get each string value from string typed list.

Warning:
This is not for use by third-party applications.

This callback is used in system_settings_foreach_value_string(). Through this callback, the stored string list is passed one by one.

Since :
3.0
Parameters:
[in]indexzero based number indicating index of node in a list
[in]valuevalue returned from the list
[in]cb_dataThe user data passed from the foreach function
Returns:
true to continue with the next iteration of the loop, otherwise false to break out of the loop

Enumeration Type Documentation

enum system_settings_error_e

Enumeration for system settings error.

Since :
2.3
Enumerator:
SYSTEM_SETTINGS_ERROR_NONE 

Successful

SYSTEM_SETTINGS_ERROR_INVALID_PARAMETER 

Invalid parameter

SYSTEM_SETTINGS_ERROR_OUT_OF_MEMORY 

Out of memory

SYSTEM_SETTINGS_ERROR_IO_ERROR 

Internal I/O error

SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED 

Permission denied

SYSTEM_SETTINGS_ERROR_NOT_SUPPORTED 

Not supported (Since 2.3.1)

SYSTEM_SETTINGS_ERROR_CALL_UNSUPPORTED_API 

Not supported (Since 2.3.1)

SYSTEM_SETTINGS_ERROR_LOCKSCREEN_APP_PASSWORD_MODE 

Current lock screen app set 'password' type

enum system_settings_font_size_e

Enumeration for font size.

Since :
2.3
Enumerator:
SYSTEM_SETTINGS_FONT_SIZE_SMALL 

A small size

SYSTEM_SETTINGS_FONT_SIZE_NORMAL 

A normal size

SYSTEM_SETTINGS_FONT_SIZE_LARGE 

A large size

SYSTEM_SETTINGS_FONT_SIZE_HUGE 

A huge size

SYSTEM_SETTINGS_FONT_SIZE_GIANT 

A giant size

enum system_settings_idle_lock_state_e

Enumeration for Idle Lock State.

Since :
2.3.1
Enumerator:
SYSTEM_SETTINGS_LOCK_STATE_UNLOCK 

Device is unlocked

SYSTEM_SETTINGS_LOCK_STATE_LOCK 

Device is locked

SYSTEM_SETTINGS_LOCK_STATE_LAUNCHING_LOCK 

Device is being locked

enum system_settings_key_e

Enumeration for System Settings Key.

Since :
2.3
Enumerator:
SYSTEM_SETTINGS_KEY_INCOMING_CALL_RINGTONE 

(string) The file path of the current ringtone

SYSTEM_SETTINGS_KEY_WALLPAPER_HOME_SCREEN 

(string) The file path of the current home screen wallpaper

SYSTEM_SETTINGS_KEY_WALLPAPER_LOCK_SCREEN 

(string) The file path of the current lock screen wallpaper

SYSTEM_SETTINGS_KEY_FONT_SIZE 

(int) The current system font size

SYSTEM_SETTINGS_KEY_FONT_TYPE 

(string) The current system font type

SYSTEM_SETTINGS_KEY_MOTION_ACTIVATION 

(bool) Indicates whether the motion service is activated

SYSTEM_SETTINGS_KEY_EMAIL_ALERT_RINGTONE 

(string) The file path of the current email alert ringtone

SYSTEM_SETTINGS_KEY_USB_DEBUGGING_ENABLED 

(bool) Indicates whether the USB debugging is enabled (Since 2.4)

SYSTEM_SETTINGS_KEY_3G_DATA_NETWORK_ENABLED 

(bool) Indicates whether the 3G data network is enabled (Since 2.4)

SYSTEM_SETTINGS_KEY_LOCKSCREEN_APP 

(string) Indicates lockscreen app pkg name

SYSTEM_SETTINGS_KEY_DEFAULT_FONT_TYPE 

(string) The current system default font type (only support Get)

SYSTEM_SETTINGS_KEY_LOCALE_COUNTRY 

(string) Indicates the current country setting in the <LANGUAGE>_<REGION> syntax. The country setting is in the ISO 639-2 format, and the region setting is in the ISO 3166-1 alpha-2 format

SYSTEM_SETTINGS_KEY_LOCALE_LANGUAGE 

(string) Indicates the current language setting in the <LANGUAGE>_<REGION> syntax. The language setting is in the ISO 639-2 format and the region setting is in the ISO 3166-1 alpha-2 format.

SYSTEM_SETTINGS_KEY_LOCALE_TIMEFORMAT_24HOUR 

(bool) Indicates whether the 24-hour clock is used. If the value is false, the 12-hour clock is used.

SYSTEM_SETTINGS_KEY_LOCALE_TIMEZONE 

(string) Indicates the current time zone.

SYSTEM_SETTINGS_KEY_TIME_CHANGED 

(int) Once System changes time, this event occurs to notify time change.

SYSTEM_SETTINGS_KEY_SOUND_LOCK 

GET (bool) Indicates whether the screen lock sound is enabled on the device. ex) LCD on/off sound

SYSTEM_SETTINGS_KEY_SOUND_SILENT_MODE 

GET (bool) Indicates whether the device is in the silent mode.

SYSTEM_SETTINGS_KEY_SOUND_TOUCH 

GET (bool) Indicates whether the screen touch sound is enabled on the device.

SYSTEM_SETTINGS_KEY_DISPLAY_SCREEN_ROTATION_AUTO 

GET (bool) Indicates whether rotation control is automatic.

SYSTEM_SETTINGS_KEY_DEVICE_NAME 

GET (string) Indicates device name.

SYSTEM_SETTINGS_KEY_MOTION_ENABLED 

GET (bool) Indicates whether the device user has enabled the motion feature.

SYSTEM_SETTINGS_KEY_NETWORK_WIFI_NOTIFICATION 

GET (bool) Indicates whether Wi-Fi-related notifications are enabled on the device.

SYSTEM_SETTINGS_KEY_NETWORK_FLIGHT_MODE 

GET (bool) Indicates whether the device is in the flight mode.

SYSTEM_SETTINGS_KEY_SCREEN_BACKLIGHT_TIME 

(int) Indicates the backlight time (in seconds).

SYSTEM_SETTINGS_KEY_SOUND_NOTIFICATION 

(string) Indicates the file path of the current notification tone set by the user.

SYSTEM_SETTINGS_KEY_SOUND_NOTIFICATION_REPETITION_PERIOD 

(int) Indicates the time period for notification repetitions.

SYSTEM_SETTINGS_KEY_LOCK_STATE 

(int) Indicates the current lock state

SYSTEM_SETTINGS_KEY_ADS_ID 

(string) Indicates Ads ID for each device (Since 3.0)

SYSTEM_SETTINGS_KEY_ULTRA_DATA_SAVE 

(int) Indicates Ultra Data Save status, one of system_settings_uds_state_e values (Since 4.0)

SYSTEM_SETTINGS_KEY_ULTRA_DATA_SAVE_PKG_LIST 

(string) Indicates Ultra Data Save Package List (Since 4.0), the list is a string containing whitelisted package names separated with semicolons (;)

SYSTEM_SETTINGS_KEY_ACCESSIBILITY_TTS 

GET (bool) Indicates whether the accessibility TTS is enabled on the device. (Since 4.0)

SYSTEM_SETTINGS_KEY_VIBRATION 

(bool) Indicates whether vibration is enabled on the device. (Since 4.0)

SYSTEM_SETTINGS_KEY_AUTOMATIC_TIME_UPDATE 

(bool) Indicates whether updating time automatically is enabled on the device. (Since 5.0)

SYSTEM_SETTINGS_KEY_DEVELOPER_OPTION_STATE 

(bool) Indicates whether developer option state is enabled on the device. (Since 5.0)

SYSTEM_SETTINGS_KEY_ACCESSIBILITY_GRAYSCALE 

(bool) Indicates whether accessibility grayscale is enabled on the device. (Since 5.5)

SYSTEM_SETTINGS_KEY_ACCESSIBILITY_NEGATIVE_COLOR 

(bool) Indicates whether accessibility negative color is enabled on the device. (Since 5.5)

SYSTEM_SETTINGS_KEY_ROTARY_EVENT_ENABLED 

(bool) Indicates whether rotary event is enabled on the device. (Since 5.5)

SYSTEM_SETTINGS_KEY_MAX 

max of system settings key

enum system_settings_uds_state_e

Enumeration for Ultra Data Save.

Since :
4.0
Enumerator:
SYSTEM_SETTINGS_UDS_OFF 

OFF

SYSTEM_SETTINGS_UDS_ON 

ON

SYSTEM_SETTINGS_UDS_ON_WHITELISTED 

UDS on and the app is whitelisted

Function Documentation

int system_settings_add_changed_cb ( system_settings_key_e  key,
system_settings_changed_cb  callback,
void *  user_data 
)

Adds a change event callback for the given system settings key.

The difference between this function and system_settings_set_changed_cb() is that system_settings_set_changed_cb() can set only one callback for a given key, while system_settings_add_changed_cb() can set multiple callbacks for a given key.

Since :
5.0
Remarks:
The key cannot be SYSTEM_SETTINGS_KEY_DEFAULT_FONT_TYPE. When the feature related to the key is not supported on the device, SYSTEM_SETTINGS_ERROR_NOT_SUPPORTED will be returned.
Parameters:
[in]keyThe key name of the system settings
[in]callbackThe callback function to invoke
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
SYSTEM_SETTINGS_ERROR_NONESuccessful
SYSTEM_SETTINGS_ERROR_NOT_SUPPORTEDThe related feature is not supported on the device
SYSTEM_SETTINGS_ERROR_INVALID_PARAMETERInvalid parameter
Postcondition:
system_settings_changed_cb() will be invoked.
See also:
system_settings_remove_changed_cb()
system_settings_changed_cb()
int system_settings_add_value_string ( system_settings_key_e  key,
const char *  value 
)

Adds the system settings value associated with the given key as a string type if it supports List iteration.

Warning:
This is not for use by third-party applications.

This function is used to add the path of the ringtone when using a KEY such as SYSTEM_SETTINGS_KEY_INCOMING_CALL_RINGTONE.

Since :
3.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/systemsettings.admin
Remarks:
When the feature related to the key is not supported on the device, SYSTEM_SETTINGS_ERROR_NOT_SUPPORTED will be returned.
Parameters:
[in]keyThe key name of the system settings
[in]valuestring typed value to be appended
Returns:
0 on success, otherwise a negative error value
Return values:
SYSTEM_SETTINGS_ERROR_NONESuccessful
SYSTEM_SETTINGS_ERROR_NOT_SUPPORTEDThe related feature is not supported on the device
SYSTEM_SETTINGS_ERROR_PERMISSION_DENIEDPermission violation error
SYSTEM_SETTINGS_ERROR_INVALID_PARAMETERInvalid parameter
SYSTEM_SETTINGS_ERROR_IO_ERRORInternal I/O error
int system_settings_delete_value_string ( system_settings_key_e  key,
const char *  value 
)

Delete the system settings value associated with the given key as an string type if it supports List iteration.

Warning:
This is not for use by third-party applications.

This function is used to delete the path of the ringtone when using a KEY such as SYSTEM_SETTINGS_KEY_INCOMING_CALL_RINGTONE.

Since :
3.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/systemsettings.admin
Remarks:
When the feature related to the key is not supported on the device, SYSTEM_SETTINGS_ERROR_NOT_SUPPORTED will be returned.
Parameters:
[in]keyThe key name of the system settings
[in]valuestring typed value to be removed
Returns:
0 on success, otherwise a negative error value
Return values:
SYSTEM_SETTINGS_ERROR_NONESuccessful
SYSTEM_SETTINGS_ERROR_NOT_SUPPORTEDThe related feature is not supported on the device
SYSTEM_SETTINGS_ERROR_PERMISSION_DENIEDPermission violation error
SYSTEM_SETTINGS_ERROR_INVALID_PARAMETERInvalid parameter
SYSTEM_SETTINGS_ERROR_IO_ERRORInternal I/O error
int system_settings_foreach_value_string ( system_settings_key_e  key,
system_settings_iter_cb  callback,
void *  user_data 
)

Iterate the system settings value associated with the given key as a string type.

Warning:
This is not for use by third-party applications.

This function is used to pass the path list of ringtones one by one through a callback when using SYSTEM_SETTINGS_KEY_INCOMING_CALL_RINGTONE.

Since :
3.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/systemsettings.admin
Remarks:
When the feature related to the key is not supported on the device, SYSTEM_SETTINGS_ERROR_NOT_SUPPORTED will be returned.
Parameters:
[in]keyThe key name of the system settings
[in]callbackThe callback-function name for iteration
[in]user_dataThe user data passed from caller-side
Returns:
0 on success, otherwise a negative error value
Return values:
SYSTEM_SETTINGS_ERROR_NONESuccessful
SYSTEM_SETTINGS_ERROR_NOT_SUPPORTEDThe related feature is not supported on the device
SYSTEM_SETTINGS_ERROR_PERMISSION_DENIEDPermission violation error
SYSTEM_SETTINGS_ERROR_INVALID_PARAMETERInvalid parameter
SYSTEM_SETTINGS_ERROR_IO_ERRORInternal I/O error
int system_settings_get_value_bool ( system_settings_key_e  key,
bool *  value 
)

Gets the system settings value associated with the given key as a boolean.

This API is used to get the bool value set for a key with a bool type value in System Settings APIs. When using this function, be careful not to include keys of other types (such as string or int) as parameters

Since :
2.3
Remarks:
When the feature related to the key is not supported on the device, SYSTEM_SETTINGS_ERROR_NOT_SUPPORTED will be returned.
Parameters:
[in]keyThe key name of the system settings
[out]valueThe current system settings value of the given key
Returns:
0 on success, otherwise a negative error value
Return values:
SYSTEM_SETTINGS_ERROR_NONESuccessful
SYSTEM_SETTINGS_ERROR_NOT_SUPPORTEDThe related feature is not supported on the device
SYSTEM_SETTINGS_ERROR_PERMISSION_DENIEDPermission violation error
SYSTEM_SETTINGS_ERROR_INVALID_PARAMETERInvalid parameter
SYSTEM_SETTINGS_ERROR_IO_ERRORInternal I/O error
Warning:
http://tizen.org/privilege/systemsettings (public level privilege) MUST NOT be declared to use this function since 2.3.1.
int system_settings_get_value_int ( system_settings_key_e  key,
int *  value 
)

Gets the system settings value associated with the given key as an integer.

This API is used to get the int value set for a key with an int type value in System Settings APIs. When using this function, be careful not to include keys of other types (such as string or bool) as parameters

Since :
2.3
Remarks:
When the feature related to the key is not supported on the device, SYSTEM_SETTINGS_ERROR_NOT_SUPPORTED will be returned.
Parameters:
[in]keyThe key name of the system settings
[out]valueThe current system settings value of the given key
Returns:
0 on success, otherwise a negative error value
Return values:
SYSTEM_SETTINGS_ERROR_NONESuccessful
SYSTEM_SETTINGS_ERROR_NOT_SUPPORTEDThe related feature is not supported on the device
SYSTEM_SETTINGS_ERROR_PERMISSION_DENIEDPermission violation error
SYSTEM_SETTINGS_ERROR_INVALID_PARAMETERInvalid parameter
SYSTEM_SETTINGS_ERROR_IO_ERRORInternal I/O error
Warning:
http://tizen.org/privilege/systemsettings (public level privilege) MUST NOT be declared to use this function since 2.3.1.
int system_settings_get_value_string ( system_settings_key_e  key,
char **  value 
)

Gets the system settings value associated with the given key as a string.

This API is used to get the string value set for a string key in System Settings APIs. When using this function, be careful not to include keys of other types (such as int or bool) as parameters

Since :
2.3
Remarks:
You must release value using free(). When the feature related to the key is not supported on the device, SYSTEM_SETTINGS_ERROR_NOT_SUPPORTED will be returned.
Parameters:
[in]keyThe key name of the system settings
[out]valueThe current system settings value of the given key
Returns:
0 on success, otherwise a negative error value
Return values:
SYSTEM_SETTINGS_ERROR_NONESuccessful
SYSTEM_SETTINGS_ERROR_NOT_SUPPORTEDThe related feature is not supported on the device
SYSTEM_SETTINGS_ERROR_PERMISSION_DENIEDPermission violation error
SYSTEM_SETTINGS_ERROR_INVALID_PARAMETERInvalid parameter
SYSTEM_SETTINGS_ERROR_IO_ERRORInternal I/O error 
  char *value = NULL;
  int retcode = system_settings_get_value_string(SYSTEM_SETTINGS_KEY_LOCALE_COUNTRY, &value);
  if (retcode == SYSTEM_SETTINGS_ERROR_NONE) {
    printf("%s", value);
    free(value);
  }
Warning:
http://tizen.org/privilege/systemsettings (public level privilege) MUST NOT be declared to use this function since 2.3.1.
int system_settings_remove_changed_cb ( system_settings_key_e  key,
system_settings_changed_cb  callback 
)

Removes a change event callback function.

The difference between this function and system_settings_unset_changed_cb() is that system_settings_unset_changed_cb() unsets the callback set with system_settings_set_changed_cb(), while system_settings_remove_changed_cb() removes callbacks added with system_settings_add_changed_cb()

Since :
5.0
Remarks:
The key cannot be SYSTEM_SETTINGS_KEY_DEFAULT_FONT_TYPE. When the feature related to the key is not supported on the device, SYSTEM_SETTINGS_ERROR_NOT_SUPPORTED will be returned.
Parameters:
[in]keyThe key name of the system settings
[in]callbackThe callback function to be removed
Returns:
0 on success, otherwise a negative error value
Return values:
SYSTEM_SETTINGS_ERROR_NONESuccessful
SYSTEM_SETTINGS_ERROR_NOT_SUPPORTEDThe related feature is not supported on the device
SYSTEM_SETTINGS_ERROR_INVALID_PARAMETERInvalid parameter
See also:
system_settings_add_changed_cb()
int system_settings_set_changed_cb ( system_settings_key_e  key,
system_settings_changed_cb  callback,
void *  user_data 
)

Sets a change event callback for the given system settings key.

This function is used to specify a callback function that is called when a key value changes. Each key can have only one callback function specified. To release this callback function, you can use the system_settings_unset_changed_cb() function

Since :
2.3
Remarks:
SYSTEM_SETTINGS_KEY_DEFAULT_FONT_TYPE is not available for set_changed_cb. When the feature related to the key is not supported on the device, SYSTEM_SETTINGS_ERROR_NOT_SUPPORTED will be returned.
Parameters:
[in]keyThe key name of the system settings
[in]callbackThe callback function to invoke
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
SYSTEM_SETTINGS_ERROR_NONESuccessful
SYSTEM_SETTINGS_ERROR_NOT_SUPPORTEDThe related feature is not supported on the device
SYSTEM_SETTINGS_ERROR_PERMISSION_DENIEDPermission violation error
SYSTEM_SETTINGS_ERROR_INVALID_PARAMETERInvalid parameter
Postcondition:
system_settings_changed_cb() will be invoked.
See also:
system_settings_unset_changed_cb()
system_settings_changed_cb()
Warning:
http://tizen.org/privilege/systemsettings (public level privilege) MUST NOT be declared to use this function since 2.3.1.
int system_settings_set_value_bool ( system_settings_key_e  key,
bool  value 
)

Sets the system settings value associated with the given key as a boolean.

Warning:
This is not for use by third-party applications.

This API is used to set a bool value for a key with a bool type value in System Settings APIs. When using this function, be careful not to include keys of other types (such as string or int) as parameters.

Since :
2.3
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/systemsettings.admin
Remarks:
When the feature related to the key is not supported on the device, SYSTEM_SETTINGS_ERROR_NOT_SUPPORTED will be returned.
Parameters:
[in]keyThe key name of the system settings
[out]valueThe new system settings value of the given key
Returns:
0 on success, otherwise a negative error value
Return values:
SYSTEM_SETTINGS_ERROR_NONESuccessful
SYSTEM_SETTINGS_ERROR_NOT_SUPPORTEDThe related feature is not supported on the device
SYSTEM_SETTINGS_ERROR_PERMISSION_DENIEDPermission violation error
SYSTEM_SETTINGS_ERROR_INVALID_PARAMETERInvalid parameter
SYSTEM_SETTINGS_ERROR_IO_ERRORInternal I/O error
int system_settings_set_value_int ( system_settings_key_e  key,
int  value 
)

Sets the system settings value associated with the given key as an integer.

Warning:
This is not for use by third-party applications.

This API is used to set an int value for a key with an int type value in System Settings APIs. When using this function, be careful not to include keys of other types (such as string or bool) as parameters.

Since :
2.3
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/systemsettings.admin
Remarks:
When the feature related to the key is not supported on the device, SYSTEM_SETTINGS_ERROR_NOT_SUPPORTED will be returned.
Parameters:
[in]keyThe key name of the system settings
[out]valueThe new system settings value of the given key
Returns:
0 on success, otherwise a negative error value
Return values:
SYSTEM_SETTINGS_ERROR_NONESuccessful
SYSTEM_SETTINGS_ERROR_NOT_SUPPORTEDThe related feature is not supported on the device
SYSTEM_SETTINGS_ERROR_PERMISSION_DENIEDPermission violation error
SYSTEM_SETTINGS_ERROR_INVALID_PARAMETERInvalid parameter
SYSTEM_SETTINGS_ERROR_IO_ERRORInternal I/O error
int system_settings_set_value_string ( system_settings_key_e  key,
const char *  value 
)

Sets the system settings value associated with the given key as a string.

Warning:
This is not for use by third-party applications.

This API is used to set a string value for a key that can be set string in System Settings APIs. When using this function, be careful not to include keys of other types (such as int or bool) as parameters.

Since :
2.3
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/systemsettings.admin
Remarks:
SYSTEM_SETTINGS_KEY_DEFAULT_FONT_TYPE is not available for setting. When the feature related to the key is not supported on the device, SYSTEM_SETTINGS_ERROR_NOT_SUPPORTED will be returned.
Parameters:
[in]keyThe key name of the system settings
[out]valueThe new system settings value of the given key
Returns:
0 on success, otherwise a negative error value
Return values:
SYSTEM_SETTINGS_ERROR_NONESuccessful
SYSTEM_SETTINGS_ERROR_NOT_SUPPORTEDThe related feature is not supported on the device
SYSTEM_SETTINGS_ERROR_PERMISSION_DENIEDPermission violation error
SYSTEM_SETTINGS_ERROR_INVALID_PARAMETERInvalid parameter
SYSTEM_SETTINGS_ERROR_IO_ERRORInternal I/O error
int system_settings_unset_changed_cb ( system_settings_key_e  key)

Unsets the callback function.

This function is used to release the callback function specified by system_settings_set_changed_cb().

Since :
2.3
Remarks:
SYSTEM_SETTINGS_KEY_DEFAULT_FONT_TYPE is not available for set_changed_cb. When the feature related to the key is not supported on the device, SYSTEM_SETTINGS_ERROR_NOT_SUPPORTED will be returned.
Parameters:
[in]keyThe key name of the system settings
Returns:
0 on success, otherwise a negative error value
Return values:
SYSTEM_SETTINGS_ERROR_NONESuccessful
SYSTEM_SETTINGS_ERROR_NOT_SUPPORTEDThe related feature is not supported on the device
SYSTEM_SETTINGS_ERROR_PERMISSION_DENIEDPermission violation error
SYSTEM_SETTINGS_ERROR_INVALID_PARAMETERInvalid parameter
See also:
system_settings_set_changed_cb()
Warning:
http://tizen.org/privilege/systemsettings (public level privilege) MUST NOT be declared to use this function since 2.3.1.