Added in API level 1

Summary: Constants | Inherited Constants | Fields | Ctors | Methods | Inherited Methods

Settings.System

---

Kotlin |Java

public static final class Settings.System
extends Settings.NameValueTable

java.lang.Object
↳	android.provider.Settings.NameValueTable
	↳	android.provider.Settings.System

---

System settings, containing miscellaneous system preferences. This table holds simple name/value pairs. There are convenience functions for accessing individual settings entries.

Summary

Constants
String	ACCELEROMETER_ROTATION Control whether the accelerometer will be used to change screen orientation.
String	ADB_ENABLED This constant was deprecated in API level 15. Use Settings.Global.ADB_ENABLED instead
String	AIRPLANE_MODE_ON This constant was deprecated in API level 17. Use Settings.Global.AIRPLANE_MODE_ON instead
String	AIRPLANE_MODE_RADIOS This constant was deprecated in API level 17. Use Settings.Global.AIRPLANE_MODE_RADIOS instead
String	ALARM_ALERT Persistent store for the system-wide default alarm alert.
String	ALWAYS_FINISH_ACTIVITIES This constant was deprecated in API level 17. Use Global#ALWAYS_FINISH_ACTIVITIES instead
String	ANDROID_ID This constant was deprecated in API level 15. Use Settings.Secure.ANDROID_ID instead
String	ANIMATOR_DURATION_SCALE This constant was deprecated in API level 17. Use Global#ANIMATOR_DURATION_SCALE instead
String	AUTO_TIME This constant was deprecated in API level 17. Use Settings.Global.AUTO_TIME instead
String	AUTO_TIME_ZONE This constant was deprecated in API level 17. Use Settings.Global.AUTO_TIME_ZONE instead
String	BLUETOOTH_DISCOVERABILITY Determines whether remote devices may discover and/or connect to this device.
String	BLUETOOTH_DISCOVERABILITY_TIMEOUT Bluetooth discoverability timeout.
String	BLUETOOTH_ON This constant was deprecated in API level 15. Use Settings.Global.BLUETOOTH_ON instead
String	DATA_ROAMING This constant was deprecated in API level 15. Use Settings.Global.DATA_ROAMING instead
String	DATE_FORMAT This constant was deprecated in API level 31. No longer used. Use TIME_12_24 instead.
String	DEBUG_APP This constant was deprecated in API level 17. Use Global#DEBUG_APP instead
String	DEVICE_PROVISIONED This constant was deprecated in API level 15. Use Settings.Global.DEVICE_PROVISIONED instead
String	DIM_SCREEN This constant was deprecated in API level 17. This setting is no longer used.
String	DTMF_TONE_TYPE_WHEN_DIALING CDMA only settings DTMF tone type played by the dialer when dialing.
String	DTMF_TONE_WHEN_DIALING Whether the audible DTMF tones are played by the dialer when dialing.
String	END_BUTTON_BEHAVIOR What happens when the user presses the end call button if they're not on a call.
String	FONT_SCALE Scaling factor for fonts, float.
String	HAPTIC_FEEDBACK_ENABLED This constant was deprecated in API level 33. Replaced by using VibrationAttributes.USAGE_TOUCH on vibrations. User settings are applied automatically by the service and should not be applied by individual apps.
String	HTTP_PROXY This constant was deprecated in API level 15. Use Settings.Global.HTTP_PROXY instead
String	INSTALL_NON_MARKET_APPS This constant was deprecated in API level 15. Use Settings.Secure.INSTALL_NON_MARKET_APPS instead
String	LOCATION_PROVIDERS_ALLOWED This constant was deprecated in API level 15. Use Settings.Secure.LOCATION_PROVIDERS_ALLOWED instead
String	LOCK_PATTERN_ENABLED This constant was deprecated in API level 15. Use Settings.Secure.LOCK_PATTERN_ENABLED instead
String	LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED This constant was deprecated in API level 15. Use Settings.Secure.LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED instead
String	LOCK_PATTERN_VISIBLE This constant was deprecated in API level 15. Use Settings.Secure.LOCK_PATTERN_VISIBLE instead
String	LOGGING_ID This constant was deprecated in API level 15. Use Settings.Secure.LOGGING_ID instead
String	MODE_RINGER This constant was deprecated in API level 17. Use Settings.Global.MODE_RINGER instead
String	MODE_RINGER_STREAMS_AFFECTED Determines which streams are affected by ringer and zen mode changes.
String	MUTE_STREAMS_AFFECTED Determines which streams are affected by mute.
String	NETWORK_PREFERENCE This constant was deprecated in API level 15. Use Settings.Global.NETWORK_PREFERENCE instead
String	NEXT_ALARM_FORMATTED This constant was deprecated in API level 21. Use AlarmManager.getNextAlarmClock().
String	NOTIFICATION_SOUND Persistent store for the system-wide default notification sound.
String	PARENTAL_CONTROL_ENABLED This constant was deprecated in API level 15. Use Settings.Secure.PARENTAL_CONTROL_ENABLED instead
String	PARENTAL_CONTROL_LAST_UPDATE This constant was deprecated in API level 15. Use Settings.Secure.PARENTAL_CONTROL_LAST_UPDATE instead
String	PARENTAL_CONTROL_REDIRECT_URL This constant was deprecated in API level 15. Use Settings.Secure.PARENTAL_CONTROL_REDIRECT_URL instead
String	RADIO_BLUETOOTH This constant was deprecated in API level 17. Use Settings.Global.RADIO_BLUETOOTH instead
String	RADIO_CELL This constant was deprecated in API level 17. Use Settings.Global.RADIO_CELL instead
String	RADIO_NFC This constant was deprecated in API level 17. Use Settings.Global.RADIO_NFC instead
String	RADIO_WIFI This constant was deprecated in API level 17. Use Settings.Global.RADIO_WIFI instead
String	RINGTONE Persistent store for the system-wide default ringtone URI.
String	SCREEN_BRIGHTNESS The screen backlight brightness between 0 and 255.
String	SCREEN_BRIGHTNESS_MODE Control whether to enable automatic brightness mode.
int	SCREEN_BRIGHTNESS_MODE_AUTOMATIC SCREEN_BRIGHTNESS_MODE value for automatic mode.
int	SCREEN_BRIGHTNESS_MODE_MANUAL SCREEN_BRIGHTNESS_MODE value for manual mode.
String	SCREEN_OFF_TIMEOUT The amount of time in milliseconds before the device goes to sleep or begins to dream after a period of inactivity.
String	SETTINGS_CLASSNAME This constant was deprecated in API level 15. Use Settings.Secure.SETTINGS_CLASSNAME instead
String	SETUP_WIZARD_HAS_RUN Whether the setup wizard has been run before (on first boot), or if it still needs to be run.
String	SHOW_GTALK_SERVICE_STATUS
String	SHOW_PROCESSES This constant was deprecated in API level 17. This functionality is no longer available as of Build.VERSION_CODES.N_MR1.
String	SHOW_WEB_SUGGESTIONS This constant was deprecated in API level 15. Each application that shows web suggestions should have its own setting for this.
String	SOUND_EFFECTS_ENABLED Whether the sounds effects (key clicks, lid open ...) are enabled.
String	STAY_ON_WHILE_PLUGGED_IN This constant was deprecated in API level 17. Use Settings.Global.STAY_ON_WHILE_PLUGGED_IN instead
String	TEXT_AUTO_CAPS Setting to enable Auto Caps in text editors.
String	TEXT_AUTO_PUNCTUATE Setting to enable Auto Punctuate in text editors.
String	TEXT_AUTO_REPLACE Setting to enable Auto Replace (AutoText) in text editors.
String	TEXT_SHOW_PASSWORD Setting to showing password characters in text editors.
String	TIME_12_24 Display the user's times, e.g. in the status bar, as 12 or 24 hours.
String	TRANSITION_ANIMATION_SCALE This constant was deprecated in API level 17. Use Global#TRANSITION_ANIMATION_SCALE instead
String	USB_MASS_STORAGE_ENABLED This constant was deprecated in API level 15. Use Settings.Global.USB_MASS_STORAGE_ENABLED instead
String	USER_ROTATION Default screen rotation when no other policy applies.
String	USE_GOOGLE_MAIL This constant was deprecated in API level 15. Use Settings.Global.USE_GOOGLE_MAIL instead
String	VIBRATE_ON Whether vibrate is on for different events.
String	VIBRATE_WHEN_RINGING This constant was deprecated in API level 33. Replaced by using VibrationAttributes.USAGE_RINGTONE on vibrations for incoming calls. User settings are applied automatically by the service and should not be applied by individual apps.
String	WAIT_FOR_DEBUGGER This constant was deprecated in API level 17. Use Global#WAIT_FOR_DEBUGGER instead
String	WALLPAPER_ACTIVITY This constant was deprecated in API level 17. Use WallpaperManager instead.
String	WIFI_MAX_DHCP_RETRY_COUNT This constant was deprecated in API level 15. Use Settings.Global.WIFI_MAX_DHCP_RETRY_COUNT instead
String	WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS This constant was deprecated in API level 15. Use Settings.Global.WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS instead
String	WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON This constant was deprecated in API level 15. Use Settings.Global.WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON instead
String	WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY This constant was deprecated in API level 15. Use Settings.Global.WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY instead
String	WIFI_NUM_OPEN_NETWORKS_KEPT This constant was deprecated in API level 15. Use Settings.Global.WIFI_NUM_OPEN_NETWORKS_KEPT instead
String	WIFI_ON This constant was deprecated in API level 15. Use Settings.Global.WIFI_ON instead
String	WIFI_SLEEP_POLICY This constant was deprecated in API level 17. Use Settings.Global.WIFI_SLEEP_POLICY instead
int	WIFI_SLEEP_POLICY_DEFAULT This constant was deprecated in API level 17. Use Settings.Global.WIFI_SLEEP_POLICY_DEFAULT instead
int	WIFI_SLEEP_POLICY_NEVER This constant was deprecated in API level 17. Use Settings.Global.WIFI_SLEEP_POLICY_NEVER instead
int	WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED This constant was deprecated in API level 17. Use Settings.Global.WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED instead
String	WIFI_STATIC_DNS1 This constant was deprecated in API level 17. Use WifiManager instead
String	WIFI_STATIC_DNS2 This constant was deprecated in API level 17. Use WifiManager instead
String	WIFI_STATIC_GATEWAY This constant was deprecated in API level 17. Use WifiManager instead
String	WIFI_STATIC_IP This constant was deprecated in API level 17. Use WifiManager instead
String	WIFI_STATIC_NETMASK This constant was deprecated in API level 17. Use WifiManager instead
String	WIFI_USE_STATIC_IP This constant was deprecated in API level 17. Use WifiManager instead
String	WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE This constant was deprecated in API level 15. Use Settings.Secure.WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE instead
String	WIFI_WATCHDOG_AP_COUNT This constant was deprecated in API level 15. Use Settings.Secure.WIFI_WATCHDOG_AP_COUNT instead
String	WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS This constant was deprecated in API level 15. Use Settings.Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS instead
String	WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED This constant was deprecated in API level 15. Use Settings.Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED instead
String	WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS This constant was deprecated in API level 15. Use Settings.Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS instead
String	WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT This constant was deprecated in API level 15. Use Settings.Secure.WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT instead
String	WIFI_WATCHDOG_MAX_AP_CHECKS This constant was deprecated in API level 15. Use Settings.Secure.WIFI_WATCHDOG_MAX_AP_CHECKS instead
String	WIFI_WATCHDOG_ON This constant was deprecated in API level 15. Use Settings.Global.WIFI_WATCHDOG_ON instead
String	WIFI_WATCHDOG_PING_COUNT This constant was deprecated in API level 15. Use Settings.Secure.WIFI_WATCHDOG_PING_COUNT instead
String	WIFI_WATCHDOG_PING_DELAY_MS This constant was deprecated in API level 15. Use Settings.Secure.WIFI_WATCHDOG_PING_DELAY_MS instead
String	WIFI_WATCHDOG_PING_TIMEOUT_MS This constant was deprecated in API level 15. Use Settings.Secure.WIFI_WATCHDOG_PING_TIMEOUT_MS instead
String	WINDOW_ANIMATION_SCALE This constant was deprecated in API level 17. Use Global#WINDOW_ANIMATION_SCALE instead

