public static final class

Settings.System

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

Class Overview

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 is deprecated. Use ADB_ENABLED instead
String AIRPLANE_MODE_ON Whether Airplane Mode is on.
String AIRPLANE_MODE_RADIOS A comma separated list of radios that need to be disabled when airplane mode is on.
String ALARM_ALERT Persistent store for the system-wide default alarm alert.
String ALWAYS_FINISH_ACTIVITIES If 1, the activity manager will aggressively finish activities and processes as soon as they are no longer needed.
String ANDROID_ID This constant is deprecated. Use ANDROID_ID instead
String APPEND_FOR_LAST_AUDIBLE Appended to various volume related settings to record the previous values before they the settings were affected by a silent/vibrate ringer mode change.
String AUTO_TIME Value to specify if the user prefers the date, time and time zone to be automatically fetched from the network (NITZ).
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 is deprecated. Use BLUETOOTH_ON instead
Uri CONTENT_URI The content:// style URL for this table
String DATA_ROAMING This constant is deprecated. Use DATA_ROAMING instead
String DATE_FORMAT Date format string mm/dd/yyyy dd/mm/yyyy yyyy/mm/dd
String DEBUG_APP Name of an application package to be debugged.
Uri DEFAULT_ALARM_ALERT_URI A Uri that will point to the current default alarm alert at any given time.
Uri DEFAULT_NOTIFICATION_URI A Uri that will point to the current default notification sound at any given time.
Uri DEFAULT_RINGTONE_URI A Uri that will point to the current default ringtone at any given time.
String DEVICE_PROVISIONED This constant is deprecated. Use DEVICE_PROVISIONED instead
String DIM_SCREEN Whether or not to dim the screen.
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 Whether the haptic feedback (long presses, ...) are enabled.
String HTTP_PROXY This constant is deprecated. Use HTTP_PROXY instead
String INSTALL_NON_MARKET_APPS This constant is deprecated. Use INSTALL_NON_MARKET_APPS instead
String LOCATION_PROVIDERS_ALLOWED This constant is deprecated. Use LOCATION_PROVIDERS_ALLOWED instead
String LOCK_PATTERN_ENABLED This constant is deprecated. Use LOCK_PATTERN_ENABLED instead
String LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED This constant is deprecated. Use LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED instead
String LOCK_PATTERN_VISIBLE This constant is deprecated. Use LOCK_PATTERN_VISIBLE instead
String LOGGING_ID This constant is deprecated. Use LOGGING_ID instead
String MODE_RINGER Ringer mode.
String MODE_RINGER_STREAMS_AFFECTED Determines which streams are affected by ringer mode changes.
String MUTE_STREAMS_AFFECTED Determines which streams are affected by mute.
String NETWORK_PREFERENCE This constant is deprecated. Use NETWORK_PREFERENCE instead
String NEXT_ALARM_FORMATTED A formatted string of the next alarm that is set, or the empty string if there is no alarm set.
String NOTIFICATION_SOUND Persistent store for the system-wide default notification sound.
String PARENTAL_CONTROL_ENABLED This constant is deprecated. Use PARENTAL_CONTROL_ENABLED instead
String PARENTAL_CONTROL_LAST_UPDATE This constant is deprecated. Use PARENTAL_CONTROL_LAST_UPDATE instead
String PARENTAL_CONTROL_REDIRECT_URL This constant is deprecated. Use PARENTAL_CONTROL_REDIRECT_URL instead
String RADIO_BLUETOOTH Constant for use in AIRPLANE_MODE_RADIOS to specify Bluetooth radio.
String RADIO_CELL Constant for use in AIRPLANE_MODE_RADIOS to specify Cellular radio.
String RADIO_WIFI Constant for use in AIRPLANE_MODE_RADIOS to specify Wi-Fi radio.
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 manual mode.
int SCREEN_BRIGHTNESS_MODE_MANUAL SCREEN_BRIGHTNESS_MODE value for manual mode.
String SCREEN_OFF_TIMEOUT The timeout before the screen turns off.
String SETTINGS_CLASSNAME This constant is deprecated. Use 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 Control whether the process CPU usage meter should be shown.
String SHOW_WEB_SUGGESTIONS Whether live web suggestions while the user types into search dialogs are enabled.
String SOUND_EFFECTS_ENABLED Whether the sounds effects (key clicks, lid open ...) are enabled.
String STAY_ON_WHILE_PLUGGED_IN Whether we keep the device on while the device is plugged in.
String SYS_PROP_SETTING_VERSION
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 times as 12 or 24 hours 12 24
String TRANSITION_ANIMATION_SCALE Scaling factor for activity transition animations.
String USB_MASS_STORAGE_ENABLED This constant is deprecated. Use USB_MASS_STORAGE_ENABLED instead
String USE_GOOGLE_MAIL This constant is deprecated. Use USE_GOOGLE_MAIL instead
String VIBRATE_ON Whether vibrate is on for different events.
String VOLUME_ALARM Alarm volume.
String VOLUME_BLUETOOTH_SCO Bluetooth Headset volume.
String VOLUME_MUSIC Music/media/gaming volume.
String VOLUME_NOTIFICATION Notification volume.
String VOLUME_RING Ringer volume.
String[] VOLUME_SETTINGS The mapping of stream type (integer) to its setting.
String VOLUME_SYSTEM System/notifications volume.
String VOLUME_VOICE Voice call volume.
String WAIT_FOR_DEBUGGER If 1, when launching DEBUG_APP it will wait for the debugger before starting user code.
String WALLPAPER_ACTIVITY Name of activity to use for wallpaper on the home screen.
String WIFI_MAX_DHCP_RETRY_COUNT This constant is deprecated. Use WIFI_MAX_DHCP_RETRY_COUNT instead
String WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS This constant is deprecated. Use WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS instead
String WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON This constant is deprecated. Use WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON instead
String WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY This constant is deprecated. Use WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY instead
String WIFI_NUM_OPEN_NETWORKS_KEPT This constant is deprecated. Use WIFI_NUM_OPEN_NETWORKS_KEPT instead
String WIFI_ON This constant is deprecated. Use WIFI_ON instead
String WIFI_SLEEP_POLICY The policy for deciding when Wi-Fi should go to sleep (which will in turn switch to using the mobile data as an Internet connection).
int WIFI_SLEEP_POLICY_DEFAULT Value for WIFI_SLEEP_POLICY to use the default Wi-Fi sleep policy, which is to sleep shortly after the turning off according to the STAY_ON_WHILE_PLUGGED_IN setting.
int WIFI_SLEEP_POLICY_NEVER Value for WIFI_SLEEP_POLICY to never go to sleep.
int WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED Value for WIFI_SLEEP_POLICY to use the default policy when the device is on battery, and never go to sleep when the device is plugged in.
String WIFI_STATIC_DNS1 If using static IP, the primary DNS's IP address.
String WIFI_STATIC_DNS2 If using static IP, the secondary DNS's IP address.
String WIFI_STATIC_GATEWAY If using static IP, the gateway's IP address.
String WIFI_STATIC_IP The static IP address.
String WIFI_STATIC_NETMASK If using static IP, the net mask.
String WIFI_USE_STATIC_IP Whether to use static IP and other static network attributes.
String WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE This constant is deprecated. Use WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE instead
String WIFI_WATCHDOG_AP_COUNT This constant is deprecated. Use WIFI_WATCHDOG_AP_COUNT instead
String WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS This constant is deprecated. Use WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS instead
String WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED This constant is deprecated. Use WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED instead
String WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS This constant is deprecated. Use WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS instead
String WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT This constant is deprecated. Use WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT instead
String WIFI_WATCHDOG_MAX_AP_CHECKS This constant is deprecated. Use WIFI_WATCHDOG_MAX_AP_CHECKS instead
String WIFI_WATCHDOG_ON This constant is deprecated. Use WIFI_WATCHDOG_ON instead
String WIFI_WATCHDOG_PING_COUNT This constant is deprecated. Use WIFI_WATCHDOG_PING_COUNT instead
String WIFI_WATCHDOG_PING_DELAY_MS This constant is deprecated. Use WIFI_WATCHDOG_PING_DELAY_MS instead
String WIFI_WATCHDOG_PING_TIMEOUT_MS This constant is deprecated. Use WIFI_WATCHDOG_PING_TIMEOUT_MS instead
String WINDOW_ANIMATION_SCALE Scaling factor for normal window animations.
[Expand]
Inherited Constants
From class android.provider.Settings.NameValueTable
From interface android.provider.BaseColumns
Public Constructors
Settings.System()
Public Methods
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)
Convenience function for retrieving a single system settings value as an integer.
static int getInt(ContentResolver cr, String name, int def)
Convenience function for retrieving a single system settings value as an integer.
static long getLong(ContentResolver cr, String name, long def)
Convenience function for retrieving a single system settings value as a long.
static long getLong(ContentResolver cr, String name)
Convenience function for retrieving a single system settings value as a long.
static boolean getShowGTalkServiceStatus(ContentResolver cr)
synchronized 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)
[Expand]
Inherited Methods
From class android.provider.Settings.NameValueTable
From class java.lang.Object

