public
static
final
class
Settings.Secure
extends Settings.NameValueTable
java.lang.Object | ||
↳ | android.provider.Settings.NameValueTable | |
↳ | android.provider.Settings.Secure |
Secure system settings, containing system preferences that applications can read but are not allowed to write. These are for preferences that the user must explicitly modify through the system UI or specialized APIs for those values, not modified directly by applications.
Constants | |
---|---|
String |
ACCESSIBILITY_DISPLAY_INVERSION_ENABLED
Setting that specifies whether display color inversion is enabled. |
String |
ACCESSIBILITY_ENABLED
If accessibility is enabled. |
String |
ACCESSIBILITY_SPEAK_PASSWORD
Whether to speak passwords while in accessibility mode. |
String |
ADB_ENABLED
This constant was deprecated
in API level 17.
Use |
String |
ALLOWED_GEOLOCATION_ORIGINS
Origins for which browsers should allow geolocation by default. |
String |
ALLOW_MOCK_LOCATION
This constant was deprecated in API level 23. This settings is not used anymore. |
String |
ANDROID_ID
A 64-bit number (as a hex string) that is randomly generated when the user first sets up the device and should remain constant for the lifetime of the user's device. |
String |
BACKGROUND_DATA
This constant was deprecated
in API level 14.
As of |
String |
BLUETOOTH_ON
This constant was deprecated
in API level 17.
Use |
String |
DATA_ROAMING
This constant was deprecated
in API level 17.
Use |
String |
DEFAULT_INPUT_METHOD
Setting to record the input method used by default, holding the ID of the desired method. |
String |
DEVELOPMENT_SETTINGS_ENABLED
This constant was deprecated
in API level 17.
Use |
String |
DEVICE_PROVISIONED
This constant was deprecated
in API level 17.
Use |
String |
ENABLED_ACCESSIBILITY_SERVICES
List of the enabled accessibility providers. |
String |
ENABLED_INPUT_METHODS
List of input methods that are currently enabled. |
String |
HTTP_PROXY
This constant was deprecated
in API level 17.
Use |
String |
INPUT_METHOD_SELECTOR_VISIBILITY
Setting to record the visibility of input method selector |
String |
INSTALL_NON_MARKET_APPS
Whether applications can be installed for this user via the system's
|
String |
LOCATION_MODE
The degree of location access enabled by the user. |
int |
LOCATION_MODE_BATTERY_SAVING
Reduced power usage, such as limiting the number of GPS updates per hour. |
int |
LOCATION_MODE_HIGH_ACCURACY
Best-effort location computation allowed. |
int |
LOCATION_MODE_OFF
Location access disabled. |
int |
LOCATION_MODE_SENSORS_ONLY
Network Location Provider disabled, but GPS and other sensors enabled. |
String |
LOCATION_PROVIDERS_ALLOWED
This constant was deprecated
in API level 19.
use |
String |
LOCK_PATTERN_ENABLED
This constant was deprecated
in API level 23.
Use |
String |
LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED
This constant was deprecated
in API level 17.
Starting in |
String |
LOCK_PATTERN_VISIBLE
This constant was deprecated
in API level 23.
Accessing this setting from an app that is targeting
|
String |
LOGGING_ID
This constant was deprecated in API level 3. This identifier is poorly initialized and has many collisions. It should not be used. |
String |
NETWORK_PREFERENCE
This constant was deprecated
in API level 17.
Use |
String |
PARENTAL_CONTROL_ENABLED
No longer supported. |
String |
PARENTAL_CONTROL_LAST_UPDATE
No longer supported. |
String |
PARENTAL_CONTROL_REDIRECT_URL
No longer supported. |
String |
SELECTED_INPUT_METHOD_SUBTYPE
Setting to record the input method subtype used by default, holding the ID of the desired method. |
String |
SETTINGS_CLASSNAME
Settings classname to launch when Settings is clicked from All Applications. |
String |
SKIP_FIRST_USE_HINTS
If enabled, apps should try to skip any introductory hints on first launch. |
String |
TOUCH_EXPLORATION_ENABLED
If touch exploration is enabled. |
String |
TTS_DEFAULT_COUNTRY
This constant was deprecated
in API level 14.
this setting is no longer in use, as of the Ice Cream
Sandwich release. Apps should never need to read this setting directly,
instead can query the TextToSpeech framework classes for the default
locale. |
String |
TTS_DEFAULT_LANG
This constant was deprecated
in API level 14.
this setting is no longer in use, as of the Ice Cream
Sandwich release. Apps should never need to read this setting directly,
instead can query the TextToSpeech framework classes for the default
locale. |
String |
TTS_DEFAULT_PITCH
Default text-to-speech engine pitch. |
String |
TTS_DEFAULT_RATE
Default text-to-speech engine speech rate. |
String |
TTS_DEFAULT_SYNTH
Default text-to-speech engine. |
String |
TTS_DEFAULT_VARIANT
This constant was deprecated
in API level 14.
this setting is no longer in use, as of the Ice Cream
Sandwich release. Apps should never need to read this setting directly,
instead can query the TextToSpeech framework classes for the
locale that is in use |
String |
TTS_ENABLED_PLUGINS
Space delimited list of plugin packages that are enabled. |
String |
TTS_USE_DEFAULTS
This constant was deprecated in API level 14. The value of this setting is no longer respected by the framework text to speech APIs as of the Ice Cream Sandwich release. |
String |
USB_MASS_STORAGE_ENABLED
This constant was deprecated
in API level 17.
Use |
String |
USE_GOOGLE_MAIL
This constant was deprecated
in API level 17.
Use |
String |
WIFI_MAX_DHCP_RETRY_COUNT
This constant was deprecated
in API level 17.
Use
|
String |
WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS
This constant was deprecated
in API level 17.
Use
|
String |
WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON
This constant was deprecated
in API level 17.
Use |
String |
WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY
This constant was deprecated
in API level 17.
Use |
String |
WIFI_NUM_OPEN_NETWORKS_KEPT
This constant was deprecated
in API level 17.
Use |
String |
WIFI_ON
This constant was deprecated
in API level 17.
Use |
String |
WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE
This constant was deprecated in API level 14. This setting is not used. |
String |
WIFI_WATCHDOG_AP_COUNT
This constant was deprecated in API level 14. This setting is not used. |
String |
WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS
This constant was deprecated in API level 14. This setting is not used. |
String |
WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED
This constant was deprecated in API level 14. This setting is not used. |
String |
WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS
This constant was deprecated in API level 14. This setting is not used. |
String |
WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT
This constant was deprecated in API level 14. This setting is not used. |
String |
WIFI_WATCHDOG_MAX_AP_CHECKS
This constant was deprecated in API level 14. This setting is not used. |
String |
WIFI_WATCHDOG_ON
This constant was deprecated
in API level 17.
Use |
String |
WIFI_WATCHDOG_PING_COUNT
This constant was deprecated in API level 14. This setting is not used. |
String |
WIFI_WATCHDOG_PING_DELAY_MS
This constant was deprecated in API level 14. This setting is not used. |
String |
WIFI_WATCHDOG_PING_TIMEOUT_MS
This constant was deprecated in API level 14. This setting is not used. |
String |
WIFI_WATCHDOG_WATCH_LIST
This constant was deprecated in API level 14. This setting is not used. |
Inherited constants |
---|
From
class
android.provider.Settings.NameValueTable
|
From
interface
android.provider.BaseColumns
|
Fields | |
---|---|
public
static
final
Uri |
CONTENT_URI
The content:// style URL for this table |
Public constructors | |
---|---|
Settings.Secure()
|
Public methods | |
---|---|
static
float
|
getFloat(ContentResolver cr, String name, float def)
Convenience function for retrieving a single secure settings value as a floating point number. |
static
float
|
getFloat(ContentResolver cr, String name)
Convenience function for retrieving a single secure settings value as a float. |
static
int
|
getInt(ContentResolver cr, String name, int def)
Convenience function for retrieving a single secure settings value as an integer. |
static
int
|
getInt(ContentResolver cr, String name)
Convenience function for retrieving a single secure settings value as an integer. |
static
long
|
getLong(ContentResolver cr, String name)
Convenience function for retrieving a single secure settings value
as a |
static
long
|
getLong(ContentResolver cr, String name, long def)
Convenience function for retrieving a single secure settings value
as a |
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
final
boolean
|
isLocationProviderEnabled(ContentResolver cr, String provider)
This method was deprecated
in API level 19.
use |
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 secure settings value as a long integer. |
static
boolean
|
putString(ContentResolver resolver, String name, String value)
Store a name/value pair into the database. |
static
final
void
|
setLocationProviderEnabled(ContentResolver cr, String provider, boolean enabled)
This method was deprecated
in API level 19.
use |
Inherited methods | |
---|---|
From
class
android.provider.Settings.NameValueTable
| |
From
class
java.lang.Object
|
String ACCESSIBILITY_DISPLAY_INVERSION_ENABLED
Setting that specifies whether display color inversion is enabled.
Constant Value: "accessibility_display_inversion_enabled"
String ACCESSIBILITY_ENABLED
If accessibility is enabled.
Constant Value: "accessibility_enabled"
String ACCESSIBILITY_SPEAK_PASSWORD
Whether to speak passwords while in accessibility mode.
Constant Value: "speak_password"
String ADB_ENABLED
This constant was deprecated
in API level 17.
Use ADB_ENABLED
instead
Constant Value: "adb_enabled"
String ALLOWED_GEOLOCATION_ORIGINS
Origins for which browsers should allow geolocation by default. The value is a space-separated list of origins.
Constant Value: "allowed_geolocation_origins"
String ALLOW_MOCK_LOCATION
This constant was deprecated
in API level 23.
This settings is not used anymore.
Setting to allow mock locations and location provider status to be injected into the LocationManager service for testing purposes during application development. These locations and status values override actual location and status information generated by network, gps, or other location providers.
Constant Value: "mock_location"
String ANDROID_ID
A 64-bit number (as a hex string) that is randomly generated when the user first sets up the device and should remain constant for the lifetime of the user's device. The value may change if a factory reset is performed on the device.
Note: When a device has multiple users
(available on certain devices running Android 4.2 or higher), each user appears as a
completely separate device, so the ANDROID_ID
value is unique to each
user.
Constant Value: "android_id"
String BACKGROUND_DATA
This constant was deprecated
in API level 14.
As of ICE_CREAM_SANDWICH
,
availability of background data depends on several
combined factors. When background data is unavailable,
getActiveNetworkInfo()
will
now appear disconnected.
Whether background data usage is allowed.
Constant Value: "background_data"
String BLUETOOTH_ON
This constant was deprecated
in API level 17.
Use BLUETOOTH_ON
instead
Constant Value: "bluetooth_on"
String DATA_ROAMING
This constant was deprecated
in API level 17.
Use DATA_ROAMING
instead
Constant Value: "data_roaming"
String DEFAULT_INPUT_METHOD
Setting to record the input method used by default, holding the ID of the desired method.
Constant Value: "default_input_method"
String DEVELOPMENT_SETTINGS_ENABLED
This constant was deprecated
in API level 17.
Use DEVELOPMENT_SETTINGS_ENABLED
instead
Constant Value: "development_settings_enabled"
String DEVICE_PROVISIONED
This constant was deprecated
in API level 17.
Use DEVICE_PROVISIONED
instead
Constant Value: "device_provisioned"
String ENABLED_ACCESSIBILITY_SERVICES
List of the enabled accessibility providers.
Constant Value: "enabled_accessibility_services"
String ENABLED_INPUT_METHODS
List of input methods that are currently enabled. This is a string containing the IDs of all enabled input methods, each ID separated by ':'.
Constant Value: "enabled_input_methods"
String HTTP_PROXY
This constant was deprecated
in API level 17.
Use HTTP_PROXY
Host name and port for global http proxy. Uses ':' seperator for between host and port.
Constant Value: "http_proxy"
String INPUT_METHOD_SELECTOR_VISIBILITY
Setting to record the visibility of input method selector
Constant Value: "input_method_selector_visibility"
String INSTALL_NON_MARKET_APPS
Whether applications can be installed for this user via the system's
ACTION_INSTALL_PACKAGE
mechanism.
1 = permit app installation via the system package installer intent
0 = do not allow use of the package installer
Constant Value: "install_non_market_apps"
String LOCATION_MODE
The degree of location access enabled by the user.
When used with putInt(ContentResolver, String, int)
, must be one of LOCATION_MODE_HIGH_ACCURACY
, LOCATION_MODE_SENSORS_ONLY
, LOCATION_MODE_BATTERY_SAVING
, or LOCATION_MODE_OFF
. When used with getInt(ContentResolver, String)
, the caller must gracefully handle additional location
modes that might be added in the future.
Note: do not rely on this value being present in settings.db or on ContentObserver
notifications for the corresponding Uri. Use MODE_CHANGED_ACTION
to receive changes in this value.
Constant Value: "location_mode"
int LOCATION_MODE_BATTERY_SAVING
Reduced power usage, such as limiting the number of GPS updates per hour. Requests
with POWER_HIGH
may be downgraded to
POWER_MEDIUM
.
Constant Value: 2 (0x00000002)
int LOCATION_MODE_HIGH_ACCURACY
Best-effort location computation allowed.
Constant Value: 3 (0x00000003)
int LOCATION_MODE_OFF
Location access disabled.
Constant Value: 0 (0x00000000)
int LOCATION_MODE_SENSORS_ONLY
Network Location Provider disabled, but GPS and other sensors enabled.
Constant Value: 1 (0x00000001)
String LOCATION_PROVIDERS_ALLOWED
This constant was deprecated
in API level 19.
use LOCATION_MODE
and
MODE_CHANGED_ACTION
(or
PROVIDERS_CHANGED_ACTION
)
Comma-separated list of location providers that activities may access. Do not rely on this value being present in settings.db or on ContentObserver notifications on the corresponding Uri.
Constant Value: "location_providers_allowed"
String LOCK_PATTERN_ENABLED
This constant was deprecated
in API level 23.
Use KeyguardManager
to determine the state and security
level of the keyguard. Accessing this setting from an app that is targeting
M
or later throws a SecurityException
.
Whether autolock is enabled (0 = false, 1 = true)
Constant Value: "lock_pattern_autolock"
String LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED
This constant was deprecated
in API level 17.
Starting in JELLY_BEAN_MR1
the
lockscreen uses
HAPTIC_FEEDBACK_ENABLED
.
Accessing this setting from an app that is targeting
M
or later throws a SecurityException
.
Whether lock pattern will vibrate as user enters (0 = false, 1 = true)
Constant Value: "lock_pattern_tactile_feedback_enabled"
String LOCK_PATTERN_VISIBLE
This constant was deprecated
in API level 23.
Accessing this setting from an app that is targeting
M
or later throws a SecurityException
.
Whether lock pattern is visible as user enters (0 = false, 1 = true)
Constant Value: "lock_pattern_visible_pattern"
String LOGGING_ID
This constant was deprecated
in API level 3.
This identifier is poorly initialized and has
many collisions. It should not be used.
The Logging ID (a unique 64-bit value) as a hex string. Used as a pseudonymous identifier for logging.
Constant Value: "logging_id"
String NETWORK_PREFERENCE
This constant was deprecated
in API level 17.
Use NETWORK_PREFERENCE
instead
Constant Value: "network_preference"
String PARENTAL_CONTROL_ENABLED
No longer supported.
Constant Value: "parental_control_enabled"
String PARENTAL_CONTROL_LAST_UPDATE
No longer supported.
Constant Value: "parental_control_last_update"
String PARENTAL_CONTROL_REDIRECT_URL
No longer supported.
Constant Value: "parental_control_redirect_url"
String SELECTED_INPUT_METHOD_SUBTYPE
Setting to record the input method subtype used by default, holding the ID of the desired method.
Constant Value: "selected_input_method_subtype"
String SETTINGS_CLASSNAME
Settings classname to launch when Settings is clicked from All Applications. Needed because of user testing between the old and new Settings apps.
Constant Value: "settings_classname"
String SKIP_FIRST_USE_HINTS
If enabled, apps should try to skip any introductory hints on first launch. This might apply to users that are already familiar with the environment or temporary users.
Type : int (0 to show hints, 1 to skip showing hints)
Constant Value: "skip_first_use_hints"
String TOUCH_EXPLORATION_ENABLED
If touch exploration is enabled.
Constant Value: "touch_exploration_enabled"
String TTS_DEFAULT_COUNTRY
This constant was deprecated
in API level 14.
this setting is no longer in use, as of the Ice Cream
Sandwich release. Apps should never need to read this setting directly,
instead can query the TextToSpeech framework classes for the default
locale. getLanguage()
.
Default text-to-speech country.
Constant Value: "tts_default_country"
String TTS_DEFAULT_LANG
This constant was deprecated
in API level 14.
this setting is no longer in use, as of the Ice Cream
Sandwich release. Apps should never need to read this setting directly,
instead can query the TextToSpeech framework classes for the default
locale. getLanguage()
.
Default text-to-speech language.
Constant Value: "tts_default_lang"
String TTS_DEFAULT_PITCH
Default text-to-speech engine pitch. 100 = 1x
Constant Value: "tts_default_pitch"
String TTS_DEFAULT_RATE
Default text-to-speech engine speech rate. 100 = 1x
Constant Value: "tts_default_rate"
String TTS_DEFAULT_SYNTH
Default text-to-speech engine.
Constant Value: "tts_default_synth"
String TTS_DEFAULT_VARIANT
This constant was deprecated
in API level 14.
this setting is no longer in use, as of the Ice Cream
Sandwich release. Apps should never need to read this setting directly,
instead can query the TextToSpeech framework classes for the
locale that is in use getLanguage()
.
Default text-to-speech locale variant.
Constant Value: "tts_default_variant"
String TTS_ENABLED_PLUGINS
Space delimited list of plugin packages that are enabled.
Constant Value: "tts_enabled_plugins"
String TTS_USE_DEFAULTS
This constant was deprecated
in API level 14.
The value of this setting is no longer respected by
the framework text to speech APIs as of the Ice Cream Sandwich release.
Setting to always use the default text-to-speech settings regardless of the application settings. 1 = override application settings, 0 = use application settings (if specified).
Constant Value: "tts_use_defaults"
String USB_MASS_STORAGE_ENABLED
This constant was deprecated
in API level 17.
Use USB_MASS_STORAGE_ENABLED
instead
Constant Value: "usb_mass_storage_enabled"
String USE_GOOGLE_MAIL
This constant was deprecated
in API level 17.
Use USE_GOOGLE_MAIL
instead
Constant Value: "use_google_mail"
String WIFI_MAX_DHCP_RETRY_COUNT
This constant was deprecated
in API level 17.
Use
WIFI_MAX_DHCP_RETRY_COUNT
instead
Constant Value: "wifi_max_dhcp_retry_count"
String WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS
This constant was deprecated
in API level 17.
Use
WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS
instead
Constant Value: "wifi_mobile_data_transition_wakelock_timeout_ms"
String WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON
This constant was deprecated
in API level 17.
Use WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON
instead.
Constant Value: "wifi_networks_available_notification_on"
String WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY
This constant was deprecated
in API level 17.
Use WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY
instead.
Constant Value: "wifi_networks_available_repeat_delay"
String WIFI_NUM_OPEN_NETWORKS_KEPT
This constant was deprecated
in API level 17.
Use WIFI_NUM_OPEN_NETWORKS_KEPT
instead.
Constant Value: "wifi_num_open_networks_kept"
String WIFI_ON
This constant was deprecated
in API level 17.
Use WIFI_ON
instead.
Constant Value: "wifi_on"
String WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE
This constant was deprecated
in API level 14.
This setting is not used.
The acceptable packet loss percentage (range 0 - 100) before trying another AP on the same network.
Constant Value: "wifi_watchdog_acceptable_packet_loss_percentage"
String WIFI_WATCHDOG_AP_COUNT
This constant was deprecated
in API level 14.
This setting is not used.
The number of access points required for a network in order for the watchdog to monitor it.
Constant Value: "wifi_watchdog_ap_count"
String WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS
This constant was deprecated
in API level 14.
This setting is not used.
The delay between background checks.
Constant Value: "wifi_watchdog_background_check_delay_ms"
String WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED
This constant was deprecated
in API level 14.
This setting is not used.
Whether the Wi-Fi watchdog is enabled for background checking even after it thinks the user has connected to a good access point.
Constant Value: "wifi_watchdog_background_check_enabled"
String WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS
This constant was deprecated
in API level 14.
This setting is not used.
The timeout for a background ping
Constant Value: "wifi_watchdog_background_check_timeout_ms"
String WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT
This constant was deprecated
in API level 14.
This setting is not used.
The number of initial pings to perform that *may* be ignored if they fail. Again, if these fail, they will *not* be used in packet loss calculation. For example, one network always seemed to time out for the first couple pings, so this is set to 3 by default.
Constant Value: "wifi_watchdog_initial_ignored_ping_count"
String WIFI_WATCHDOG_MAX_AP_CHECKS
This constant was deprecated
in API level 14.
This setting is not used.
The maximum number of access points (per network) to attempt to test. If this number is reached, the watchdog will no longer monitor the initial connection state for the network. This is a safeguard for networks containing multiple APs whose DNS does not respond to pings.
Constant Value: "wifi_watchdog_max_ap_checks"
String WIFI_WATCHDOG_ON
This constant was deprecated
in API level 17.
Use WIFI_WATCHDOG_ON
instead
Constant Value: "wifi_watchdog_on"
String WIFI_WATCHDOG_PING_COUNT
This constant was deprecated
in API level 14.
This setting is not used.
The number of pings to test if an access point is a good connection.
Constant Value: "wifi_watchdog_ping_count"
String WIFI_WATCHDOG_PING_DELAY_MS
This constant was deprecated
in API level 14.
This setting is not used.
The delay between pings.
Constant Value: "wifi_watchdog_ping_delay_ms"
String WIFI_WATCHDOG_PING_TIMEOUT_MS
This constant was deprecated
in API level 14.
This setting is not used.
The timeout per ping.
Constant Value: "wifi_watchdog_ping_timeout_ms"
String WIFI_WATCHDOG_WATCH_LIST
This constant was deprecated
in API level 14.
This setting is not used.
A comma-separated list of SSIDs for which the Wi-Fi watchdog should be enabled.
Constant Value: "wifi_watchdog_watch_list"
float getFloat (ContentResolver cr, String name, float def)
Convenience function for retrieving a single secure 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. |
float getFloat (ContentResolver cr, String name)
Convenience function for retrieving a single secure 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 |
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. |
int getInt (ContentResolver cr, String name, int def)
Convenience function for retrieving a single secure 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. |
int getInt (ContentResolver cr, String name)
Convenience function for retrieving a single secure 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 |
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. |
long getLong (ContentResolver cr, String name)
Convenience function for retrieving a single secure 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 |
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. |
long getLong (ContentResolver cr, String name, long def)
Convenience function for retrieving a single secure 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 .
|
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 |
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 |
boolean isLocationProviderEnabled (ContentResolver cr, String provider)
This method was deprecated
in API level 19.
use LOCATION_MODE
or
isProviderEnabled(String)
Helper method for determining if a location provider is enabled.
Parameters | |
---|---|
cr |
ContentResolver :
the content resolver to use |
provider |
String :
the location provider to query |
Returns | |
---|---|
boolean |
true if the provider is enabled |
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 |
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 |
boolean putLong (ContentResolver cr, String name, long value)
Convenience function for updating a secure 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 |
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 |
void setLocationProviderEnabled (ContentResolver cr, String provider, boolean enabled)
This method was deprecated
in API level 19.
use putInt(ContentResolver, String, int)
and LOCATION_MODE
Thread-safe method for enabling or disabling a single location provider.
Parameters | |
---|---|
cr |
ContentResolver :
the content resolver to use |
provider |
String :
the location provider to enable or disable |
enabled |
boolean :
true if the provider should be enabled |