Class SystemSettings

Definition

Namespace:

Tizen.System

Assembly:

Tizen.System.SystemSettings.dll

API Level:

3

The System Settings API provides APIs for sharing the configuration over a system.

public static class SystemSettings

Inheritance

Object

SystemSettings

Remarks

The 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 so on.

Properties

AccessibilityGrayscale

Indicates whether accessibility grayscale is enabled on the device or not.

Declaration

public static bool AccessibilityGrayscale { get; set; }

Property Value

Type	Description
Boolean

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 6

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/accessibility.grayscale

AccessibilityNegativeColor

Indicates whether accessibility negative color is enabled on the device or not.

Declaration

public static bool AccessibilityNegativeColor { get; set; }

Property Value

Type	Description
Boolean

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 6

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/accessibility.negative

AccessibilityTtsEnabled

Indicates whether the accessibility TTS is enabled on the device.

Declaration

public static bool AccessibilityTtsEnabled { get; set; }

Property Value

Type	Description
Boolean

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 4

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

AdsId

The current system ADS ID.

Declaration

public static string AdsId { get; set; }

Property Value

Type	Description
String

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

AutomaticTimeUpdate

Indicates whether the automatic time update is enabled on the device or not.

Declaration

public static bool AutomaticTimeUpdate { get; set; }

Property Value

Type	Description
Boolean

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 5

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/network.telephony

Data3GNetworkEnabled

Indicates whether the 3G data network is enabled.

Declaration

public static bool Data3GNetworkEnabled { get; set; }

Property Value

Type	Description
Boolean

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

DefaultFontType

The current system default font type (only supports Get).

Declaration

public static string DefaultFontType { get; }

Property Value

Type	Description
String

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/systemsetting.font

DeveloperOptionState

Indicates whether the developer option state is enabled on the device or not.

Declaration

public static bool DeveloperOptionState { get; set; }

Property Value

Type	Description
Boolean

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 5

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

DeviceName

Indicates the device name.

Declaration

public static string DeviceName { get; }

Property Value

Type	Description
String

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

DisplayScreenRotationAutoEnabled

Indicates whether the rotation control is automatic.

Declaration

public static bool DisplayScreenRotationAutoEnabled { get; }

Property Value

Type	Description
Boolean

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

EmailAlertRingtone

The file path of the current email alert ringtone.

Declaration

public static string EmailAlertRingtone { get; set; }

Property Value

Type	Description
String

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/systemsetting.notification_email

FontSize

The current system font size.

Declaration

public static SystemSettingsFontSize FontSize { get; set; }

Property Value

Type	Description
SystemSettingsFontSize

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/systemsetting.font

FontType

The current system font type.

Declaration

public static string FontType { get; set; }

Property Value

Type	Description
String

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/systemsetting.font

IncomingCallRingtone

The file path of the current ringtone.

Declaration

public static string IncomingCallRingtone { get; set; }

Property Value

Type	Description
String

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/systemsetting.incoming_call

LocaleCountry

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.

Declaration

public static string LocaleCountry { get; set; }

Property Value

Type	Description
String

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

LocaleLanguage

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.

Declaration

public static string LocaleLanguage { get; set; }

Property Value

Type	Description
String

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

LocaleTimeFormat24HourEnabled

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

Declaration

public static bool LocaleTimeFormat24HourEnabled { get; set; }

Property Value

Type	Description
Boolean

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

LocaleTimeZone

Indicates the current time zone, for example, Pacific/Tahiti.

Declaration

public static string LocaleTimeZone { get; set; }

Property Value

Type	Description
String

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

LockScreenApp

Indicates the lock-screen application package name.

Declaration

public static string LockScreenApp { get; set; }

Property Value

Type	Description
String

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 4

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/systemsetting.lock_screen

LockState

Indicates the current lock state.

Declaration

public static SystemSettingsIdleLockState LockState { get; set; }

Property Value

Type	Description
SystemSettingsIdleLockState

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

MotionActivationEnabled

Indicates whether the motion service is activated.