Inherited constants
From class android.provider.Settings.NameValueTable String NAME String VALUE
From interface android.provider.BaseColumns String _COUNT The count of rows in a directory. String _ID The unique ID for a row.

Fields
public static final Uri	CONTENT_URI The content:// style URL for this table
public static final Uri	DEFAULT_ALARM_ALERT_URI A Uri that will point to the current default alarm alert at any given time.
public static final Uri	DEFAULT_NOTIFICATION_URI A Uri that will point to the current default notification sound at any given time.
public static final Uri	DEFAULT_RINGTONE_URI A Uri that will point to the current default ringtone at any given time.

Public constructors
System()

Public methods
static boolean	canWrite(Context context) Checks if the specified app can modify system settings.
static void	getConfiguration(ContentResolver cr, Configuration outConfig) Convenience function to read all of the current configuration-related settings into a Configuration object.
static float	getFloat(ContentResolver cr, String name, float def) Convenience function for retrieving a single system settings value as a floating point number.
static float	getFloat(ContentResolver cr, String name) Convenience function for retrieving a single system settings value as a float.
static int	getInt(ContentResolver cr, String name, int def) Convenience function for retrieving a single system settings value as an integer.
static int	getInt(ContentResolver cr, String name) Convenience function for retrieving a single system settings value as an integer.
static long	getLong(ContentResolver cr, String name) Convenience function for retrieving a single system settings value as a long.
static long	getLong(ContentResolver cr, String name, long def) Convenience function for retrieving a single system settings value as a long.
static boolean	getShowGTalkServiceStatus(ContentResolver cr) This method was deprecated in API level 17. - Do not use
static String	getString(ContentResolver resolver, String name) Look up a name in the database.
static Uri	getUriFor(String name) Construct the content URI for a particular name/value pair, useful for monitoring changes with a ContentObserver.
static boolean	putConfiguration(ContentResolver cr, Configuration config) Convenience function to write a batch of configuration-related settings from a Configuration object.
static boolean	putFloat(ContentResolver cr, String name, float value) Convenience function for updating a single settings value as a floating point number.
static boolean	putInt(ContentResolver cr, String name, int value) Convenience function for updating a single settings value as an integer.
static boolean	putLong(ContentResolver cr, String name, long value) Convenience function for updating a single settings value as a long integer.
static boolean	putString(ContentResolver resolver, String name, String value) Store a name/value pair into the database.
static void	setShowGTalkServiceStatus(ContentResolver cr, boolean flag) This method was deprecated in API level 17. - Do not use