Constants

public static final String ACCELEROMETER_ROTATION

Since: API Level 3

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"

public static final String ADB_ENABLED

Since: API Level 1

This constant is deprecated.
Use ADB_ENABLED instead

Constant Value: "adb_enabled"

public static final String AIRPLANE_MODE_ON

Since: API Level 1

Whether Airplane Mode is on.

Constant Value: "airplane_mode_on"

public static final String AIRPLANE_MODE_RADIOS

Since: API Level 1

A comma separated list of radios that need to be disabled when airplane mode is on. This overrides WIFI_ON and BLUETOOTH_ON, if Wi-Fi and bluetooth are included in the comma separated list.

Constant Value: "airplane_mode_radios"

public static final String ALARM_ALERT

Since: API Level 5

Persistent store for the system-wide default alarm alert.

Constant Value: "alarm_alert"

public static final String ALWAYS_FINISH_ACTIVITIES

Since: API Level 1

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"

public static final String ANDROID_ID

Since: API Level 1

This constant is deprecated.
Use ANDROID_ID instead

Constant Value: "android_id"

public static final String APPEND_FOR_LAST_AUDIBLE

Since: API Level 1

Appended to various volume related settings to record the previous values before they the settings were affected by a silent/vibrate ringer mode change.

Constant Value: "_last_audible"