Declaration

public static bool MotionActivationEnabled { get; set; }

Property Value

Type	Description
Boolean

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

MotionEnabled

Indicates whether the device user has enabled the motion feature.

Declaration

public static bool MotionEnabled { get; }

Property Value

Type	Description
Boolean

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

NetworkFlightModeEnabled

Indicates whether the device is in the flight mode.

Declaration

public static bool NetworkFlightModeEnabled { get; }

Property Value

Type	Description
Boolean

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

NetworkWifiNotificationEnabled

Indicates whether Wi-Fi related notifications are enabled on the device.

Declaration

public static bool NetworkWifiNotificationEnabled { get; }

Property Value

Type	Description
Boolean

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/network.wifi

RotaryEventEnabled

Indicates whether rotary event is enabled on the device.

Declaration

public static bool RotaryEventEnabled { get; set; }

Property Value

Type	Description
Boolean

Remarks

http://tizen.org/privilege/systemsettings.admin is needed only for setting value. When getting the value, it isn't needed.

Exceptions

Type	Condition
NotSupportedException	Not Supported feature
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 6

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/input.rotating_bezel

ScreenBacklightTime

Indicates the backlight time (in seconds). The following values can be used: 15, 30, 60, 120, 300, and 600.

Declaration

public static int ScreenBacklightTime { get; set; }

Property Value

Type	Description
Int32

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

SoundLockEnabled

Indicates whether the screen lock sound is enabled on the device, for example, the LCD on or off sound.

Declaration

public static bool SoundLockEnabled { get; }

Property Value

Type	Description
Boolean

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

SoundNotification

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

Declaration

public static string SoundNotification { get; set; }

Property Value

Type	Description
String

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/systemsetting.incoming_call

SoundNotificationRepetitionPeriod

Indicates the time period for notification repetitions.

Declaration

public static int SoundNotificationRepetitionPeriod { get; set; }

Property Value

Type	Description
Int32

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

SoundSilentModeEnabled

Indicates whether the device is in the silent mode.

Declaration

public static bool SoundSilentModeEnabled { get; }

Property Value

Type	Description
Boolean

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

SoundTouchEnabled

Indicates whether the screen touch sound is enabled on the device.

Declaration

public static bool SoundTouchEnabled { get; }

Property Value

Type	Description
Boolean

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

Time

Once the system changes time, this event occurs to notify the time change.

Declaration

public static int Time { get; }

Property Value

Type	Description
Int32

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

UltraDataSave

Indicates the time period for notification repetitions.

Declaration

public static SystemSettingsUdsState UltraDataSave { get; }

Property Value

Type	Description
SystemSettingsUdsState

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/network.telephony

UsbDebuggingEnabled

Indicates whether the USB debugging is enabled.

Declaration

public static bool UsbDebuggingEnabled { get; set; }

Property Value

Type	Description
Boolean

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

Vibration

Indicates whether the vibration is enabled on the device or not.

Declaration

public static bool Vibration { get; set; }

Property Value

Type	Description
Boolean

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 5

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

WallpaperHomeScreen

The file path of the current home-screen wallpaper.

Declaration

public static string WallpaperHomeScreen { get; set; }

Property Value

Type	Description
String

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/systemsetting.home_screen

WallpaperLockScreen

The file path of the current lock-screen wallpaper.

Declaration

public static string WallpaperLockScreen { get; set; }

Property Value

Type	Description
String

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/systemsetting.lock_screen

Events

AccessibilityGrayscaleChanged

The AccessibilityGrayscaleChanged event is triggered when the AccessibilityGrayscale value is changed.

Declaration

public static event EventHandler<AccessibilityGrayscaleChangedEventArgs> AccessibilityGrayscaleChanged

Event Type

Type	Description
EventHandler<AccessibilityGrayscaleChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 6

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/accessibility.grayscale

AccessibilityNegativeColorChanged

The AccessibilityNegativeColorChanged event is triggered when the AccessibilityNegativeColor value is changed.

Declaration