Inherited methods
From class android.provider.Settings.NameValueTable static Uri getUriFor(Uri uri, String name) static boolean putString(ContentResolver resolver, Uri uri, String name, String value)
From class java.lang.Object Object clone() Creates and returns a copy of this object. boolean equals(Object obj) Indicates whether some other object is "equal to" this one. void finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. final Class<?> getClass() Returns the runtime class of this Object. int hashCode() Returns a hash code value for the object. final void notify() Wakes up a single thread that is waiting on this object's monitor. final void notifyAll() Wakes up all threads that are waiting on this object's monitor. String toString() Returns a string representation of the object. final void wait(long timeoutMillis, int nanos) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait(long timeoutMillis) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait() Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Constants

ACCELEROMETER_ROTATION

Added in API level 3

public static final String ACCELEROMETER_ROTATION

Control whether the accelerometer will be used to change screen orientation. If 0, it will not be used unless explicitly requested by the application; if 1, it will be used by default unless explicitly disabled by the application.

Constant Value: "accelerometer_rotation"

ADB_ENABLED

Added in API level 1
Deprecated in API level 15

public static final String ADB_ENABLED

This constant was deprecated in API level 15.
Use Settings.Global.ADB_ENABLED instead

Constant Value: "adb_enabled"

AIRPLANE_MODE_ON

Added in API level 1
Deprecated in API level 17

public static final String AIRPLANE_MODE_ON

This constant was deprecated in API level 17.
Use Settings.Global.AIRPLANE_MODE_ON instead

Constant Value: "airplane_mode_on"

AIRPLANE_MODE_RADIOS

Added in API level 1
Deprecated in API level 17

public static final String AIRPLANE_MODE_RADIOS

This constant was deprecated in API level 17.
Use Settings.Global.AIRPLANE_MODE_RADIOS instead

Constant Value: "airplane_mode_radios"

ALARM_ALERT

Added in API level 5

public static final String ALARM_ALERT

Persistent store for the system-wide default alarm alert.

See also:

• RINGTONE
• DEFAULT_ALARM_ALERT_URI

Constant Value: "alarm_alert"

ALWAYS_FINISH_ACTIVITIES

Added in API level 1
Deprecated in API level 17

public static final String ALWAYS_FINISH_ACTIVITIES

This constant was deprecated in API level 17.
Use Global#ALWAYS_FINISH_ACTIVITIES instead

If 1, the activity manager will aggressively finish activities and processes as soon as they are no longer needed. If 0, the normal extended lifetime is used.

Constant Value: "always_finish_activities"

ANDROID_ID

Added in API level 1
Deprecated in API level 15

public static final String ANDROID_ID

This constant was deprecated in API level 15.
Use Settings.Secure.ANDROID_ID instead

Constant Value: "android_id"

ANIMATOR_DURATION_SCALE

Added in API level 16
Deprecated in API level 17

public static final String ANIMATOR_DURATION_SCALE

This constant was deprecated in API level 17.
Use Global#ANIMATOR_DURATION_SCALE instead

Scaling factor for Animator-based animations. This affects both the start delay and duration of all such animations. Setting to 0 will cause animations to end immediately. The default value is 1.

Constant Value: "animator_duration_scale"

AUTO_TIME

Added in API level 1
Deprecated in API level 17

public static final String AUTO_TIME

This constant was deprecated in API level 17.
Use Settings.Global.AUTO_TIME instead

Constant Value: "auto_time"

AUTO_TIME_ZONE

Added in API level 11
Deprecated in API level 17

public static final String AUTO_TIME_ZONE

This constant was deprecated in API level 17.
Use Settings.Global.AUTO_TIME_ZONE instead

Constant Value: "auto_time_zone"

BLUETOOTH_DISCOVERABILITY

Added in API level 1

public static final String BLUETOOTH_DISCOVERABILITY

Determines whether remote devices may discover and/or connect to this device.

Type: INT

2 -- discoverable and connectable 1 -- connectable but not discoverable 0 -- neither connectable nor discoverable

Constant Value: "bluetooth_discoverability"

BLUETOOTH_DISCOVERABILITY_TIMEOUT

Added in API level 1

public static final String BLUETOOTH_DISCOVERABILITY_TIMEOUT

Bluetooth discoverability timeout. If this value is nonzero, then Bluetooth becomes discoverable for a certain number of seconds, after which is becomes simply connectable. The value is in seconds.

Constant Value: "bluetooth_discoverability_timeout"

BLUETOOTH_ON

Added in API level 1
Deprecated in API level 15

public static final String BLUETOOTH_ON

This constant was deprecated in API level 15.
Use Settings.Global.BLUETOOTH_ON instead