public static final String AUTO_TIME

Since: API Level 1

Value to specify if the user prefers the date, time and time zone to be automatically fetched from the network (NITZ). 1=yes, 0=no

Constant Value: "auto_time"

public static final String BLUETOOTH_DISCOVERABILITY

Since: API Level 1

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"

public static final String BLUETOOTH_DISCOVERABILITY_TIMEOUT

Since: API Level 1

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"

public static final String BLUETOOTH_ON

Since: API Level 1

This constant is deprecated.
Use BLUETOOTH_ON instead

Constant Value: "bluetooth_on"

public static final Uri CONTENT_URI

Since: API Level 1

The content:// style URL for this table

public static final String DATA_ROAMING

Since: API Level 1

This constant is deprecated.
Use DATA_ROAMING instead

Constant Value: "data_roaming"

public static final String DATE_FORMAT

Since: API Level 1

Date format string mm/dd/yyyy dd/mm/yyyy yyyy/mm/dd

Constant Value: "date_format"

public static final String DEBUG_APP

Since: API Level 1

Name of an application package to be debugged.

Constant Value: "debug_app"

public static final Uri DEFAULT_ALARM_ALERT_URI

Since: API Level 5

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

public static final Uri DEFAULT_NOTIFICATION_URI

Since: API Level 1

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

public static final Uri DEFAULT_RINGTONE_URI

Since: API Level 1

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 static final String DEVICE_PROVISIONED

Since: API Level 1

This constant is deprecated.
Use DEVICE_PROVISIONED instead

Constant Value: "device_provisioned"

public static final String DIM_SCREEN

Since: API Level 1

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

Constant Value: "dim_screen"

public static final String DTMF_TONE_WHEN_DIALING

Since: API Level 1

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

Constant Value: "dtmf_tone"

public static final String END_BUTTON_BEHAVIOR

Since: API Level 1

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"

public static final String FONT_SCALE

Since: API Level 1

Scaling factor for fonts, float.

Constant Value: "font_scale"

public static final String HAPTIC_FEEDBACK_ENABLED

Since: API Level 3

