Android
android.preference
public final class

android.preference.PreferenceScreen

java.lang.Object
android.preference.Preference Comparable<T>
android.preference.PreferenceGroup
android.preference.PreferenceScreen DialogInterface.OnDismissListener AdapterView.OnItemClickListener

The PreferenceScreen class represents a top-level Preference that is the root of a Preference hierarchy. A PreferenceActivity points to an instance of this class to show the preferences. To instantiate this class, use createPreferenceScreen(Context).

This class can appear in two places:

  • When a PreferenceActivity points to this, it is used as the root and is not shown (only the contained preferences are shown).
  • When it appears inside another preference hierarchy, it is shown and serves as the gateway to another screen of preferences (either by showing another screen of preferences as a Dialog or via a startActivity(android.content.Intent) from the getIntent()). The children of this PreferenceScreen are NOT shown in the screen that this PreferenceScreen is shown in. Instead, a separate screen will be shown when this preference is clicked.

    <PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android" android:key="first_preferencescreen"> <CheckBoxPreference android:key="wifi enabled" android:title="WiFi" /> <PreferenceScreen android:key="second_preferencescreen" android:title="WiFi settings"> <CheckBoxPreference android:key="prefer wifi" android:title="Prefer WiFi" /> ... other preferences here ... </PreferenceScreen> </PreferenceScreen> In this example, the "first_preferencescreen" will be used as the root of the hierarchy and given to a PreferenceActivity. The first screen will show preferences "WiFi" (which can be used to quickly enable/disable WiFi) and "WiFi settings". The "WiFi settings" is the "second_preferencescreen" and when clicked will show another screen of preferences such as "Prefer WiFi" (and the other preferences that are children of the "second_preferencescreen" tag).

  • Summary

    XML Attributes inherited from class android.preference.PreferenceGroup
    XML Attributes inherited from class android.preference.Preference
    Constants inherited from class android.preference.Preference

    Public Methods

              void  bind(ListView listView)
    Binds a ListView to the preferences contained in this PreferenceScreen via getRootAdapter().
              Dialog  getDialog()
    Used to get a handle to the dialog.
              ListAdapter  getRootAdapter()
    Returns an adapter that can be attached to a PreferenceActivity to show the preferences contained in this PreferenceScreen.
              void  onDismiss(DialogInterface dialog)
    This method will be invoked when the dialog is dismissed.
              void  onItemClick(AdapterView parent, View view, int position, long id)

    Protected Methods

              boolean  isOnSameScreenAsChildren()
    Whether this preference group should be shown on the same screen as its contained preferences.
              void  onClick()
    Processes a click on the preference.
              ListAdapter  onCreateRootAdapter()
    Creates the root adapter.
              void  onRestoreInstanceState(Parcelable state)
    Hook allowing a preference to re-apply a representation of its internal state that had previously been generated by onSaveInstanceState().
              Parcelable  onSaveInstanceState()
    Hook allowing a preference to generate a representation of its internal state that can later be used to create a new instance with that same state.
    Methods inherited from class android.preference.PreferenceGroup
    Methods inherited from class android.preference.Preference
    Methods inherited from class java.lang.Object
    Methods inherited from interface android.content.DialogInterface.OnDismissListener
    Methods inherited from interface android.widget.AdapterView.OnItemClickListener
    Methods inherited from interface java.lang.Comparable

    Details

    Public Methods

    public void bind(ListView listView)

    Binds a ListView to the preferences contained in this PreferenceScreen via getRootAdapter(). It also handles passing list item clicks to the corresponding Preference contained by this PreferenceScreen.

    Parameters

    listView The list view to attach to.

    public Dialog getDialog()

    Used to get a handle to the dialog. This is useful for cases where we want to manipulate the dialog as we would with any other activity or view.

    public ListAdapter getRootAdapter()

    Returns an adapter that can be attached to a PreferenceActivity to show the preferences contained in this PreferenceScreen.

    This PreferenceScreen will NOT appear in the returned adapter, instead it appears in the hierarchy above this PreferenceScreen.

    This adapter's getItem(int) should always return a subclass of Preference.

    Returns

    public void onDismiss(DialogInterface dialog)

    This method will be invoked when the dialog is dismissed.

    public void onItemClick(AdapterView parent, View view, int position, long id)

    Protected Methods

    protected boolean isOnSameScreenAsChildren()

    Whether this preference group should be shown on the same screen as its contained preferences.

    Returns

    • True if the contained preferences should be shown on the same screen as this preference.

    protected void onClick()

    Processes a click on the preference. This includes saving the value to the SharedPreferences. However, the overridden method should call callChangeListener(Object) to make sure the client wants to update the preference's state with the new value.

    protected ListAdapter onCreateRootAdapter()

    Creates the root adapter.

    Returns

    See Also

    protected void onRestoreInstanceState(Parcelable state)

    Hook allowing a preference to re-apply a representation of its internal state that had previously been generated by onSaveInstanceState(). This function will never be called with a null icicle.

    Parameters

    state The frozen state that had previously been returned by onSaveInstanceState().

    protected Parcelable onSaveInstanceState()

    Hook allowing a preference to generate a representation of its internal state that can later be used to create a new instance with that same state. This state should only contain information that is not persistent or can be reconstructed later.

    Returns

    • Returns a Parcelable object containing the preference's current dynamic state, or null if there is nothing interesting to save. The default implementation returns null.
    Copyright 2007 Google Inc. Build 0.9_r1-98467 - 14 Aug 2008 18:56