public static event EventHandler<AccessibilityNegativeColorChangedEventArgs> AccessibilityNegativeColorChanged

Event Type

Type	Description
EventHandler<AccessibilityNegativeColorChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 6

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/accessibility.negative

AccessibilityTtsSettingChanged

THe AccessibilityTtsChanged event is triggered when the screen touch sound enabled status is changed.

Declaration

public static event EventHandler<AccessibilityTtsSettingChangedEventArgs> AccessibilityTtsSettingChanged

Event Type

Type	Description
EventHandler<AccessibilityTtsSettingChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 4

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

AdsIdChanged

The AdsIdChanged event is triggered when the current ADS ID state is changed.

Declaration

public static event EventHandler<AdsIdChangedEventArgs> AdsIdChanged

Event Type

Type	Description
EventHandler<AdsIdChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

AutomaticTimeUpdateChanged

The AutomaticTimeUpdateChanged event is triggered when the AutomaticTimeUpdate value is changed.

Declaration

public static event EventHandler<AutomaticTimeUpdateChangedEventArgs> AutomaticTimeUpdateChanged

Event Type

Type	Description
EventHandler<AutomaticTimeUpdateChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 5

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

Data3GNetworkSettingChanged

The Data3GNetworkSettingChanged event is triggered when the 3G data network status is changed.

Declaration

public static event EventHandler<Data3GNetworkSettingChangedEventArgs> Data3GNetworkSettingChanged

Event Type

Type	Description
EventHandler<Data3GNetworkSettingChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

DeveloperOptionStateChanged

The DeveloperOptionStateChanged event is triggered when the DeveloperOptionState value is changed.

Declaration

public static event EventHandler<DeveloperOptionStateChangedEventArgs> DeveloperOptionStateChanged

Event Type

Type	Description
EventHandler<DeveloperOptionStateChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 5

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

DeviceNameChanged

The DeviceNameChanged event is triggered when the device name is changed.

Declaration

public static event EventHandler<DeviceNameChangedEventArgs> DeviceNameChanged

Event Type

Type	Description
EventHandler<DeviceNameChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

DisplayScreenRotationAutoSettingChanged

The DisplayScreenRotationAutoChanged event is triggered when the automatic rotation control status is changed.

Declaration

public static event EventHandler<DisplayScreenRotationAutoSettingChangedEventArgs> DisplayScreenRotationAutoSettingChanged

Event Type

Type	Description
EventHandler<DisplayScreenRotationAutoSettingChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

EmailAlertRingtoneChanged

The EmailAlertRingtoneChanged event is triggered when the file path of the current email alert ringtone is changed.

Declaration

public static event EventHandler<EmailAlertRingtoneChangedEventArgs> EmailAlertRingtoneChanged

Event Type

Type	Description
EventHandler<EmailAlertRingtoneChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/systemsetting.notification_email

FontSizeChanged

The FontSizeChanged event is triggered when the current system font size is changed.

Declaration

public static event EventHandler<FontSizeChangedEventArgs> FontSizeChanged

Event Type

Type	Description
EventHandler<FontSizeChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

FontTypeChanged

The FontTypeChanged event is triggered when the current system font type is changed.

Declaration

public static event EventHandler<FontTypeChangedEventArgs> FontTypeChanged

Event Type

Type	Description
EventHandler<FontTypeChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

IncomingCallRingtoneChanged

The IncomingCallRingtoneChanged event is triggered when the file path of the incoming ringtone is changed.

Declaration

public static event EventHandler<IncomingCallRingtoneChangedEventArgs> IncomingCallRingtoneChanged

Event Type

Type	Description
EventHandler<IncomingCallRingtoneChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/systemsetting.incoming_call

LocaleCountryChanged

The LocaleCountryChanged event is triggered when the current country setting in the <LANGUAGE>_<REGION> syntax, is changed.

Declaration

public static event EventHandler<LocaleCountryChangedEventArgs> LocaleCountryChanged

Event Type

Type	Description
EventHandler<LocaleCountryChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

