Represents a top-level Android.Preferences.Preference that is the root of a Preference hierarchy. A Android.Preferences.PreferenceActivity points to an instance of this class to show the preferences. To instantiate this class, use PreferenceManager.CreatePreferenceScreen(Android.Content.Context).

• When a Android.Preferences.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 Android.App.Dialog or via a Android.Content.Context.StartActivity(Android.Content.Intent) from the Preference.Intent). The children of this Android.Preferences.PreferenceScreen are NOT shown in the screen that this Android.Preferences.PreferenceScreen is shown in. Instead, a separate screen will be shown when this preference is clicked.

Here's an example XML layout of a PreferenceScreen:

<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 Android.Preferences.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).

Developer Guides

For information about building a settings UI with Preferences, read the Settings guide.

See Also

• Android.Preferences.PreferenceCategory

[Android Documentation]