Whether the haptic feedback (long presses, ...) are enabled. The value is boolean (1 or 0).

Constant Value: "haptic_feedback_enabled"

public static final String HTTP_PROXY

Since: API Level 1

This constant is deprecated.
Use HTTP_PROXY instead

Constant Value: "http_proxy"

public static final String INSTALL_NON_MARKET_APPS

Since: API Level 1

This constant is deprecated.
Use INSTALL_NON_MARKET_APPS instead

Constant Value: "install_non_market_apps"

public static final String LOCATION_PROVIDERS_ALLOWED

Since: API Level 1

This constant is deprecated.
Use LOCATION_PROVIDERS_ALLOWED instead

Constant Value: "location_providers_allowed"

public static final String LOCK_PATTERN_ENABLED

Since: API Level 1

This constant is deprecated.
Use LOCK_PATTERN_ENABLED instead

Constant Value: "lock_pattern_autolock"

public static final String LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED

Since: API Level 3

This constant is deprecated.
Use LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED instead

Constant Value: "lock_pattern_tactile_feedback_enabled"

public static final String LOCK_PATTERN_VISIBLE

Since: API Level 1

This constant is deprecated.
Use LOCK_PATTERN_VISIBLE instead

Constant Value: "lock_pattern_visible_pattern"

public static final String LOGGING_ID

Since: API Level 1

This constant is deprecated.
Use LOGGING_ID instead

Constant Value: "logging_id"

public static final String MODE_RINGER

Since: API Level 1

Ringer mode. This is used internally, changing this value will not change the ringer mode. See AudioManager.

Constant Value: "mode_ringer"

public static final String MODE_RINGER_STREAMS_AFFECTED

Since: API Level 1

Determines which streams are affected by ringer 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"

public static final String MUTE_STREAMS_AFFECTED

Since: API Level 1

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"

public static final String NETWORK_PREFERENCE

Since: API Level 1

This constant is deprecated.
Use NETWORK_PREFERENCE instead

Constant Value: "network_preference"

public static final String NEXT_ALARM_FORMATTED

Since: API Level 1

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"

public static final String NOTIFICATION_SOUND

Since: API Level 1

Persistent store for the system-wide default notification sound.

Constant Value: "notification_sound"

public static final String PARENTAL_CONTROL_ENABLED

Since: API Level 1

This constant is deprecated.
Use PARENTAL_CONTROL_ENABLED instead

Constant Value: "parental_control_enabled"

public static final String PARENTAL_CONTROL_LAST_UPDATE

Since: API Level 1

This constant is deprecated.
Use PARENTAL_CONTROL_LAST_UPDATE instead

Constant Value: "parental_control_last_update"

public static final String PARENTAL_CONTROL_REDIRECT_URL

Since: API Level 1

This constant is deprecated.
Use PARENTAL_CONTROL_REDIRECT_URL instead

Constant Value: "parental_control_redirect_url"

public static final String RADIO_BLUETOOTH

Since: API Level 1

Constant for use in AIRPLANE_MODE_RADIOS to specify Bluetooth radio.

Constant Value: "bluetooth"

public static final String RADIO_CELL

Since: API Level 1

Constant for use in AIRPLANE_MODE_RADIOS to specify Cellular radio.

Constant Value: "cell"

public static final String RADIO_WIFI

Since: API Level 1

Constant for use in AIRPLANE_MODE_RADIOS to specify Wi-Fi radio.

Constant Value: "wifi"

public static final String RINGTONE

Since: API Level 1

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.

Constant Value: "ringtone"

public static final String SCREEN_BRIGHTNESS

Since: API Level 1

The screen backlight brightness between 0 and 255.

Constant Value: "screen_brightness"

public static final String SCREEN_BRIGHTNESS_MODE

Since: API Level 8

Control whether to enable automatic brightness mode.

Constant Value: "screen_brightness_mode"

public static final int SCREEN_BRIGHTNESS_MODE_AUTOMATIC

Since: API Level 8

SCREEN_BRIGHTNESS_MODE value for manual mode.

Constant Value: 1 (0x00000001)

public static final int SCREEN_BRIGHTNESS_MODE_MANUAL

Since: API Level 8

SCREEN_BRIGHTNESS_MODE value for manual mode.

