PreferenceActivity它包含了许多类似控件的东西来表示不同的设置需求如分类设置,选择框设置,下拉列表设置,编辑框设置,铃声设置,而且这些设置不需要我们自己来保存用户设置的数据,它自己会将数据保存在xml文件当中。下面是PreferenceActivity中各个组件的介绍。
1. PreferenceScreen:设置页面,可嵌套形成二级设置页面,用Title参数设置标题。
其中com.android.settings是工程的包名,com.android.settings.wifi.WifiSettings是要启动的类。
一般情况下,这样就ok了,点击对应的Preference就能够启动对应的activity,然而仅仅这样有时这样,并不一定能够启动对应的activity,因为它与回调函数onPreferenceTreeClick有关,有时候我们会重写这个方法如:
其中WirelessSetting.java中有如上函数,当返回值为true时,你怎么点击Preference都不会跳转到activity的,只有等到它的返回值为false的时候,才可以正常跳转,因为点击某一个Preference的真正实现在Preference.java的performClick函数中如下:
当点击某个Preference时的调用流程是AdapterView.performItemClick--》PreferenceScreen.onItemClick--》Preference.performClick--》PreferenceActivity.onPreferenceTreeClick,当onPreferenceTreeClick返回true的时候就直接return了,没有走下面启动activity的地方了,因此要使一个Preference能够正常跳转到另外一个activity有两个条件,一是xml里面是否设置正确,第二是调用该xml的java类是否在onPreferenceTreeClick这个函数需要返回false。
3. CheckBoxPreference:是一个CheckBox设置,只有两种值,true或false,可用Title参数设置标题,用summaryOn和summaryOff参数来设置控件选中和未选中时的提示,可以用defaultValue设置缺省值。
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。自动生成的配置文件如下:
文件中的name属性对应xml文件中的key属性表示某一个设置项,值是唯一的,value以及string中间的值表示设置项的具体值。
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。
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>