java.lang.Object | |
↳ | android.preference.PreferenceManager |
Used to help create Preference
hierarchies from activities or XML.
In most cases, clients should use addPreferencesFromIntent(Intent)
or addPreferencesFromResource(int)
.
Nested Classes | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
PreferenceManager.OnActivityDestroyListener | Interface definition for a class that will be called when the container's activity is destroyed. | |||||||||
|
PreferenceManager.OnActivityResultListener | Interface definition for a class that will be called when the container's activity receives an activity result. | |||||||||
|
PreferenceManager.OnActivityStopListener | Interface definition for a class that will be called when the container's activity is stopped. |
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
String | KEY_HAS_SET_DEFAULT_VALUES | ||||||||||
String | METADATA_KEY_PREFERENCES | The Activity meta-data key for its XML preference hierarchy. |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|||||||||
|
|
Finds a
Preference based on its key.
|
|||||||||
|
|
Gets a SharedPreferences instance that points to the default file that is used by the preference framework in the given context.
|
|||||||||
|
|
Gets a SharedPreferences instance that preferences managed by this will use.
|
|||||||||
|
|
Returns the current mode of the SharedPreferences file that preferences managed by this will use.
|
|||||||||
|
|
Returns the current name of the SharedPreferences file that preferences managed by this will use.
|
|||||||||
|
|
Similar to
setDefaultValues(Context, int, boolean) but allows the client to provide the filename and mode of the shared preferences file.
|
|||||||||
|
|
Sets the default values from an XML preference file by reading the values defined by each
Preference item's
android:defaultValue attribute.
|
|||||||||
|
|
Sets the mode of the SharedPreferences file that preferences managed by this will use.
|
|||||||||
|
|
Sets the name of the SharedPreferences file that preferences managed by this will use.
|
[Expand]
Inherited Methods
|
|||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
![]() |
The Activity meta-data key for its XML preference hierarchy.
Finds a Preference
based on its key.
key | The key of the preference to retrieve. |
---|
Preference
with the key, or null.Gets a SharedPreferences instance that points to the default file that is used by the preference framework in the given context.
context | The context of the preferences whose values are wanted. |
---|
Gets a SharedPreferences instance that preferences managed by this will use.
Returns the current mode of the SharedPreferences file that preferences managed by this will use.
getSharedPreferences(String, int)
.Returns the current name of the SharedPreferences file that preferences managed by this will use.
getSharedPreferences(String, int)
.Similar to setDefaultValues(Context, int, boolean)
but allows the client to provide the filename and mode of the shared preferences file.
context | The context of the shared preferences. |
---|---|
sharedPreferencesName | A custom name for the shared preferences file. |
sharedPreferencesMode | The file creation mode for the shared preferences file, such as MODE_PRIVATE or MODE_PRIVATE |
resId | The resource ID of the preference XML file. |
readAgain | Whether to re-read the default values. If false, this method will set the default values only if this method has never been called in the past (or if the KEY_HAS_SET_DEFAULT_VALUES in the default value shared preferences file is false). To attempt to set the default values again bypassing this check, set readAgain to true. Note: this will NOT reset preferences back to their default values. For that functionality, use |
Sets the default values from an XML preference file by reading the values defined by each Preference
item's android:defaultValue
attribute. This should be called by the application's main activity.
context | The context of the shared preferences. |
---|---|
resId | The resource ID of the preference XML file. |
readAgain | Whether to re-read the default values. If false, this method sets the default values only if this method has never been called in the past (or if the KEY_HAS_SET_DEFAULT_VALUES in the default value shared preferences file is false). To attempt to set the default values again bypassing this check, set readAgain to true. Note: this will NOT reset preferences back to their default values. For that functionality, use |
Sets the mode of the SharedPreferences file that preferences managed by this will use.
sharedPreferencesMode | The mode of the SharedPreferences file. |
---|
Sets the name of the SharedPreferences file that preferences managed by this will use.
sharedPreferencesName | The name of the SharedPreferences file. |
---|