Constant Value: 0 (0x00000000)

public static final String SCREEN_OFF_TIMEOUT

Since: API Level 1

The timeout before the screen turns off.

Constant Value: "screen_off_timeout"

public static final String SETTINGS_CLASSNAME

Since: API Level 1

This constant is deprecated.
Use SETTINGS_CLASSNAME instead

Constant Value: "settings_classname"

public static final String SETUP_WIZARD_HAS_RUN

Since: API Level 1

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"

public static final String SHOW_GTALK_SERVICE_STATUS

Since: API Level 1

Constant Value: "SHOW_GTALK_SERVICE_STATUS"

public static final String SHOW_PROCESSES

Since: API Level 1

Control whether the process CPU usage meter should be shown.

Constant Value: "show_processes"

public static final String SHOW_WEB_SUGGESTIONS

Since: API Level 4

Whether live web suggestions while the user types into search dialogs are enabled. Browsers and other search UIs should respect this, as it allows a user to avoid sending partial queries to a search engine, if it poses any privacy concern. The value is boolean (1 or 0).

Constant Value: "show_web_suggestions"

public static final String SOUND_EFFECTS_ENABLED

Since: API Level 1

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

Constant Value: "sound_effects_enabled"

public static final String STAY_ON_WHILE_PLUGGED_IN

Since: API Level 1

Whether we keep the device on while the device is plugged in. Supported values are:

These values can be OR-ed together.

Constant Value: "stay_on_while_plugged_in"

public static final String SYS_PROP_SETTING_VERSION

Since: API Level 1

Constant Value: "sys.settings_system_version"

public static final String TEXT_AUTO_CAPS

Since: API Level 1

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

Constant Value: "auto_caps"

public static final String TEXT_AUTO_PUNCTUATE

Since: API Level 1

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"

public static final String TEXT_AUTO_REPLACE

Since: API Level 1

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

Constant Value: "auto_replace"

public static final String TEXT_SHOW_PASSWORD

Since: API Level 1

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

Constant Value: "show_password"

public static final String TIME_12_24

Since: API Level 1

Display times as 12 or 24 hours 12 24

Constant Value: "time_12_24"

public static final String TRANSITION_ANIMATION_SCALE

Since: API Level 1

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

Constant Value: "transition_animation_scale"

public static final String USB_MASS_STORAGE_ENABLED

Since: API Level 1

This constant is deprecated.
Use USB_MASS_STORAGE_ENABLED instead

Constant Value: "usb_mass_storage_enabled"

public static final String USE_GOOGLE_MAIL

Since: API Level 1

This constant is deprecated.
Use USE_GOOGLE_MAIL instead

Constant Value: "use_google_mail"

public static final String VIBRATE_ON

Since: API Level 1

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"

public static final String VOLUME_ALARM

Since: API Level 1

Alarm volume. This is used internally, changing this value will not change the volume. See AudioManager.

Constant Value: "volume_alarm"

public static final String VOLUME_BLUETOOTH_SCO

Since: API Level 8

Bluetooth Headset volume. This is used internally, changing this value will not change the volume. See AudioManager.

Constant Value: "volume_bluetooth_sco"

public static final String VOLUME_MUSIC

Since: API Level 1

Music/media/gaming volume. This is used internally, changing this value will not change the volume. See AudioManager.

Constant Value: "volume_music"

public static final String VOLUME_NOTIFICATION

Since: API Level 3

Notification volume. This is used internally, changing this value will not change the volume. See AudioManager.

Constant Value: "volume_notification"

public static final String VOLUME_RING

Since: API Level 1

Ringer volume. This is used internally, changing this value will not change the volume. See AudioManager.

Constant Value: "volume_ring"

public static final String[] VOLUME_SETTINGS

Since: API Level 1

The mapping of stream type (integer) to its setting.

public static final String VOLUME_SYSTEM

Since: API Level 1

System/notifications volume. This is used internally, changing this value will not change the volume. See AudioManager.

Constant Value: "volume_system"

public static final String VOLUME_VOICE

Since: API Level 1

Voice call volume. This is used internally, changing this value will not change the volume. See AudioManager.

Constant Value: "volume_voice"

public static final String WAIT_FOR_DEBUGGER

