一.ListPreference简介
我们都只知道SharedPreference非常适合于参数设置功能,在此处的preference 也是代表SharedPreference的意思,在SharedPreference中,我们可以迅速的将某些值保存进xml文件中,然后我们可以读取这些设置信息进行相应的操作。
为了简化与preference相关的应用开发,android为我们提供了一系列的api来帮助我们。主要有 PreferenceActivity,CheckBoxPreference,EditTextPreference,ListPreference,MultiSelectListPreference,Preference,PreferenceCategory,PreferenceScreen,RingtonePreference,SwitchPreference。使用接口不用自己手动的对数据进行保存,会自动根据你的选择项进行数据保存,实现自动保存的代码在addPreferencesFromResource方法中具体实现,但是此处不能自定义保存数据的xml文件的名字。xml文件存放的位置在data/data/你应用的包名/shared_prefs 文件夹下。在Eclipse中可以使用File Exceplorer查看文件。
二.ListPreference效果
1. 界面显示如下(类似于下拉框):
2. 点击之后会弹出一个对话框,对话框中显示可以选择的列表,实现单选。在选择之后对话框会自动关闭并会将选择项所对应的值保存到xml文件中。
三.ListPreference用法(首选项preferences)
1. 写xml文件
注意事项:
第一:位置。该文件的位置是在res/xml/下的。
第二:格式,PreferenceScreen为根标签,ListPreference为子标签
第三:标签属性含义
android:key 唯一标识符,和android:id相类似,PreferenceManager可以以其为参数通过findPreference获取指定的preference。
android:title 整个屏幕的标题。
android:summary 选项的简单说明。
android:entries 弹出的对话框中,列表显示的文本内容,注意,这里指定的是一个数组,res/values/arrays.xml为我们的list提供了初始化数据。
android:entryValues 与android:entries相对应的值,和android:entries一样。
android:defaultValue 当对应值不存在时的默认值。和android:entries一样。
android:dialogTitle 弹出的对话框中的标题信息。
xml文件代码如下:
<?xml version="1.0" encoding="utf-8"?>
<PreferenceScreen
xmlns:android="http://schemas.android.com/apk/res/android"
android:key="screen_list"
android:title="标题"
android:summary="说明摘要">
<ListPreference
android:key="myListPreference"
android:title="标题"
android:summary="说明摘要"
android:entries="@array/list_entries"
android:entryValues="@array/list_entries_value"
android:dialogTitle="dialogTitle"
android:defaultValue="@array/list_entries_value2">
</ListPreference>
</PreferenceScreen>
arrays.xml文件如下:
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string-array name="list_entries">
<item>山东</item>
<item>福建</item>
<item>北京</item>
<item>河北</item>
</string-array>
<string-array name="list_entries_value">
<item>shandong1</item>
<item>fujian1</item>
<item>beijing1</item>
<item>hebei1</item>
</string-array>
<string-array name="list_entries_value2">
<item>shandong2</item>
<item>fujian2</item>
<item>beijing2</item>
<item>hebei2</item>
</string-array>
</resources>
2. 一个继承了PreferenceActivity和实现OnPreferenceChangeListener接口的Activity。
步骤:
第一:添加xml文件资源。addPreferencesFromResource(R.xml.mylistpreference);
第二:getPreferenceManager返回首选项管理器对象。
第三:根据android:key中指定的名称(相当于id)来获取首选项ListPreference对象。
第四:给ListPreference对象添加选择改变监听事件。
第五:实现OnPreferenceChangeListener中抽象方法。例如:当数据改变时将ListPreference的Summary值改成选择项对应的值,以方便查看。
代码如下:
public class MyPreferencesActivity extends PreferenceActivity implements OnPreferenceChangeListener{
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
addPreferencesFromResource(R.xml.mylistpreference);
/**
* getPreferenceManager返回首选项管理器对象
*/
PreferenceManager manager = getPreferenceManager();
// 根据android:key中指定的名称(相当于id)来获取首选项
ListPreference listPreference = (ListPreference) manager.findPreference("myListPreference");
Log.i("存储的值为", ""+listPreference.getValue());
listPreference.setOnPreferenceChangeListener(this);
}
@Override
public boolean onPreferenceTreeClick(PreferenceScreen preferenceScreen,
Preference preference) {
return super.onPreferenceTreeClick(preferenceScreen, preference);
}
@Override
public boolean onPreferenceChange(Preference preference, Object newValue) {
preference.setSummary((String)newValue);
return true;//返回true表示允许改变
}
}
四.参考网址
1. http://android.tgbus.com/Android/tutorial/201108/364068.shtml
2. http://www.cnblogs.com/kakafra/archive/2012/09/19/2694444.html