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"?>
<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