LocaleLanguageChanged

The LocaleLanguageChanged event is triggered when the current language setting in the <LANGUAGE>_<REGION> syntax, is changed.

Declaration

public static event EventHandler<LocaleLanguageChangedEventArgs> LocaleLanguageChanged

Event Type

Type	Description
EventHandler<LocaleLanguageChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

LocaleTimeFormat24HourSettingChanged

The LocaleTimeFormat24HourChanged event is triggered when the time format is changed.

Declaration

public static event EventHandler<LocaleTimeFormat24HourSettingChangedEventArgs> LocaleTimeFormat24HourSettingChanged

Event Type

Type	Description
EventHandler<LocaleTimeFormat24HourSettingChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

LocaleTimeZoneChanged

The LocaleTimeZoneChanged event is triggered when the current time zone is changed.

Declaration

public static event EventHandler<LocaleTimeZoneChangedEventArgs> LocaleTimeZoneChanged

Event Type

Type	Description
EventHandler<LocaleTimeZoneChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

LockScreenAppChanged

The LockScreenAppChanged event is triggered when the lockscreen application package name is changed.

Declaration

public static event EventHandler<LockScreenAppChangedEventArgs> LockScreenAppChanged

Event Type

Type	Description
EventHandler<LockScreenAppChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 4

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/systemsetting.lock_screen

LockStateChanged

The LockStateChanged event is triggered when the current lock state is changed.

Declaration

public static event EventHandler<LockStateChangedEventArgs> LockStateChanged

Event Type

Type	Description
EventHandler<LockStateChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

MotionActivationSettingChanged

The MotionActivationChanged event is triggered when the motion service status is changed.

Declaration

public static event EventHandler<MotionActivationSettingChangedEventArgs> MotionActivationSettingChanged

Event Type

Type	Description
EventHandler<MotionActivationSettingChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

MotionSettingChanged

The MotionSettingChanged event is triggered when the motion feature enabled status is changed.

Declaration

public static event EventHandler<MotionSettingChangedEventArgs> MotionSettingChanged

Event Type

Type	Description
EventHandler<MotionSettingChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

NetworkFlightModeSettingChanged

The NetworkFlightModeChanged event is triggered when the flight mode status is changed.

Declaration

public static event EventHandler<NetworkFlightModeSettingChangedEventArgs> NetworkFlightModeSettingChanged

Event Type

Type	Description
EventHandler<NetworkFlightModeSettingChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

NetworkWifiNotificationSettingChanged

The NetworkWifiNotificationChanged event is triggered when the WiFi-related notifications enabled status is changed.

Declaration

public static event EventHandler<NetworkWifiNotificationSettingChangedEventArgs> NetworkWifiNotificationSettingChanged

Event Type

Type	Description
EventHandler<NetworkWifiNotificationSettingChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/network.wifi

RotaryEventEnabledChanged

The RotaryEventEnabledChanged event is triggered when the RotaryEventEnabled value is changed.

Declaration

public static event EventHandler<RotaryEventEnabledChangedEventArgs> RotaryEventEnabledChanged

Event Type

Type	Description
EventHandler<RotaryEventEnabledChangedEventArgs>

Remarks

http://tizen.org/privilege/systemsettings.admin is needed only for setting value. When getting the value, it isn't needed.

Exceptions

Type	Condition
NotSupportedException	Not Supported feature
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 6

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/input.rotating_bezel

ScreenBacklightTimeChanged

THe ScreenBacklightTimeChanged event is triggered when the backlight time is changed.

Declaration

public static event EventHandler<ScreenBacklightTimeChangedEventArgs> ScreenBacklightTimeChanged

Event Type

Type	Description
EventHandler<ScreenBacklightTimeChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

SoundLockSettingChanged

The SoundLockChanged event is triggered when the screen lock sound enabled status is changed.

Declaration

public static event EventHandler<SoundLockSettingChangedEventArgs> SoundLockSettingChanged

Event Type

