IT. Expert System.

public class PreferenceManager
extends Object

See Also:

PreferenceActivity

• Nested Class Summary

  Nested Classes

  Modifier and Type	Class and Description
  static interface	PreferenceManager.OnActivityDestroyListener Interface definition for a class that will be called when the container's activity is destroyed.
  static interface	PreferenceManager.OnActivityResultListener Interface definition for a class that will be called when the container's activity receives an activity result.
  static interface	PreferenceManager.OnActivityStopListener Interface definition for a class that will be called when the container's activity is stopped.

• Field Summary

  Fields

  Modifier and Type	Field and Description
  static String	KEY_HAS_SET_DEFAULT_VALUES
  static String	METADATA_KEY_PREFERENCES The Activity meta-data key for its XML preference hierarchy.

• Method Summary

  Methods

  Modifier and Type	Method and Description
  PreferenceScreen	createPreferenceScreen(Context context)
  Preference	findPreference(CharSequence key) Finds a Preference based on its key.
  static SharedPreferences	getDefaultSharedPreferences(Context context) Gets a SharedPreferences instance that points to the default file that is used by the preference framework in the given context.
  SharedPreferences	getSharedPreferences() Gets a SharedPreferences instance that preferences managed by this will use.
  int	getSharedPreferencesMode() Returns the current mode of the SharedPreferences file that preferences managed by this will use.
  String	getSharedPreferencesName() Returns the current name of the SharedPreferences file that preferences managed by this will use.
  PreferenceScreen	inflateFromResource(Context context, int resId, PreferenceScreen rootPreferences) Inflates a preference hierarchy from XML.
  static void	setDefaultValues(Context context, int resId, boolean readAgain) Sets the default values from an XML preference file by reading the values defined by each Preference item's android:defaultValue attribute.
  static void	setDefaultValues(Context context, String sharedPreferencesName, int sharedPreferencesMode, int resId, boolean readAgain) Similar to setDefaultValues(Context, int, boolean) but allows the client to provide the filename and mode of the shared preferences file.
  void	setSharedPreferencesMode(int sharedPreferencesMode) Sets the mode of the SharedPreferences file that preferences managed by this will use.
  void	setSharedPreferencesName(String sharedPreferencesName) Sets the name of the SharedPreferences file that preferences managed by this will use.

  • Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

• Field Detail

  • METADATA_KEY_PREFERENCES

    public static final String METADATA_KEY_PREFERENCES

    The Activity meta-data key for its XML preference hierarchy.

    See Also:

    Constant Field Values

  • KEY_HAS_SET_DEFAULT_VALUES

    public static final String KEY_HAS_SET_DEFAULT_VALUES

    See Also:

    Constant Field Values

• Method Detail

  • inflateFromResource

    public PreferenceScreen inflateFromResource(Context context,
                                       int resId,
                                       PreferenceScreen rootPreferences)

    Inflates a preference hierarchy from XML. If a preference hierarchy is given, the new preference hierarchies will be merged in.

    Parameters:

    context - The context of the resource.

    resId - The resource ID of the XML to inflate.

    rootPreferences - Optional existing hierarchy to merge the new hierarchies into.

    Returns:

    The root hierarchy (if one was not provided, the new hierarchy's root).

  • createPreferenceScreen

    public PreferenceScreen createPreferenceScreen(Context context)

  • getSharedPreferencesName

    public String getSharedPreferencesName()

    Returns the current name of the SharedPreferences file that preferences managed by this will use.

    Returns:

    The name that can be passed to Context.getSharedPreferences(String, int).

    See Also:

    Context.getSharedPreferences(String, int)

  • setSharedPreferencesName

    public void setSharedPreferencesName(String sharedPreferencesName)

    Sets the name of the SharedPreferences file that preferences managed by this will use.

    Parameters:

    sharedPreferencesName - The name of the SharedPreferences file.

    See Also:

    Context.getSharedPreferences(String, int)

  • getSharedPreferencesMode

    public int getSharedPreferencesMode()

    Returns the current mode of the SharedPreferences file that preferences managed by this will use.

    Returns:

    The mode that can be passed to Context.getSharedPreferences(String, int).

    See Also:

    Context.getSharedPreferences(String, int)

  • setSharedPreferencesMode

    public void setSharedPreferencesMode(int sharedPreferencesMode)

    Sets the mode of the SharedPreferences file that preferences managed by this will use.

    Parameters:

    sharedPreferencesMode - The mode of the SharedPreferences file.

    See Also:

    Context.getSharedPreferences(String, int)

  • getSharedPreferences

    public SharedPreferences getSharedPreferences()

    Gets a SharedPreferences instance that preferences managed by this will use.

    Returns:

    A SharedPreferences instance pointing to the file that contains the values of preferences that are managed by this.

  • getDefaultSharedPreferences

    public static SharedPreferences getDefaultSharedPreferences(Context context)

    Gets a SharedPreferences instance that points to the default file that is used by the preference framework in the given context.

    Parameters:

    context - The context of the preferences whose values are wanted.

    Returns:

    A SharedPreferences instance that can be used to retrieve and listen to values of the preferences.

  • findPreference

    public Preference findPreference(CharSequence key)

    Finds a Preference based on its key.

    Parameters:

    key - The key of the preference to retrieve.

    Returns:

    The Preference with the key, or null.

    See Also:

    PreferenceGroup.findPreference(CharSequence)

  • setDefaultValues

    public static void setDefaultValues(Context context,
                        int resId,
                        boolean readAgain)

    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.

    Parameters:

    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 getDefaultSharedPreferences(Context) and clear it followed by a call to this method with this parameter set to true.

  • setDefaultValues

    public static void setDefaultValues(Context context,
                        String sharedPreferencesName,
                        int sharedPreferencesMode,
                        int resId,
                        boolean readAgain)

    Similar to setDefaultValues(Context, int, boolean) but allows the client to provide the filename and mode of the shared preferences file.

    Parameters:

    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 Context.MODE_PRIVATE or Context.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 getDefaultSharedPreferences(Context) and clear it followed by a call to this method with this parameter set to true.

    See Also:

    setDefaultValues(Context, int, boolean), setSharedPreferencesName(String), setSharedPreferencesMode(int)