Constant Value: "bluetooth_on"

DATA_ROAMING

Added in API level 1
Deprecated in API level 15

public static final String DATA_ROAMING

This constant was deprecated in API level 15.
Use Settings.Global.DATA_ROAMING instead

Constant Value: "data_roaming"

DATE_FORMAT

Added in API level 1
Deprecated in API level 31

public static final String DATE_FORMAT

This constant was deprecated in API level 31.
No longer used. Use TIME_12_24 instead.

Constant Value: "date_format"

DEBUG_APP

Added in API level 1
Deprecated in API level 17

public static final String DEBUG_APP

This constant was deprecated in API level 17.
Use Global#DEBUG_APP instead

Name of an application package to be debugged.

Constant Value: "debug_app"

DEVICE_PROVISIONED

Added in API level 1
Deprecated in API level 15

public static final String DEVICE_PROVISIONED

This constant was deprecated in API level 15.
Use Settings.Global.DEVICE_PROVISIONED instead

Constant Value: "device_provisioned"

DIM_SCREEN

Added in API level 1
Deprecated in API level 17

public static final String DIM_SCREEN

This constant was deprecated in API level 17.
This setting is no longer used.

Whether or not to dim the screen. 0=no 1=yes

Constant Value: "dim_screen"

DTMF_TONE_TYPE_WHEN_DIALING

Added in API level 23

public static final String DTMF_TONE_TYPE_WHEN_DIALING

CDMA only settings DTMF tone type played by the dialer when dialing. 0 = Normal 1 = Long

Constant Value: "dtmf_tone_type"

DTMF_TONE_WHEN_DIALING

Added in API level 1

public static final String DTMF_TONE_WHEN_DIALING

Whether the audible DTMF tones are played by the dialer when dialing. The value is boolean (1 or 0).

Constant Value: "dtmf_tone"

END_BUTTON_BEHAVIOR

Added in API level 1

public static final String END_BUTTON_BEHAVIOR

What happens when the user presses the end call button if they're not on a call.
Values:
0 - The end button does nothing.
1 - The end button goes to the home screen.
2 - The end button puts the device to sleep and locks the keyguard.
3 - The end button goes to the home screen. If the user is already on the home screen, it puts the device to sleep.

Constant Value: "end_button_behavior"

FONT_SCALE

Added in API level 1

public static final String FONT_SCALE

Scaling factor for fonts, float.

Constant Value: "font_scale"

HAPTIC_FEEDBACK_ENABLED

Added in API level 3
Deprecated in API level 33

public static final String HAPTIC_FEEDBACK_ENABLED

This constant was deprecated in API level 33.
Replaced by using VibrationAttributes.USAGE_TOUCH on vibrations. User settings are applied automatically by the service and should not be applied by individual apps.

Whether haptic feedback (Vibrate on tap) is enabled. The value is boolean (1 or 0).

Constant Value: "haptic_feedback_enabled"

HTTP_PROXY

Added in API level 1
Deprecated in API level 15

public static final String HTTP_PROXY

This constant was deprecated in API level 15.
Use Settings.Global.HTTP_PROXY instead

Constant Value: "http_proxy"

INSTALL_NON_MARKET_APPS

Added in API level 1
Deprecated in API level 15

public static final String INSTALL_NON_MARKET_APPS

This constant was deprecated in API level 15.
Use Settings.Secure.INSTALL_NON_MARKET_APPS instead

Constant Value: "install_non_market_apps"

LOCATION_PROVIDERS_ALLOWED

Added in API level 1
Deprecated in API level 15

public static final String LOCATION_PROVIDERS_ALLOWED

This constant was deprecated in API level 15.
Use Settings.Secure.LOCATION_PROVIDERS_ALLOWED instead

Constant Value: "location_providers_allowed"

LOCK_PATTERN_ENABLED

Added in API level 1
Deprecated in API level 15

public static final String LOCK_PATTERN_ENABLED

This constant was deprecated in API level 15.
Use Settings.Secure.LOCK_PATTERN_ENABLED instead

Constant Value: "lock_pattern_autolock"

LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED

Added in API level 3
Deprecated in API level 15

public static final String LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED

This constant was deprecated in API level 15.
Use Settings.Secure.LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED instead

Constant Value: "lock_pattern_tactile_feedback_enabled"

LOCK_PATTERN_VISIBLE

Added in API level 1
Deprecated in API level 15

public static final String LOCK_PATTERN_VISIBLE

This constant was deprecated in API level 15.
Use Settings.Secure.LOCK_PATTERN_VISIBLE instead

Constant Value: "lock_pattern_visible_pattern"

LOGGING_ID

Added in API level 1
Deprecated in API level 15

public static final String LOGGING_ID

This constant was deprecated in API level 15.
Use Settings.Secure.LOGGING_ID instead

Constant Value: "logging_id"

MODE_RINGER

Added in API level 1
Deprecated in API level 17

public static final String MODE_RINGER

This constant was deprecated in API level 17.
Use Settings.Global.MODE_RINGER instead

Constant Value: "mode_ringer"

MODE_RINGER_STREAMS_AFFECTED

Added in API level 1

public static final String MODE_RINGER_STREAMS_AFFECTED

Determines which streams are affected by ringer and zen mode changes. The stream type's bit should be set to 1 if it should be muted when going into an inaudible ringer mode.

Constant Value: "mode_ringer_streams_affected"

MUTE_STREAMS_AFFECTED

Added in API level 1

public static final String MUTE_STREAMS_AFFECTED

Determines which streams are affected by mute. The stream type's bit should be set to 1 if it should be muted when a mute request is received.

Constant Value: "mute_streams_affected"

NETWORK_PREFERENCE

Added in API level 1
Deprecated in API level 15

public static final String NETWORK_PREFERENCE

This constant was deprecated in API level 15.
Use Settings.Global.NETWORK_PREFERENCE instead

Constant Value: "network_preference"

NEXT_ALARM_FORMATTED

Added in API level 1
Deprecated in API level 21

public static final String NEXT_ALARM_FORMATTED

This constant was deprecated in API level 21.
Use AlarmManager.getNextAlarmClock().

A formatted string of the next alarm that is set, or the empty string if there is no alarm set.

Constant Value: "next_alarm_formatted"

NOTIFICATION_SOUND

Added in API level 1

public static final String NOTIFICATION_SOUND

Persistent store for the system-wide default notification sound.

See also:

• RINGTONE
• DEFAULT_NOTIFICATION_URI

Constant Value: "notification_sound"

PARENTAL_CONTROL_ENABLED