Since: API Level 1

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"

public static final String WALLPAPER_ACTIVITY

Since: API Level 1

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

Constant Value: "wallpaper_activity"

public static final String WIFI_MAX_DHCP_RETRY_COUNT

Since: API Level 3

This constant is deprecated.
Use WIFI_MAX_DHCP_RETRY_COUNT instead

Constant Value: "wifi_max_dhcp_retry_count"

public static final String WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS

Since: API Level 3

This constant is deprecated.
Use WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS instead

Constant Value: "wifi_mobile_data_transition_wakelock_timeout_ms"

public static final String WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON

Since: API Level 1

This constant is deprecated.
Use WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON instead

Constant Value: "wifi_networks_available_notification_on"

public static final String WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY

Since: API Level 1

This constant is deprecated.
Use WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY instead

Constant Value: "wifi_networks_available_repeat_delay"

public static final String WIFI_NUM_OPEN_NETWORKS_KEPT

Since: API Level 1

This constant is deprecated.
Use WIFI_NUM_OPEN_NETWORKS_KEPT instead

Constant Value: "wifi_num_open_networks_kept"

public static final String WIFI_ON

Since: API Level 1

This constant is deprecated.
Use WIFI_ON instead

Constant Value: "wifi_on"

public static final String WIFI_SLEEP_POLICY

Since: API Level 3

The policy for deciding when Wi-Fi should go to sleep (which will in turn switch to using the mobile data as an Internet connection).

Set to one of WIFI_SLEEP_POLICY_DEFAULT, WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED, or WIFI_SLEEP_POLICY_NEVER.

Constant Value: "wifi_sleep_policy"

public static final int WIFI_SLEEP_POLICY_DEFAULT

Since: API Level 3

Value for WIFI_SLEEP_POLICY to use the default Wi-Fi sleep policy, which is to sleep shortly after the turning off according to the STAY_ON_WHILE_PLUGGED_IN setting.

Constant Value: 0 (0x00000000)

public static final int WIFI_SLEEP_POLICY_NEVER

Since: API Level 3

Value for WIFI_SLEEP_POLICY to never go to sleep.

Constant Value: 2 (0x00000002)

public static final int WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED

Since: API Level 3

Value for WIFI_SLEEP_POLICY to use the default policy when the device is on battery, and never go to sleep when the device is plugged in.

Constant Value: 1 (0x00000001)

public static final String WIFI_STATIC_DNS1

Since: API Level 1

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

Example: "192.168.1.1"

Constant Value: "wifi_static_dns1"

public static final String WIFI_STATIC_DNS2

Since: API Level 1

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

Example: "192.168.1.2"

Constant Value: "wifi_static_dns2"

public static final String WIFI_STATIC_GATEWAY

Since: API Level 1

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

Example: "192.168.1.1"

Constant Value: "wifi_static_gateway"

public static final String WIFI_STATIC_IP

Since: API Level 1

The static IP address.

Example: "192.168.1.51"

Constant Value: "wifi_static_ip"

public static final String WIFI_STATIC_NETMASK

Since: API Level 1

If using static IP, the net mask.

Example: "255.255.255.0"

Constant Value: "wifi_static_netmask"

public static final String WIFI_USE_STATIC_IP

Since: API Level 1

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"

public static final String WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE

Since: API Level 1

This constant is deprecated.
Use WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE instead

Constant Value: "wifi_watchdog_acceptable_packet_loss_percentage"

public static final String WIFI_WATCHDOG_AP_COUNT

Since: API Level 1

This constant is deprecated.
Use WIFI_WATCHDOG_AP_COUNT instead

Constant Value: "wifi_watchdog_ap_count"

public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS

Since: API Level 1

This constant is deprecated.
Use WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS instead

Constant Value: "wifi_watchdog_background_check_delay_ms"

public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED

Since: API Level 1

This constant is deprecated.
Use WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED instead

Constant Value: "wifi_watchdog_background_check_enabled"

public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS

Since: API Level 1

This constant is deprecated.
Use WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS instead

Constant Value: "wifi_watchdog_background_check_timeout_ms"

public static final String WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT

Since: API Level 1

This constant is deprecated.
Use WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT instead

