Android Preference应用
Android Preference使用
0介绍
Android系统内的设置界面由Android Preference相关类提供，使用preference这个键值对的方式来自动保存这些数据，并即时生效，同时Android提供一种类似layout的方式来进行Preference的布局。其中，使用PreferenceScreen和PreferenceCategory对布局进行控制，设置子项包含以下种类： LListPreference，CheckBoxPreference，EditTextPreference，RingtonePreference，EditPhoneNumberPreference等。设置数据的保存和读取通过全局保存对象SharedPreferences
实现，保存时触发相应事件通过Preference.onPreferenceChangeListener
实现。下面分别介绍各类。
1 配置文件示例
配置功能xml示例
2 设置页面布局
2.1 PreferenceScreen
每一个设置界面就是一个PreferenceScreen，因此其xml配置文件到根节点是 PreferenceScreen，其内可包含 PreferenceScreen， PreferenceCategory，其他设置项如 ListPreference， CheckBoxPreference等。 此项包含的所有子项在新屏幕上显示，就好像进入二级菜单。
处于内层的PreferenceScreen被点击时，在新页面中显示其内的两个CheckBoxPreference选项。
view code
<PreferenceScreen android:key="detailSetting" android:title="@string/detail_setting_title" android:summary="@string/detail_setting_summary"> <CheckBoxPreference android:key="music1" android:title="@string/music_title" android:summary="@string/music_summary" android:defaultValue="true" /> <CheckBoxPreference android:key="music2" android:title="@string/music_title" android:summary="@string/music_summary" android:defaultValue="true" /></PreferenceScreen>
也可以设置内层PreferenceScreen的Intent属性，设置点击PreferenceScreen时跳转到com.android.phone.SelectSimCard页面。如：
View Code
<PreferenceScreen android:key="config_sub" android:title="@string/sel_sub_title" android:summary="@string/sel_sub_summary" android:persistent="false"> <intent android:action="android.intent.action.MAIN" android:targetPackage="com.android.phone" android:targetClass="com.android.phone.SelectSimCard" /></PreferenceScreen>
2.2 PreferenceCategory
PreferenceCategory 为设置选项类别，其内部包含一个或多个设置选项。如 PreferenceScreen， 其他设置项如 ListPreference， CheckBoxPreference等。
PreferenceCategory在设置界面上显示为一个类别标题。 PreferenceCategory是一个逻辑上的类别概念。
3 常用设置项
ListPreference 带下拉的设置项
CheckBoxPreference 带CheckBox的设置项
EditTextPreference 输入文本到设置项
RingtonePreference 铃声设置项
EditPhoneNumberPreference 号码设置项
…...
3.1 设置项属性
Key为这个Preference的ID，设置了才可以在代码中引用
Title是显示的标题
Summary是显示在标题下的文字介绍
Dependency：可用来配置此设置项是否依赖于其他配置项，如：填写一个CheckBoxPreference的Key，这样就会在填写的那个CheckBoxPreference勾选时当前这个Preference才可用
Default Value为初始值
4 自定义设置项
默认提供的设置项不能满足全部要求，因此，会根据需要对设置项进行自定义。
1）首先扩展Preference类，注意使用SharedPreferences对配置项进行保存。
2）定义此Preference类对应的layout
3）直接用标签引用此Preference。如：
View Code
<com.rasa.game.CustomPreference android:key="my_preference" android:title="Advance Preference" android:summary="You can custom design your prefrence UI" android:defaultValue="100" />
5 设置变化事件
6 设置的读取和保存
1.全局保存对象SharedPreferences
在android中，最简单的持久化数据的办法是使用Preferences API，获取preference对象有三种方式，都是通过Activity对象的方法，获取的是android.content.SharedPreferences对象实例。
getPreferences()：获取到作用域是本Activity的preference
getSharedPreferences()：获取到作用域是本应用程序的preference
getDefaultSharedPreferences()：获取到全局作用域的preference
保存方式如下：
View Code
String STORE_NAME = "Settings"; SharedPreferences settings = getSharedPreferences(STORE_NAME, MODE_PRIVATE); SharedPreferences.Editor editor = settings.edit(); editor.putInt("sourceType", 0); editor.commit(); SharedPreferences实例是通过：
get方法获取对应键的值；
edit方法获取SharedPreferences.Editor对象
通过SharedPreferences.Editor的put方法写入键值对
保存需要commit方法
2.是否保存
Preference.setOnPreferenceChangeListener
通过在子类中调用此方法来设置监听，在变化后进行保存。
ListPreference继承于DialogPreference，对onDialogClosed函数进行了覆盖，代码如下：
View Code
@Override protected void onDialogClosed(boolean positiveResult) { super.onDialogClosed(positiveResult); if (positiveResult) {// 是否是ok按钮点击？----------------------------------------（A） String value = mEditText.getText().toString();// 获取EditText控件的内容 if (callChangeListener(value)) {// 应用层是否关注此值变化---------------------（C） setText(value);// 设置新的值--------------------------------------------------（D） } } }
从以上可以看到，如果应用层允许保存用户设置的新值，则进行保存
其中（D）最终调用Preference类的setPersistentString（）函数进行保存。
此函数可以从Preference.java的源码callChangeListener看到，看应用程序是否设置了
setOnPreferenceChangeListener，这个一般是继承的PerferenceActivity的类来调用一个listener或者自身，
如果没有没有设置 ，用户即忽略参数变化。
转载博客园：
http://archive.cnblogs.com/a/2172773/
0介绍
Android系统内的设置界面由Android Preference相关类提供，使用preference这个键值对的方式来自动保存这些数据，并即时生效，同时Android提供一种类似layout的方式来进行Preference的布局。其中，使用PreferenceScreen和PreferenceCategory对布局进行控制，设置子项包含以下种类： LListPreference，CheckBoxPreference，EditTextPreference，RingtonePreference，EditPhoneNumberPreference等。设置数据的保存和读取通过全局保存对象SharedPreferences
实现，保存时触发相应事件通过Preference.onPreferenceChangeListener
实现。下面分别介绍各类。
1 配置文件示例
配置功能xml示例
2 设置页面布局
<?xml version="1.0" encoding="utf-8"?><PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android"> <CheckBoxPreference android:key="music" android:title="@string/music_title" android:summary="@string/music_summary" android:defaultValue="true" /> <CheckBoxPreference android:key="hints" android:title="@string/hints_title" android:summary="@string/hints_summary" android:defaultValue="true" /> <PreferenceScreen android:key="detailSetting" android:title="@string/detail_setting_title" android:summary="@string/detail_setting_summary"> <CheckBoxPreference android:key="music1" android:title="@string/music_title" android:summary="@string/music_summary" android:defaultValue="true" /> <CheckBoxPreference android:key="music2" android:title="@string/music_title" android:summary="@string/music_summary" android:defaultValue="true" /> </PreferenceScreen> <PreferenceScreen android:key="customSetting" android:title="@string/custom_setting_title" android:summary="@string/custom_setting_summary"> <intent android:action="android.intent.action.MAIN" android:targetPackage="com.rasa.game" android:targetClass="com.rasa.game.CustomSetting" /> </PreferenceScreen> <com.rasa.game.CustomPreference android:key="my_preference" android:title="Advance Preference" android:summary="You can custom design your prefrence UI" android:defaultValue="100" /> </PreferenceScreen>
2.1 PreferenceScreen
每一个设置界面就是一个PreferenceScreen，因此其xml配置文件到根节点是 PreferenceScreen，其内可包含 PreferenceScreen， PreferenceCategory，其他设置项如 ListPreference， CheckBoxPreference等。 此项包含的所有子项在新屏幕上显示，就好像进入二级菜单。
处于内层的PreferenceScreen被点击时，在新页面中显示其内的两个CheckBoxPreference选项。
view code
<PreferenceScreen android:key="detailSetting" android:title="@string/detail_setting_title" android:summary="@string/detail_setting_summary"> <CheckBoxPreference android:key="music1" android:title="@string/music_title" android:summary="@string/music_summary" android:defaultValue="true" /> <CheckBoxPreference android:key="music2" android:title="@string/music_title" android:summary="@string/music_summary" android:defaultValue="true" /></PreferenceScreen>
也可以设置内层PreferenceScreen的Intent属性，设置点击PreferenceScreen时跳转到com.android.phone.SelectSimCard页面。如：
View Code
<PreferenceScreen android:key="config_sub" android:title="@string/sel_sub_title" android:summary="@string/sel_sub_summary" android:persistent="false"> <intent android:action="android.intent.action.MAIN" android:targetPackage="com.android.phone" android:targetClass="com.android.phone.SelectSimCard" /></PreferenceScreen>
2.2 PreferenceCategory
PreferenceCategory 为设置选项类别，其内部包含一个或多个设置选项。如 PreferenceScreen， 其他设置项如 ListPreference， CheckBoxPreference等。
PreferenceCategory在设置界面上显示为一个类别标题。 PreferenceCategory是一个逻辑上的类别概念。
3 常用设置项
ListPreference 带下拉的设置项
CheckBoxPreference 带CheckBox的设置项
EditTextPreference 输入文本到设置项
RingtonePreference 铃声设置项
EditPhoneNumberPreference 号码设置项
…...
3.1 设置项属性
Key为这个Preference的ID，设置了才可以在代码中引用
Title是显示的标题
Summary是显示在标题下的文字介绍
Dependency：可用来配置此设置项是否依赖于其他配置项，如：填写一个CheckBoxPreference的Key，这样就会在填写的那个CheckBoxPreference勾选时当前这个Preference才可用
Default Value为初始值
4 自定义设置项
默认提供的设置项不能满足全部要求，因此，会根据需要对设置项进行自定义。
1）首先扩展Preference类，注意使用SharedPreferences对配置项进行保存。
2）定义此Preference类对应的layout
3）直接用标签引用此Preference。如：
View Code
<com.rasa.game.CustomPreference android:key="my_preference" android:title="Advance Preference" android:summary="You can custom design your prefrence UI" android:defaultValue="100" />
5 设置变化事件
6 设置的读取和保存
1.全局保存对象SharedPreferences
在android中，最简单的持久化数据的办法是使用Preferences API，获取preference对象有三种方式，都是通过Activity对象的方法，获取的是android.content.SharedPreferences对象实例。
getPreferences()：获取到作用域是本Activity的preference
getSharedPreferences()：获取到作用域是本应用程序的preference
getDefaultSharedPreferences()：获取到全局作用域的preference
保存方式如下：
View Code
String STORE_NAME = "Settings"; SharedPreferences settings = getSharedPreferences(STORE_NAME, MODE_PRIVATE); SharedPreferences.Editor editor = settings.edit(); editor.putInt("sourceType", 0); editor.commit(); SharedPreferences实例是通过：
get方法获取对应键的值；
edit方法获取SharedPreferences.Editor对象
通过SharedPreferences.Editor的put方法写入键值对
保存需要commit方法
2.是否保存
Preference.setOnPreferenceChangeListener
通过在子类中调用此方法来设置监听，在变化后进行保存。
ListPreference继承于DialogPreference，对onDialogClosed函数进行了覆盖，代码如下：
View Code
@Override protected void onDialogClosed(boolean positiveResult) { super.onDialogClosed(positiveResult); if (positiveResult) {// 是否是ok按钮点击？----------------------------------------（A） String value = mEditText.getText().toString();// 获取EditText控件的内容 if (callChangeListener(value)) {// 应用层是否关注此值变化---------------------（C） setText(value);// 设置新的值--------------------------------------------------（D） } } }
从以上可以看到，如果应用层允许保存用户设置的新值，则进行保存
其中（D）最终调用Preference类的setPersistentString（）函数进行保存。
此函数可以从Preference.java的源码callChangeListener看到，看应用程序是否设置了
setOnPreferenceChangeListener，这个一般是继承的PerferenceActivity的类来调用一个listener或者自身，
如果没有没有设置 ，用户即忽略参数变化。
转载博客园：
http://archive.cnblogs.com/a/2172773/