Class SystemSettings

Definition

Namespace:
Tizen.System
Assembly:
Tizen.System.SystemSettings.dll

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

View Source

AccessibilityTtsEnabled

Indicates whether the accessibility TTS is enabled on the device.

Declaration
public static bool AccessibilityTtsEnabled { get; }
Property Value
Type Description
bool
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

AdsId

The current system ADS ID.

Declaration
public static string AdsId { get; set; }
Property Value
Type Description
string
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

Data3GNetworkEnabled

Indicates whether the 3G data network is enabled.

Declaration
public static bool Data3GNetworkEnabled { get; set; }
Property Value
Type Description
bool
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

DefaultFontType

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

Declaration
public static string DefaultFontType { get; }
Property Value
Type Description
string
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

DeviceName

Indicates the device name.

Declaration
public static string DeviceName { get; }
Property Value
Type Description
string
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

DisplayScreenRotationAutoEnabled

Indicates whether the rotation control is automatic.

Declaration
public static bool DisplayScreenRotationAutoEnabled { get; }
Property Value
Type Description
bool
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

EmailAlertRingtone

The file path of the current email alert ringtone.

Declaration
public static string EmailAlertRingtone { get; set; }
Property Value
Type Description
string
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

FontSize

The current system font size.

Declaration
public static SystemSettingsFontSize FontSize { get; set; }
Property Value
Type Description
SystemSettingsFontSize
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

FontType

The current system font type.

Declaration
public static string FontType { get; set; }
Property Value
Type Description
string
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

IncomingCallRingtone

The file path of the current ringtone.

Declaration
public static string IncomingCallRingtone { get; set; }
Property Value
Type Description
string
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
bool
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

LocaleTimeZone

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

Declaration
public static string LocaleTimeZone { get; set; }
Property Value
Type Description
string
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

LockScreenApp

Indicates the lock-screen application package name.

Declaration
public static string LockScreenApp { get; set; }
Property Value
Type Description
string
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

LockState

Indicates the current lock state.

Declaration
public static SystemSettingsIdleLockState LockState { get; set; }
Property Value
Type Description
SystemSettingsIdleLockState
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

MotionActivationEnabled

Indicates whether the motion service is activated.

Declaration
public static bool MotionActivationEnabled { get; set; }
Property Value
Type Description
bool
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

MotionEnabled

Indicates whether the device user has enabled the motion feature.

Declaration
public static bool MotionEnabled { get; }
Property Value
Type Description
bool
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

NetworkFlightModeEnabled

Indicates whether the device is in the flight mode.

Declaration
public static bool NetworkFlightModeEnabled { get; }
Property Value
Type Description
bool
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

NetworkWifiNotificationEnabled

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

Declaration
public static bool NetworkWifiNotificationEnabled { get; }
Property Value
Type Description
bool
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
int
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
bool
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

SoundNotificationRepetitionPeriod

Indicates the time period for notification repetitions.

Declaration
public static int SoundNotificationRepetitionPeriod { get; set; }
Property Value
Type Description
int
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

SoundSilentModeEnabled

Indicates whether the device is in the silent mode.

Declaration
public static bool SoundSilentModeEnabled { get; }
Property Value
Type Description
bool
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

SoundTouchEnabled

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

Declaration
public static bool SoundTouchEnabled { get; }
Property Value
Type Description
bool
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

Time

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

Declaration
public static int Time { get; }
Property Value
Type Description
int
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

UltraDataSave

Indicates the time period for notification repetitions.

Declaration
public static SystemSettingsUdsState UltraDataSave { get; }
Property Value
Type Description
SystemSettingsUdsState
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

UsbDebuggingEnabled

Indicates whether the USB debugging is enabled.

Declaration
public static bool UsbDebuggingEnabled { get; set; }
Property Value
Type Description
bool
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

WallpaperHomeScreen

The file path of the current home-screen wallpaper.

Declaration
public static string WallpaperHomeScreen { get; set; }
Property Value
Type Description
string
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

WallpaperLockScreen

The file path of the current lock-screen wallpaper.

Declaration
public static string WallpaperLockScreen { get; set; }
Property Value
Type Description
string
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.

Events