Added in API level 1
Deprecated in API level 15

public static final String PARENTAL_CONTROL_ENABLED

This constant was deprecated in API level 15.
Use Settings.Secure.PARENTAL_CONTROL_ENABLED instead

Constant Value: "parental_control_enabled"

PARENTAL_CONTROL_LAST_UPDATE

Added in API level 1
Deprecated in API level 15

public static final String PARENTAL_CONTROL_LAST_UPDATE

This constant was deprecated in API level 15.
Use Settings.Secure.PARENTAL_CONTROL_LAST_UPDATE instead

Constant Value: "parental_control_last_update"

PARENTAL_CONTROL_REDIRECT_URL

Added in API level 1
Deprecated in API level 15

public static final String PARENTAL_CONTROL_REDIRECT_URL

This constant was deprecated in API level 15.
Use Settings.Secure.PARENTAL_CONTROL_REDIRECT_URL instead

Constant Value: "parental_control_redirect_url"

RADIO_BLUETOOTH

Added in API level 1
Deprecated in API level 17

public static final String RADIO_BLUETOOTH

This constant was deprecated in API level 17.
Use Settings.Global.RADIO_BLUETOOTH instead

Constant Value: "bluetooth"

RADIO_CELL

Added in API level 1
Deprecated in API level 17

public static final String RADIO_CELL

This constant was deprecated in API level 17.
Use Settings.Global.RADIO_CELL instead

Constant Value: "cell"

RADIO_NFC

Added in API level 14
Deprecated in API level 17

public static final String RADIO_NFC

This constant was deprecated in API level 17.
Use Settings.Global.RADIO_NFC instead

Constant Value: "nfc"

RADIO_WIFI

Added in API level 1
Deprecated in API level 17

public static final String RADIO_WIFI

This constant was deprecated in API level 17.
Use Settings.Global.RADIO_WIFI instead

Constant Value: "wifi"

RINGTONE

Added in API level 1

public static final String RINGTONE

Persistent store for the system-wide default ringtone URI.

If you need to play the default ringtone at any given time, it is recommended you give DEFAULT_RINGTONE_URI to the media player. It will resolve to the set default ringtone at the time of playing.

See also:

• DEFAULT_RINGTONE_URI

Constant Value: "ringtone"

SCREEN_BRIGHTNESS

Added in API level 1

public static final String SCREEN_BRIGHTNESS

The screen backlight brightness between 0 and 255.

Constant Value: "screen_brightness"

SCREEN_BRIGHTNESS_MODE

Added in API level 8

public static final String SCREEN_BRIGHTNESS_MODE

Control whether to enable automatic brightness mode.

Constant Value: "screen_brightness_mode"

SCREEN_BRIGHTNESS_MODE_AUTOMATIC

Added in API level 8

public static final int SCREEN_BRIGHTNESS_MODE_AUTOMATIC

SCREEN_BRIGHTNESS_MODE value for automatic mode.

Constant Value: 1 (0x00000001)

SCREEN_BRIGHTNESS_MODE_MANUAL

Added in API level 8

public static final int SCREEN_BRIGHTNESS_MODE_MANUAL

SCREEN_BRIGHTNESS_MODE value for manual mode.

Constant Value: 0 (0x00000000)

SCREEN_OFF_TIMEOUT

Added in API level 1

public static final String SCREEN_OFF_TIMEOUT

The amount of time in milliseconds before the device goes to sleep or begins to dream after a period of inactivity. This value is also known as the user activity timeout period since the screen isn't necessarily turned off when it expires.

This value is bounded by maximum timeout set by DevicePolicyManager.setMaximumTimeToLock(ComponentName, long).

Constant Value: "screen_off_timeout"

SETTINGS_CLASSNAME

Added in API level 1
Deprecated in API level 15

public static final String SETTINGS_CLASSNAME

This constant was deprecated in API level 15.
Use Settings.Secure.SETTINGS_CLASSNAME instead

Constant Value: "settings_classname"

SETUP_WIZARD_HAS_RUN

Added in API level 1

public static final String SETUP_WIZARD_HAS_RUN

Whether the setup wizard has been run before (on first boot), or if it still needs to be run. nonzero = it has been run in the past 0 = it has not been run in the past

Constant Value: "setup_wizard_has_run"

SHOW_GTALK_SERVICE_STATUS

Added in API level 1

public static final String SHOW_GTALK_SERVICE_STATUS

Constant Value: "SHOW_GTALK_SERVICE_STATUS"

SHOW_PROCESSES

Added in API level 1
Deprecated in API level 17

public static final String SHOW_PROCESSES

This constant was deprecated in API level 17.
This functionality is no longer available as of Build.VERSION_CODES.N_MR1.

Control whether the process CPU usage meter should be shown.

Constant Value: "show_processes"

SHOW_WEB_SUGGESTIONS

Added in API level 4
Deprecated in API level 15

public static final String SHOW_WEB_SUGGESTIONS

This constant was deprecated in API level 15.
Each application that shows web suggestions should have its own setting for this.

Constant Value: "show_web_suggestions"

SOUND_EFFECTS_ENABLED

Added in API level 1

public static final String SOUND_EFFECTS_ENABLED

Whether the sounds effects (key clicks, lid open ...) are enabled. The value is boolean (1 or 0).

Constant Value: "sound_effects_enabled"

STAY_ON_WHILE_PLUGGED_IN

Added in API level 1
Deprecated in API level 17

public static final String STAY_ON_WHILE_PLUGGED_IN

This constant was deprecated in API level 17.
Use Settings.Global.STAY_ON_WHILE_PLUGGED_IN instead

Constant Value: "stay_on_while_plugged_in"

TEXT_AUTO_CAPS

Added in API level 1

public static final String TEXT_AUTO_CAPS

Setting to enable Auto Caps in text editors. 1 = On, 0 = Off

Constant Value: "auto_caps"

TEXT_AUTO_PUNCTUATE

Added in API level 1

public static final String TEXT_AUTO_PUNCTUATE

Setting to enable Auto Punctuate in text editors. 1 = On, 0 = Off. This feature converts two spaces to a "." and space.

Constant Value: "auto_punctuate"

TEXT_AUTO_REPLACE

Added in API level 1

public static final String TEXT_AUTO_REPLACE

Setting to enable Auto Replace (AutoText) in text editors. 1 = On, 0 = Off

Constant Value: "auto_replace"

TEXT_SHOW_PASSWORD

Added in API level 1

public static final String TEXT_SHOW_PASSWORD

Setting to showing password characters in text editors. 1 = On, 0 = Off

