android设置中常用的PreferenceActivity用法介绍

PreferenceActivity它包含了许多类似控件的东西来表示不同的设置需求如分类设置，选择框设置，下拉列表设置，编辑框设置，铃声设置，而且这些设置不需要我们自己来保存用户设置的数据，它自己会将数据保存在xml文件当中。下面是PreferenceActivity中各个组件的介绍。

1. PreferenceScreen：设置页面，可嵌套形成二级设置页面，用Title参数设置标题。

Preferencescreen中启动activity
例如wireless_setting.xml中有如下片段

<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:settings="http://schemas.android.com/apk/res/com.seedshope.android">
    <PreferenceScreen
        android:key="wifi_settings"
        android:title="@string/wifi_settings"
        android:summary="@string/wifi_settings_summary" >
        <intent
            android:action="android.intent.action.MAIN"
            android:targetPackage="com.android.settings"
            android:targetClass="com.android.settings.wifi.WifiSettings" />
    </PreferenceScreen>
</PreferenceScreen>

其中com.android.settings是工程的包名，com.android.settings.wifi.WifiSettings是要启动的类。
一般情况下，这样就ok了，点击对应的Preference就能够启动对应的activity，然而仅仅这样有时这样，并不一定能够启动对应的activity，因为它与回调函数onPreferenceTreeClick有关，有时候我们会重写这个方法如：

public boolean onPreferenceTreeClick(PreferenceScreen preferenceScreen, Preference preference) {
       if ( (preference == mAirplaneModePreference) &&
                (Boolean.parseBoolean(
                    SystemProperties.get(TelephonyProperties.PROPERTY_INECM_MODE))) ) {
            // In ECM mode launch ECM app dialog
           startActivityForResult(
                new Intent(TelephonyIntents.ACTION_SHOW_NOTICE_ECM_BLOCK_OTHERS, null),
                REQUEST_CODE_EXIT_ECM);
            return true;
        }
        else {
            // Let the intents be launched by the Preference manager
            return false;
       }
    }

其中WirelessSetting.java中有如上函数,当返回值为true时,你怎么点击Preference都不会跳转到activity的，只有等到它的返回值为false的时候，才可以正常跳转，因为点击某一个Preference的真正实现在Preference.java的performClick函数中如下：

void performClick(PreferenceScreen preferenceScreen) {
        
        if (!isEnabled()) {
            return;
        }
        
        onClick();
        
        if (mOnClickListener != null && mOnClickListener.onPreferenceClick(this)) {
            return;
        }
        
        PreferenceManager preferenceManager = getPreferenceManager();
        if (preferenceManager != null) {
            PreferenceManager.OnPreferenceTreeClickListener listener = preferenceManager
                    .getOnPreferenceTreeClickListener();
            if (preferenceScreen != null && listener != null
                    && listener.onPreferenceTreeClick(preferenceScreen, this)) {
                return;
            }
        }
        
        if (mIntent != null) {
            Context context = getContext();
            context.startActivity(mIntent);
        }
    }

当点击某个Preference时的调用流程是AdapterView.performItemClick－－》PreferenceScreen.onItemClick－－》Preference.performClick－－》PreferenceActivity.onPreferenceTreeClick，当onPreferenceTreeClick返回true的时候就直接return了，没有走下面启动activity的地方了，因此要使一个Preference能够正常跳转到另外一个activity有两个条件，一是xml里面是否设置正确，第二是调用该xml的java类是否在onPreferenceTreeClick这个函数需要返回false。

2. PreferenceCategory：某一类相关的设置，可用Title参数设置标题，相当于一个分界线的东西一样，它的上面和下面分别属于不同类型的设置。

3. CheckBoxPreference：是一个CheckBox设置，只有两种值，true或false，可用Title参数设置标题，用summaryOn和summaryOff参数来设置控件选中和未选中时的提示，可以用defaultValue设置缺省值。

4. ListPreference：下拉框选择控件，用Title参数设置标题，用Summary参数设置说明，点击后出现下拉框，用dialogTitle设置下拉框的标题，下拉框内显示的内容和具体的值需要在res/values/array.xml中设置两个array来表示，entries和entryValues分别表示显示的值和代码中获取的真正的值。例如array.xml设置如下：    

<?xml version ="1.0" encoding ="utf-8" ?>
<resources>
<string-array name ="entries_list_preference" >
    <item> test1</item>
    <item> test2</item>
    <item> test3</item>