View Source

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
System.EventHandler<TEventArgs><AccessibilityTtsSettingChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
System.EventHandler<TEventArgs><AdsIdChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
System.EventHandler<TEventArgs><Data3GNetworkSettingChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

DeviceNameChanged

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

Declaration
public static event EventHandler<DeviceNameChangedEventArgs> DeviceNameChanged
Event Type
Type Description
System.EventHandler<TEventArgs><DeviceNameChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
System.EventHandler<TEventArgs><DisplayScreenRotationAutoSettingChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
System.EventHandler<TEventArgs><EmailAlertRingtoneChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
System.EventHandler<TEventArgs><FontSizeChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
System.EventHandler<TEventArgs><FontTypeChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
System.EventHandler<TEventArgs><IncomingCallRingtoneChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
System.EventHandler<TEventArgs><LocaleCountryChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
System.EventHandler<TEventArgs><LocaleLanguageChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

LocaleTimeFormat24HourSettingChanged

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

Declaration
public static event EventHandler<LocaleTimeFormat24HourSettingChangedEventArgs> LocaleTimeFormat24HourSettingChanged
Event Type
Type Description
System.EventHandler<TEventArgs><LocaleTimeFormat24HourSettingChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

LocaleTimeZoneChanged

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

Declaration
public static event EventHandler<LocaleTimeZoneChangedEventArgs> LocaleTimeZoneChanged
Event Type
Type Description
System.EventHandler<TEventArgs><LocaleTimeZoneChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
System.EventHandler<TEventArgs><LockScreenAppChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

LockStateChanged

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

Declaration
public static event EventHandler<LockStateChangedEventArgs> LockStateChanged
Event Type
Type Description
System.EventHandler<TEventArgs><LockStateChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

MotionActivationSettingChanged

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

Declaration
public static event EventHandler<MotionActivationSettingChangedEventArgs> MotionActivationSettingChanged
Event Type
Type Description
System.EventHandler<TEventArgs><MotionActivationSettingChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
System.EventHandler<TEventArgs><MotionSettingChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

NetworkFlightModeSettingChanged

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

Declaration
public static event EventHandler<NetworkFlightModeSettingChangedEventArgs> NetworkFlightModeSettingChanged
Event Type
Type Description
System.EventHandler<TEventArgs><NetworkFlightModeSettingChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
System.EventHandler<TEventArgs><NetworkWifiNotificationSettingChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

ScreenBacklightTimeChanged

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

Declaration
public static event EventHandler<ScreenBacklightTimeChangedEventArgs> ScreenBacklightTimeChanged
Event Type
Type Description
System.EventHandler<TEventArgs><ScreenBacklightTimeChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
System.EventHandler<TEventArgs><SoundLockSettingChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
System.EventHandler<TEventArgs><SoundNotificationChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
System.EventHandler<TEventArgs><SoundNotificationRepetitionPeriodChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

SoundSilentModeSettingChanged

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

Declaration
public static event EventHandler<SoundSilentModeSettingChangedEventArgs> SoundSilentModeSettingChanged
Event Type
Type Description
System.EventHandler<TEventArgs><SoundSilentModeSettingChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
System.EventHandler<TEventArgs><SoundTouchSettingChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

TimeChanged

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

Declaration
public static event EventHandler<TimeChangedEventArgs> TimeChanged
Event Type
Type Description
System.EventHandler<TEventArgs><TimeChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
System.EventHandler<TEventArgs><UltraDataSaveChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
System.EventHandler<TEventArgs><UltraDataSavePackageListChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

UsbDebuggingSettingChanged

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

Declaration
public static event EventHandler<UsbDebuggingSettingChangedEventArgs> UsbDebuggingSettingChanged
Event Type
Type Description
System.EventHandler<TEventArgs><UsbDebuggingSettingChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
System.EventHandler<TEventArgs><WallpaperHomeScreenChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.
View Source

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
System.EventHandler<TEventArgs><WallpaperLockScreenChangedEventArgs>
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.

Exceptions
Type Condition
System.ArgumentException

Invalid Argument
System.NotSupportedException

Not Supported feature
System.InvalidOperationException

Invalid operation
System.UnauthorizedAccessException

Thrown when application does not have privilege to access this method.