Constant Value: "show_password"

TIME_12_24

Added in API level 1

public static final String TIME_12_24

Display the user's times, e.g. in the status bar, as 12 or 24 hours.

• 24 = 24 hour
• 12 = 12 hour
• [unset] = use the device locale's default

Constant Value: "time_12_24"

TRANSITION_ANIMATION_SCALE

Added in API level 1
Deprecated in API level 17

public static final String TRANSITION_ANIMATION_SCALE

This constant was deprecated in API level 17.
Use Global#TRANSITION_ANIMATION_SCALE instead

Scaling factor for activity transition animations. Setting to 0 will disable window animations.

Constant Value: "transition_animation_scale"

USB_MASS_STORAGE_ENABLED

Added in API level 1
Deprecated in API level 15

public static final String USB_MASS_STORAGE_ENABLED

This constant was deprecated in API level 15.
Use Settings.Global.USB_MASS_STORAGE_ENABLED instead

Constant Value: "usb_mass_storage_enabled"

USER_ROTATION

Added in API level 11

public static final String USER_ROTATION

Default screen rotation when no other policy applies. When ACCELEROMETER_ROTATION is zero and no on-screen Activity expresses a preference, this rotation value will be used. Must be one of the Surface rotation constants.

See also:

• Display.getRotation()

Constant Value: "user_rotation"

USE_GOOGLE_MAIL

Added in API level 1
Deprecated in API level 15

public static final String USE_GOOGLE_MAIL

This constant was deprecated in API level 15.
Use Settings.Global.USE_GOOGLE_MAIL instead

Constant Value: "use_google_mail"

VIBRATE_ON

Added in API level 1

public static final String VIBRATE_ON

Whether vibrate is on for different events. This is used internally, changing this value will not change the vibrate. See AudioManager.

Constant Value: "vibrate_on"

VIBRATE_WHEN_RINGING

Added in API level 23
Deprecated in API level 33

public static final String VIBRATE_WHEN_RINGING

This constant was deprecated in API level 33.
Replaced by using VibrationAttributes.USAGE_RINGTONE on vibrations for incoming calls. User settings are applied automatically by the service and should not be applied by individual apps.

Whether the phone vibrates when it is ringing due to an incoming call. This will be used by Phone and Setting apps; it shouldn't affect other apps. The value is boolean (1 or 0). Note: this is not same as "vibrate on ring", which had been available until ICS. It was about AudioManager's setting and thus affected all the applications which relied on the setting, while this is purely about the vibration setting for incoming calls.

Constant Value: "vibrate_when_ringing"

WAIT_FOR_DEBUGGER

Added in API level 1
Deprecated in API level 17

public static final String WAIT_FOR_DEBUGGER

This constant was deprecated in API level 17.
Use Global#WAIT_FOR_DEBUGGER instead

If 1, when launching DEBUG_APP it will wait for the debugger before starting user code. If 0, it will run normally.

Constant Value: "wait_for_debugger"

WALLPAPER_ACTIVITY

Added in API level 1
Deprecated in API level 17

public static final String WALLPAPER_ACTIVITY

This constant was deprecated in API level 17.
Use WallpaperManager instead.

Name of activity to use for wallpaper on the home screen.

Constant Value: "wallpaper_activity"

WIFI_MAX_DHCP_RETRY_COUNT

Added in API level 3
Deprecated in API level 15

public static final String WIFI_MAX_DHCP_RETRY_COUNT

This constant was deprecated in API level 15.
Use Settings.Global.WIFI_MAX_DHCP_RETRY_COUNT instead

Constant Value: "wifi_max_dhcp_retry_count"

WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS

Added in API level 3
Deprecated in API level 15

public static final String WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS

This constant was deprecated in API level 15.
Use Settings.Global.WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS instead

Constant Value: "wifi_mobile_data_transition_wakelock_timeout_ms"

WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON

Added in API level 1
Deprecated in API level 15

public static final String WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON

This constant was deprecated in API level 15.
Use Settings.Global.WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON instead

Constant Value: "wifi_networks_available_notification_on"

WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY

Added in API level 1
Deprecated in API level 15

public static final String WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY

This constant was deprecated in API level 15.
Use Settings.Global.WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY instead

Constant Value: "wifi_networks_available_repeat_delay"

WIFI_NUM_OPEN_NETWORKS_KEPT

Added in API level 1
Deprecated in API level 15

public static final String WIFI_NUM_OPEN_NETWORKS_KEPT

This constant was deprecated in API level 15.
Use Settings.Global.WIFI_NUM_OPEN_NETWORKS_KEPT instead

Constant Value: "wifi_num_open_networks_kept"

WIFI_ON

Added in API level 1
Deprecated in API level 15

public static final String WIFI_ON

This constant was deprecated in API level 15.
Use Settings.Global.WIFI_ON instead

Constant Value: "wifi_on"

WIFI_SLEEP_POLICY

Added in API level 3
Deprecated in API level 17

public static final String WIFI_SLEEP_POLICY

This constant was deprecated in API level 17.
Use Settings.Global.WIFI_SLEEP_POLICY instead

Constant Value: "wifi_sleep_policy"

WIFI_SLEEP_POLICY_DEFAULT

Added in API level 3
Deprecated in API level 17

public static final int WIFI_SLEEP_POLICY_DEFAULT

This constant was deprecated in API level 17.
Use Settings.Global.WIFI_SLEEP_POLICY_DEFAULT instead

Constant Value: 0 (0x00000000)

WIFI_SLEEP_POLICY_NEVER

Added in API level 3
Deprecated in API level 17

public static final int WIFI_SLEEP_POLICY_NEVER

This constant was deprecated in API level 17.
Use Settings.Global.WIFI_SLEEP_POLICY_NEVER instead

Constant Value: 2 (0x00000002)

WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED

Added in API level 3
Deprecated in API level 17

public static final int WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED

This constant was deprecated in API level 17.
Use Settings.Global.WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED instead

Constant Value: 1 (0x00000001)

WIFI_STATIC_DNS1

Added in API level 1
Deprecated in API level 17

public static final String WIFI_STATIC_DNS1

This constant was deprecated in API level 17.
Use WifiManager instead

If using static IP, the primary DNS's IP address.

Example: "192.168.1.1"

Constant Value: "wifi_static_dns1"

WIFI_STATIC_DNS2

Added in API level 1
Deprecated in API level 17

public static final String WIFI_STATIC_DNS2

This constant was deprecated in API level 17.
Use WifiManager instead

If using static IP, the secondary DNS's IP address.