</string-array>
<string-array name ="entriesvalue_list_preference" >
    <item> 1</item>
    <item> 2</item>
    <item> 3</item>
</string-array>
</resources>

5. EditTextPreference：输入框控件，点击后可输入字符串设置。用Title参数设置标题，Summary参数设置说明，dialogTitle参数设置输入框的标题。

6. RingtonePreference：铃声选择框，点击后可选择系统铃声。Title参数设置标题，Summary参数设置说明，dialogTitle参数设置铃声选择框的标题。

7. 以上是PreferenceActivity的xml描述，那么在程序中我们只需要新建一个继承自PreferenceActivity的 Activity，然后在主程序中调用就可以了。这个PreferenceActivity中的设置存储是完全自动的，你不需要再用代码去实现设置的存储，PreferenceActivity创建后会自动创建一个配置文件/data/data/your_package_name /shared_prefs/(your_package_name)_preferences.xml。自动生成的配置文件如下：

<?xml version ='1.0' encoding ='utf-8' standalone ='yes' ?>
<map>
<string name ="EditTextPreference" >12332312</string>
<string name ="ListPreference" >2</string>
<string name ="RingtonePreference" >content://media/internal/audio/media/10</string>
<boolean name ="CheckBox1" value ="true" />
<boolean name ="CheckBox2" value ="true" />
</map>

文件中的name属性对应xml文件中的key属性表示某一个设置项，值是唯一的，value以及string中间的值表示设置项的具体值。

以下为AdwLauncher的一些配置:

<PreferenceScreen
		android:key="screenPreferences"
		android:title="@string/pref_title_screen_preferences"
		android:summary="@string/pref_summary_screen_preferences">
		<CheckBoxPreference android:title="@string/pref_title_hide_statusbar"
			android:defaultValue="false"
			android:summary="@string/pref_summary_hide_statusbar"
			android:key="hideStatusbar" />
		<CheckBoxPreference android:title="@string/pref_title_wallpaper_scrolling"
			android:defaultValue="@bool/config_wallpaper_scroll"
			android:summary="@string/pref_summary_wallpaper_scrolling"
			android:key="wallpaper_scrolling" />
		<PreferenceCategory
			android:title="@string/pref_title_screens_layout_preferencecategory">
			<CheckBoxPreference android:key="uiHideLabels"
				android:title="@string/pref_title_hide_icon_labels"
				android:summary="@string/pref_summary_hide_icon_labels"
				android:defaultValue="false" />
			<CheckBoxPreference android:title="@string/pref_title_autosize_icons"
				android:defaultValue="false"
				android:summary="@string/pref_summary_autosize_icons"
				android:key="autosizeIcons" />
			<com.android.launcher.DialogSeekBarPreference
				android:title="@string/pref_title_desktop_columns"
				android:summary="@string/pref_summary_desktop_columns"
				android:dialogMessage="@string/pref_dialog_desktop_columns"
				android:key="desktopColumns" android:defaultValue="@integer/config_desktopColumns"
				android:max="5" />
			<com.android.launcher.DialogSeekBarPreference
				android:title="@string/pref_title_desktop_rows"
				android:summary="@string/pref_summary_desktop_rows"
				android:dialogMessage="@string/pref_dialog_desktop_rows"
				android:key="desktopRows" android:defaultValue="@integer/config_desktopRows"
				android:max="5" />
		</PreferenceCategory>
		<PreferenceCategory
            android:title="@string/pref_title_screens_behaviour_preferencecategory">
			<com.android.launcher.DialogSeekBarPreference
				android:title="@string/pref_title_desktop_scrolling_speed"
				android:summary="@string/pref_summary_desktop_scrolling_speed"
				android:dialogMessage="@string/pref_dialog_desktop_scrolling_speed"
				android:key="desktopSpeed" android:defaultValue="@integer/config_desktopSpeed"
				android:max="2000" />
			<com.android.launcher.DialogSeekBarPreference
				android:title="@string/pref_title_desktop_overshoot"
				android:summary="@string/pref_summary_desktop_overshoot"
				android:dialogMessage="@string/pref_dialog_desktop_overshoot"
				android:key="desktopBounce" android:defaultValue="@integer/config_desktopBounce"
				android:max="100" />
		</PreferenceCategory>
	</PreferenceScreen>