Constant Value: "wifi_watchdog_initial_ignored_ping_count"

public static final String WIFI_WATCHDOG_MAX_AP_CHECKS

Since: API Level 1

This constant is deprecated.
Use WIFI_WATCHDOG_MAX_AP_CHECKS instead

Constant Value: "wifi_watchdog_max_ap_checks"

public static final String WIFI_WATCHDOG_ON

Since: API Level 1

This constant is deprecated.
Use WIFI_WATCHDOG_ON instead

Constant Value: "wifi_watchdog_on"

public static final String WIFI_WATCHDOG_PING_COUNT

Since: API Level 1

This constant is deprecated.
Use WIFI_WATCHDOG_PING_COUNT instead

Constant Value: "wifi_watchdog_ping_count"

public static final String WIFI_WATCHDOG_PING_DELAY_MS

Since: API Level 1

This constant is deprecated.
Use WIFI_WATCHDOG_PING_DELAY_MS instead

Constant Value: "wifi_watchdog_ping_delay_ms"

public static final String WIFI_WATCHDOG_PING_TIMEOUT_MS

Since: API Level 1

This constant is deprecated.
Use WIFI_WATCHDOG_PING_TIMEOUT_MS instead

Constant Value: "wifi_watchdog_ping_timeout_ms"

public static final String WINDOW_ANIMATION_SCALE

Since: API Level 1

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

Constant Value: "window_animation_scale"

Public Constructors

public Settings.System ()

Since: API Level 1

Public Methods

public static void getConfiguration (ContentResolver cr, Configuration outConfig)

Since: API Level 1

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

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

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

Since: API Level 1

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 The ContentResolver to access.
name The name of the setting to retrieve.
def Value to return if the setting is not defined.
Returns
  • The setting's current value, or 'def' if it is not defined or not a valid float.

public static float getFloat (ContentResolver cr, String name)

Since: API Level 1

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

Parameters
cr The ContentResolver to access.
name The name of the setting to retrieve.
Returns
  • 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.

public static int getInt (ContentResolver cr, String name)

Since: API Level 1

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

Parameters
cr The ContentResolver to access.
name The name of the setting to retrieve.
Returns
  • 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.

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

Since: API Level 1

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 The ContentResolver to access.
name The name of the setting to retrieve.
def Value to return if the setting is not defined.
Returns
  • The setting's current value, or 'def' if it is not defined or not a valid integer.

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

Since: API Level 3

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 The ContentResolver to access.
name The name of the setting to retrieve.
def Value to return if the setting is not defined.
Returns
  • The setting's current value, or 'def' if it is not defined or not a valid long.

public static long getLong (ContentResolver cr, String name)

Since: API Level 3

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

Parameters
cr The ContentResolver to access.
name The name of the setting to retrieve.
Returns
  • 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.

public static boolean getShowGTalkServiceStatus (ContentResolver cr)

Since: API Level 1

public static synchronized String getString (ContentResolver resolver, String name)

Since: API Level 1

Look up a name in the database.

Parameters
resolver to access the database with
name to look up in the table
Returns
  • the corresponding value, or null if not present

public static Uri getUriFor (String name)

Since: API Level 1

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

Parameters
name to look up in the table
Returns
  • the corresponding content URI, or null if not present

public static boolean putConfiguration (ContentResolver cr, Configuration config)

Since: API Level 1

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

Parameters
cr The ContentResolver to access.
config The settings to write.
Returns
  • true if the values were set, false on database errors

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

Since: API Level 1

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 The ContentResolver to access.
name The name of the setting to modify.
value The new value for the setting.
Returns
  • true if the value was set, false on database errors

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

Since: API Level 1

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 The ContentResolver to access.
name The name of the setting to modify.
value The new value for the setting.
Returns
  • true if the value was set, false on database errors

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

Since: API Level 3

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 The ContentResolver to access.
name The name of the setting to modify.
value The new value for the setting.
Returns
  • true if the value was set, false on database errors

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

Since: API Level 1

Store a name/value pair into the database.

Parameters
resolver to access the database with
name to store
value to associate with the name
Returns
  • true if the value was set, false on database errors

public static void setShowGTalkServiceStatus (ContentResolver cr, boolean flag)

Since: API Level 1