Example: "192.168.1.2"

Constant Value: "wifi_static_dns2"

WIFI_STATIC_GATEWAY

Added in API level 1
Deprecated in API level 17

public static final String WIFI_STATIC_GATEWAY

This constant was deprecated in API level 17.
Use WifiManager instead

If using static IP, the gateway's IP address.

Example: "192.168.1.1"

Constant Value: "wifi_static_gateway"

WIFI_STATIC_IP

Added in API level 1
Deprecated in API level 17

public static final String WIFI_STATIC_IP

This constant was deprecated in API level 17.
Use WifiManager instead

The static IP address.

Example: "192.168.1.51"

Constant Value: "wifi_static_ip"

WIFI_STATIC_NETMASK

Added in API level 1
Deprecated in API level 17

public static final String WIFI_STATIC_NETMASK

This constant was deprecated in API level 17.
Use WifiManager instead

If using static IP, the net mask.

Example: "255.255.255.0"

Constant Value: "wifi_static_netmask"

WIFI_USE_STATIC_IP

Added in API level 1
Deprecated in API level 17

public static final String WIFI_USE_STATIC_IP

This constant was deprecated in API level 17.
Use WifiManager instead

Whether to use static IP and other static network attributes.

Set to 1 for true and 0 for false.

Constant Value: "wifi_use_static_ip"

WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE

Added in API level 1
Deprecated in API level 15

public static final String WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE

This constant was deprecated in API level 15.
Use Settings.Secure.WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE instead

Constant Value: "wifi_watchdog_acceptable_packet_loss_percentage"

WIFI_WATCHDOG_AP_COUNT

Added in API level 1
Deprecated in API level 15

public static final String WIFI_WATCHDOG_AP_COUNT

This constant was deprecated in API level 15.
Use Settings.Secure.WIFI_WATCHDOG_AP_COUNT instead

Constant Value: "wifi_watchdog_ap_count"

WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS

Added in API level 1
Deprecated in API level 15

public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS

This constant was deprecated in API level 15.
Use Settings.Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS instead

Constant Value: "wifi_watchdog_background_check_delay_ms"

WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED

Added in API level 1
Deprecated in API level 15

public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED

This constant was deprecated in API level 15.
Use Settings.Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED instead

Constant Value: "wifi_watchdog_background_check_enabled"

WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS

Added in API level 1
Deprecated in API level 15

public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS

This constant was deprecated in API level 15.
Use Settings.Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS instead

Constant Value: "wifi_watchdog_background_check_timeout_ms"

WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT

Added in API level 1
Deprecated in API level 15

public static final String WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT

This constant was deprecated in API level 15.
Use Settings.Secure.WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT instead

Constant Value: "wifi_watchdog_initial_ignored_ping_count"

WIFI_WATCHDOG_MAX_AP_CHECKS

Added in API level 1
Deprecated in API level 15

public static final String WIFI_WATCHDOG_MAX_AP_CHECKS

This constant was deprecated in API level 15.
Use Settings.Secure.WIFI_WATCHDOG_MAX_AP_CHECKS instead

Constant Value: "wifi_watchdog_max_ap_checks"

WIFI_WATCHDOG_ON

Added in API level 1
Deprecated in API level 15

public static final String WIFI_WATCHDOG_ON

This constant was deprecated in API level 15.
Use Settings.Global.WIFI_WATCHDOG_ON instead

Constant Value: "wifi_watchdog_on"

WIFI_WATCHDOG_PING_COUNT

Added in API level 1
Deprecated in API level 15

public static final String WIFI_WATCHDOG_PING_COUNT

This constant was deprecated in API level 15.
Use Settings.Secure.WIFI_WATCHDOG_PING_COUNT instead

Constant Value: "wifi_watchdog_ping_count"

WIFI_WATCHDOG_PING_DELAY_MS

Added in API level 1
Deprecated in API level 15

public static final String WIFI_WATCHDOG_PING_DELAY_MS

This constant was deprecated in API level 15.
Use Settings.Secure.WIFI_WATCHDOG_PING_DELAY_MS instead

Constant Value: "wifi_watchdog_ping_delay_ms"

WIFI_WATCHDOG_PING_TIMEOUT_MS

Added in API level 1
Deprecated in API level 15

public static final String WIFI_WATCHDOG_PING_TIMEOUT_MS

This constant was deprecated in API level 15.
Use Settings.Secure.WIFI_WATCHDOG_PING_TIMEOUT_MS instead

Constant Value: "wifi_watchdog_ping_timeout_ms"

WINDOW_ANIMATION_SCALE

Added in API level 1
Deprecated in API level 17

public static final String WINDOW_ANIMATION_SCALE

This constant was deprecated in API level 17.
Use Global#WINDOW_ANIMATION_SCALE instead

Scaling factor for normal window animations. Setting to 0 will disable window animations.

Constant Value: "window_animation_scale"

Fields

CONTENT_URI

Added in API level 1

public static final Uri CONTENT_URI

The content:// style URL for this table

DEFAULT_ALARM_ALERT_URI

Added in API level 5

public static final Uri DEFAULT_ALARM_ALERT_URI

A Uri that will point to the current default alarm alert at any given time.

See also:

• DEFAULT_ALARM_ALERT_URI

DEFAULT_NOTIFICATION_URI

Added in API level 1

public static final Uri DEFAULT_NOTIFICATION_URI

A Uri that will point to the current default notification sound at any given time.

See also:

• DEFAULT_RINGTONE_URI

DEFAULT_RINGTONE_URI

Added in API level 1

public static final Uri DEFAULT_RINGTONE_URI

A Uri that will point to the current default ringtone at any given time.

If the current default ringtone is in the DRM provider and the caller does not have permission, the exception will be a FileNotFoundException.

Public constructors

System

public System ()

Public methods

canWrite

Added in API level 23

public static boolean canWrite (Context context)

Checks if the specified app can modify system settings. As of API level 23, an app cannot modify system settings unless it declares the Manifest.permission.WRITE_SETTINGS permission in its manifest, and the user specifically grants the app this capability. To prompt the user to grant this approval, the app must send an intent with the action Settings.ACTION_MANAGE_WRITE_SETTINGS, which causes the system to display a permission management screen.

Parameters
context	Context: App context.

Returns
boolean	true if the calling app can write to system settings, false otherwise

getConfiguration

Added in API level 1

public static void getConfiguration (ContentResolver cr, 
                Configuration outConfig)

Convenience function to read all of the current configuration-related settings into a Configuration object.

