Android Preference API 用法--ListPreference（一）

一．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"?><PreferenceScreenxmlns:android="http://schemas.android.com/apk/res/android"android:key="screen_list"android:title="标题"android:summary="说明摘要"><ListPreferenceandroid: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{@Overridepublic 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);}@Overridepublic boolean onPreferenceTreeClick(PreferenceScreen preferenceScreen,Preference preference) {return super.onPreferenceTreeClick(preferenceScreen, preference);}@Overridepublic 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