Type	Description
EventHandler<SoundLockSettingChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

SoundNotificationChanged

The SoundNotificationChanged event is triggered when the file path of the current notification tone set by the user is changed.

Declaration

public static event EventHandler<SoundNotificationChangedEventArgs> SoundNotificationChanged

Event Type

Type	Description
EventHandler<SoundNotificationChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/systemsetting.incoming_call

SoundNotificationRepetitionPeriodChanged

The SoundNotificationRepetitionPeriodChanged event is triggered when the time period for notification repetitions is changed.

Declaration

public static event EventHandler<SoundNotificationRepetitionPeriodChangedEventArgs> SoundNotificationRepetitionPeriodChanged

Event Type

Type	Description
EventHandler<SoundNotificationRepetitionPeriodChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

SoundSilentModeSettingChanged

The SoundSilentModeChanged event is triggered when the silent mode status is changed.

Declaration

public static event EventHandler<SoundSilentModeSettingChangedEventArgs> SoundSilentModeSettingChanged

Event Type

Type	Description
EventHandler<SoundSilentModeSettingChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

SoundTouchSettingChanged

THe SoundTouchChanged event is triggered when the screen touch sound enabled status is changed.

Declaration

public static event EventHandler<SoundTouchSettingChangedEventArgs> SoundTouchSettingChanged

Event Type

Type	Description
EventHandler<SoundTouchSettingChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

TimeChanged

The TimeChanged event is triggered when the system time is changed.

Declaration

public static event EventHandler<TimeChangedEventArgs> TimeChanged

Event Type

Type	Description
EventHandler<TimeChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

UltraDataSaveChanged

The UltraDataSaveChanged event is triggered when the current Ultra Data Save state is changed.

Declaration

public static event EventHandler<UltraDataSaveChangedEventArgs> UltraDataSaveChanged

Event Type

Type	Description
EventHandler<UltraDataSaveChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/network.telephony

UltraDataSavePackageListChanged

The UltraDataSavePackageListChanged event is triggered when the current ADS ID state is changed.

Declaration

public static event EventHandler<UltraDataSavePackageListChangedEventArgs> UltraDataSavePackageListChanged

Event Type

Type	Description
EventHandler<UltraDataSavePackageListChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/network.telephony

UsbDebuggingSettingChanged

The UsbDebuggingSettingChangedEventArgs event is triggered when the USB debugging status is changed.

Declaration

public static event EventHandler<UsbDebuggingSettingChangedEventArgs> UsbDebuggingSettingChanged

Event Type

Type	Description
EventHandler<UsbDebuggingSettingChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

VibrationChanged

The VibrationChanged event is triggered when the vibration value is changed.

Declaration

public static event EventHandler<VibrationChangedEventArgs> VibrationChanged

Event Type

Type	Description
EventHandler<VibrationChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 5

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsetting

WallpaperHomeScreenChanged

THe WallpaperHomeScreenChanged event is triggered when the file path of the current home screen wallpaper is changed.

Declaration

public static event EventHandler<WallpaperHomeScreenChangedEventArgs> WallpaperHomeScreenChanged

Event Type

Type	Description
EventHandler<WallpaperHomeScreenChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/systemsetting.home_screen

WallpaperLockScreenChanged

The WallpaperLockScreenChanged event is triggered when the file path of the current lock screen wallpaper is changed.

Declaration

public static event EventHandler<WallpaperLockScreenChangedEventArgs> WallpaperLockScreenChanged

Event Type

Type	Description
EventHandler<WallpaperLockScreenChangedEventArgs>

Exceptions

Type	Condition
ArgumentException	Invalid Argument
NotSupportedException	Not Supported feature
InvalidOperationException	Invalid operation
UnauthorizedAccessException	Thrown when application does not have privilege to access this method.

API Level: 3

Privilege Level: platform

Privilege: http://tizen.org/privilege/systemsettings.admin

Feature: http://tizen.org/feature/systemsettinghttp://tizen.org/feature/systemsetting.lock_screen