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
StringACCELEROMETER_ROTATIONControl whether the accelerometer will be used to change screen orientation.
StringADB_ENABLED This constant is deprecated. Use ADB_ENABLED instead
StringAIRPLANE_MODE_ONWhether Airplane Mode is on.
StringAIRPLANE_MODE_RADIOSA comma separated list of radios that need to be disabled when airplane mode is on.
StringALARM_ALERTPersistent store for the system-wide default alarm alert.
StringALWAYS_FINISH_ACTIVITIESIf 1, the activity manager will aggressively finish activities and processes as soon as they are no longer needed.
StringANDROID_ID This constant is deprecated. Use ANDROID_ID instead
StringAPPEND_FOR_LAST_AUDIBLEAppended to various volume related settings to record the previous values before they the settings were affected by a silent/vibrate ringer mode change.
StringAUTO_TIMEValue to specify if the user prefers the date, time and time zone to be automatically fetched from the network (NITZ).
StringBLUETOOTH_DISCOVERABILITYDetermines whether remote devices may discover and/or connect to this device.
StringBLUETOOTH_DISCOVERABILITY_TIMEOUTBluetooth discoverability timeout.
StringBLUETOOTH_ON This constant is deprecated. Use BLUETOOTH_ON instead
UriCONTENT_URIThe content:// style URL for this table
StringDATA_ROAMING This constant is deprecated. Use DATA_ROAMING instead
StringDATE_FORMATDate format string mm/dd/yyyy dd/mm/yyyy yyyy/mm/dd
StringDEBUG_APPName of an application package to be debugged.
UriDEFAULT_ALARM_ALERT_URIA Uri that will point to the current default alarm alert at any given time.
UriDEFAULT_NOTIFICATION_URIA Uri that will point to the current default notification sound at any given time.
UriDEFAULT_RINGTONE_URIA Uri that will point to the current default ringtone at any given time.
StringDEVICE_PROVISIONED This constant is deprecated. Use DEVICE_PROVISIONED instead
StringDIM_SCREENWhether or not to dim the screen.
StringDTMF_TONE_WHEN_DIALINGWhether the audible DTMF tones are played by the dialer when dialing.
StringEND_BUTTON_BEHAVIORWhat happens when the user presses the end call button if they're not on a call.
StringFONT_SCALEScaling factor for fonts, float.
StringHAPTIC_FEEDBACK_ENABLEDWhether the haptic feedback (long presses, ...) are enabled.
StringHTTP_PROXY This constant is deprecated. Use HTTP_PROXY instead
StringINSTALL_NON_MARKET_APPS This constant is deprecated. Use INSTALL_NON_MARKET_APPS instead
StringLOCATION_PROVIDERS_ALLOWED This constant is deprecated. Use LOCATION_PROVIDERS_ALLOWED instead
StringLOCK_PATTERN_ENABLED This constant is deprecated. Use LOCK_PATTERN_ENABLED instead
StringLOCK_PATTERN_TACTILE_FEEDBACK_ENABLED This constant is deprecated. Use LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED instead
StringLOCK_PATTERN_VISIBLE This constant is deprecated. Use LOCK_PATTERN_VISIBLE instead
StringLOGGING_ID This constant is deprecated. Use LOGGING_ID instead
StringMODE_RINGERRinger mode.
StringMODE_RINGER_STREAMS_AFFECTEDDetermines which streams are affected by ringer mode changes.
StringMUTE_STREAMS_AFFECTEDDetermines which streams are affected by mute.
StringNETWORK_PREFERENCE This constant is deprecated. Use NETWORK_PREFERENCE instead
StringNEXT_ALARM_FORMATTEDA formatted string of the next alarm that is set, or the empty string if there is no alarm set.
StringNOTIFICATION_SOUNDPersistent store for the system-wide default notification sound.
StringPARENTAL_CONTROL_ENABLED This constant is deprecated. Use PARENTAL_CONTROL_ENABLED instead
StringPARENTAL_CONTROL_LAST_UPDATE This constant is deprecated. Use PARENTAL_CONTROL_LAST_UPDATE instead
StringPARENTAL_CONTROL_REDIRECT_URL This constant is deprecated. Use PARENTAL_CONTROL_REDIRECT_URL instead
StringRADIO_BLUETOOTHConstant for use in AIRPLANE_MODE_RADIOS to specify Bluetooth radio.
StringRADIO_CELLConstant for use in AIRPLANE_MODE_RADIOS to specify Cellular radio.
StringRADIO_WIFIConstant for use in AIRPLANE_MODE_RADIOS to specify Wi-Fi radio.
StringRINGTONEPersistent store for the system-wide default ringtone URI.
StringSCREEN_BRIGHTNESSThe screen backlight brightness between 0 and 255.
StringSCREEN_BRIGHTNESS_MODEControl whether to enable automatic brightness mode.
intSCREEN_BRIGHTNESS_MODE_AUTOMATICSCREEN_BRIGHTNESS_MODE value for manual mode.
intSCREEN_BRIGHTNESS_MODE_MANUALSCREEN_BRIGHTNESS_MODE value for manual mode.
StringSCREEN_OFF_TIMEOUTThe timeout before the screen turns off.
StringSETTINGS_CLASSNAME This constant is deprecated. Use SETTINGS_CLASSNAME instead
StringSETUP_WIZARD_HAS_RUNWhether the setup wizard has been run before (on first boot), or if it still needs to be run.
StringSHOW_GTALK_SERVICE_STATUS
StringSHOW_PROCESSESControl whether the process CPU usage meter should be shown.
StringSHOW_WEB_SUGGESTIONSWhether live web suggestions while the user types into search dialogs are enabled.
StringSOUND_EFFECTS_ENABLEDWhether the sounds effects (key clicks, lid open ...) are enabled.
StringSTAY_ON_WHILE_PLUGGED_INWhether we keep the device on while the device is plugged in.
StringSYS_PROP_SETTING_VERSION
StringTEXT_AUTO_CAPSSetting to enable Auto Caps in text editors.
StringTEXT_AUTO_PUNCTUATESetting to enable Auto Punctuate in text editors.
StringTEXT_AUTO_REPLACESetting to enable Auto Replace (AutoText) in text editors.
StringTEXT_SHOW_PASSWORDSetting to showing password characters in text editors.
StringTIME_12_24Display times as 12 or 24 hours 12 24
StringTRANSITION_ANIMATION_SCALEScaling factor for activity transition animations.
StringUSB_MASS_STORAGE_ENABLED This constant is deprecated. Use USB_MASS_STORAGE_ENABLED instead
StringUSE_GOOGLE_MAIL This constant is deprecated. Use USE_GOOGLE_MAIL instead
StringVIBRATE_ONWhether vibrate is on for different events.
StringVOLUME_ALARMAlarm volume.
StringVOLUME_BLUETOOTH_SCOBluetooth Headset volume.
StringVOLUME_MUSICMusic/media/gaming volume.
StringVOLUME_NOTIFICATIONNotification volume.
StringVOLUME_RINGRinger volume.
String[]VOLUME_SETTINGSThe mapping of stream type (integer) to its setting.
StringVOLUME_SYSTEMSystem/notifications volume.
StringVOLUME_VOICEVoice call volume.
StringWAIT_FOR_DEBUGGERIf 1, when launching DEBUG_APP it will wait for the debugger before starting user code.
StringWALLPAPER_ACTIVITYName of activity to use for wallpaper on the home screen.
StringWIFI_MAX_DHCP_RETRY_COUNT This constant is deprecated. Use WIFI_MAX_DHCP_RETRY_COUNT instead
StringWIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS This constant is deprecated. Use WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS instead
StringWIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON This constant is deprecated. Use WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON instead
StringWIFI_NETWORKS_AVAILABLE_REPEAT_DELAY This constant is deprecated. Use WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY instead
StringWIFI_NUM_OPEN_NETWORKS_KEPT This constant is deprecated. Use WIFI_NUM_OPEN_NETWORKS_KEPT instead
StringWIFI_ON This constant is deprecated. Use WIFI_ON instead
StringWIFI_SLEEP_POLICYThe policy for deciding when Wi-Fi should go to sleep (which will in turn switch to using the mobile data as an Internet connection).
intWIFI_SLEEP_POLICY_DEFAULTValue 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.
intWIFI_SLEEP_POLICY_NEVERValue for WIFI_SLEEP_POLICY to never go to sleep.
intWIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGEDValue 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.
StringWIFI_STATIC_DNS1If using static IP, the primary DNS's IP address.
StringWIFI_STATIC_DNS2If using static IP, the secondary DNS's IP address.
StringWIFI_STATIC_GATEWAYIf using static IP, the gateway's IP address.
StringWIFI_STATIC_IPThe static IP address.
StringWIFI_STATIC_NETMASKIf using static IP, the net mask.
StringWIFI_USE_STATIC_IPWhether to use static IP and other static network attributes.
StringWIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE This constant is deprecated. Use WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE instead
StringWIFI_WATCHDOG_AP_COUNT This constant is deprecated. Use WIFI_WATCHDOG_AP_COUNT instead
StringWIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS This constant is deprecated. Use WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS instead
StringWIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED This constant is deprecated. Use WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED instead
StringWIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS This constant is deprecated. Use WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS instead
StringWIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT This constant is deprecated. Use WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT instead
StringWIFI_WATCHDOG_MAX_AP_CHECKS This constant is deprecated. Use WIFI_WATCHDOG_MAX_AP_CHECKS instead
StringWIFI_WATCHDOG_ON This constant is deprecated. Use WIFI_WATCHDOG_ON instead
StringWIFI_WATCHDOG_PING_COUNT This constant is deprecated. Use WIFI_WATCHDOG_PING_COUNT instead
StringWIFI_WATCHDOG_PING_DELAY_MS This constant is deprecated. Use WIFI_WATCHDOG_PING_DELAY_MS instead
StringWIFI_WATCHDOG_PING_TIMEOUT_MS This constant is deprecated. Use WIFI_WATCHDOG_PING_TIMEOUT_MS instead
StringWINDOW_ANIMATION_SCALEScaling 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