Parameters
cr	ContentResolver: The ContentResolver to access.
outConfig	Configuration: Where to place the configuration settings.

getFloat

Added in API level 1

public static float getFloat (ContentResolver cr, 
                String name, 
                float def)

Convenience function for retrieving a single system settings value as a floating point number. Note that internally setting values are always stored as strings; this function converts the string to an float for you. The default value will be returned if the setting is not defined or not a valid float.

Parameters
cr	ContentResolver: The ContentResolver to access.
name	String: The name of the setting to retrieve.
def	float: Value to return if the setting is not defined.

Returns
float	The setting's current value, or 'def' if it is not defined or not a valid float.

getFloat

Added in API level 1

public static float getFloat (ContentResolver cr, 
                String name)

Convenience function for retrieving a single system settings value as a float. Note that internally setting values are always stored as strings; this function converts the string to a float for you.

This version does not take a default value. If the setting has not been set, or the string value is not a number, it throws SettingNotFoundException.

Parameters
cr	ContentResolver: The ContentResolver to access.
name	String: The name of the setting to retrieve.

Returns
float	The setting's current value.

Throws
Settings.SettingNotFoundException	Thrown if a setting by the given name can't be found or the setting value is not a float.

getInt

Added in API level 1

public static int getInt (ContentResolver cr, 
                String name, 
                int def)

Convenience function for retrieving a single system settings value as an integer. Note that internally setting values are always stored as strings; this function converts the string to an integer for you. The default value will be returned if the setting is not defined or not an integer.

Parameters
cr	ContentResolver: The ContentResolver to access.
name	String: The name of the setting to retrieve.
def	int: Value to return if the setting is not defined.

Returns
int	The setting's current value, or 'def' if it is not defined or not a valid integer.

getInt

Added in API level 1

public static int getInt (ContentResolver cr, 
                String name)

Convenience function for retrieving a single system settings value as an integer. Note that internally setting values are always stored as strings; this function converts the string to an integer for you.

This version does not take a default value. If the setting has not been set, or the string value is not a number, it throws SettingNotFoundException.

Parameters
cr	ContentResolver: The ContentResolver to access.
name	String: The name of the setting to retrieve.

Returns
int	The setting's current value.

Throws
Settings.SettingNotFoundException	Thrown if a setting by the given name can't be found or the setting value is not an integer.

getLong

Added in API level 3

public static long getLong (ContentResolver cr, 
                String name)

Convenience function for retrieving a single system settings value as a long. Note that internally setting values are always stored as strings; this function converts the string to a long for you.

This version does not take a default value. If the setting has not been set, or the string value is not a number, it throws SettingNotFoundException.

Parameters
cr	ContentResolver: The ContentResolver to access.
name	String: The name of the setting to retrieve.

Returns
long	The setting's current value.

Throws
Settings.SettingNotFoundException	Thrown if a setting by the given name can't be found or the setting value is not an integer.

getLong

Added in API level 3

public static long getLong (ContentResolver cr, 
                String name, 
                long def)

Convenience function for retrieving a single system settings value as a long. Note that internally setting values are always stored as strings; this function converts the string to a long for you. The default value will be returned if the setting is not defined or not a long.

Parameters
cr	ContentResolver: The ContentResolver to access.
name	String: The name of the setting to retrieve.
def	long: Value to return if the setting is not defined.

Returns
long	The setting's current value, or 'def' if it is not defined or not a valid long.

getShowGTalkServiceStatus

Added in API level 1
Deprecated in API level 17

public static boolean getShowGTalkServiceStatus (ContentResolver cr)

This method was deprecated in API level 17.
- Do not use

Parameters
cr	ContentResolver

Returns
boolean

getString

Added in API level 1

public static String getString (ContentResolver resolver, 
                String name)

Look up a name in the database.

Parameters
resolver	ContentResolver: to access the database with
name	String: to look up in the table

Returns
String	the corresponding value, or null if not present

getUriFor

Added in API level 1

public static Uri getUriFor (String name)

Construct the content URI for a particular name/value pair, useful for monitoring changes with a ContentObserver.

Parameters
name	String: to look up in the table

Returns
Uri	the corresponding content URI, or null if not present

putConfiguration

Added in API level 1

public static boolean putConfiguration (ContentResolver cr, 
                Configuration config)

Convenience function to write a batch of configuration-related settings from a Configuration object.

Parameters
cr	ContentResolver: The ContentResolver to access.
config	Configuration: The settings to write.

Returns
boolean	true if the values were set, false on database errors

putFloat

Added in API level 1

public static boolean putFloat (ContentResolver cr, 
                String name, 
                float value)

Convenience function for updating a single settings value as a floating point number. This will either create a new entry in the table if the given name does not exist, or modify the value of the existing row with that name. Note that internally setting values are always stored as strings, so this function converts the given value to a string before storing it.

Parameters
cr	ContentResolver: The ContentResolver to access.
name	String: The name of the setting to modify.
value	float: The new value for the setting.

Returns
boolean	true if the value was set, false on database errors

putInt

Added in API level 1

public static boolean putInt (ContentResolver cr, 
                String name, 
                int value)

Convenience function for updating a single settings value as an integer. This will either create a new entry in the table if the given name does not exist, or modify the value of the existing row with that name. Note that internally setting values are always stored as strings, so this function converts the given value to a string before storing it.

Parameters
cr	ContentResolver: The ContentResolver to access.
name	String: The name of the setting to modify.
value	int: The new value for the setting.

Returns
boolean	true if the value was set, false on database errors

putLong

Added in API level 3

public static boolean putLong (ContentResolver cr, 
                String name, 
                long value)

Convenience function for updating a single settings value as a long integer. This will either create a new entry in the table if the given name does not exist, or modify the value of the existing row with that name. Note that internally setting values are always stored as strings, so this function converts the given value to a string before storing it.

Parameters
cr	ContentResolver: The ContentResolver to access.
name	String: The name of the setting to modify.
value	long: The new value for the setting.

Returns
boolean	true if the value was set, false on database errors

putString

Added in API level 1

public static boolean putString (ContentResolver resolver, 
                String name, 
                String value)

Store a name/value pair into the database.

Parameters
resolver	ContentResolver: to access the database with
name	String: to store
value	String: to associate with the name

Returns
boolean	true if the value was set, false on database errors

setShowGTalkServiceStatus

Added in API level 1
Deprecated in API level 17

public static void setShowGTalkServiceStatus (ContentResolver cr, 
                boolean flag)

This method was deprecated in API level 17.
- Do not use

Parameters
cr	ContentResolver
flag	boolean