一.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