Android中Preference的使用以及监听事件分析

在Android系统源码中，绝大多数应用程序的UI布局采用了Preference的布局结构，而不是我们平时在模拟器中构建应用程序时使用的View 布局结构，例如，Setting模块中布局。当然，凡事都有例外，FMRadio应用程序中则使用了View布局结构(可能是该应用程序是marvel公 司提供的，如果由google公司做，那可说不准)。归根到底，Preference布局结构和View的布局结构本质上还是大同小
异，Preference的优点在于布局界面的可控性和高效率以及可存储值的简洁性(每个PreferenPreferencece存储在相对应下的 SharedPreference文件夹下)。 下面，我们对比Preference和View下得各个子控件，对他们的家庭元素在宏观上有个更好的把握性。

单一控件：

　　　　Preference 控件家庭 　　　　View控件家庭 　　控件含义

　　　　Preferenc　　　　　　　　 TextView 　　　　文本框　　

　　　　CheckPreference CheckBox 　　　单选框

　　　　EditTextPreference EditText 　　输入文本框

　　　　ListPreference ListView 　　列表框

　　　　RingtonePreference —— 　　铃声

　　其实在Android源码系统中还有很多的”未完工”的Preference, 没有为它们提供PI接口，例如SeekBarPreference，有兴趣的同学可以参考源码，具体路径为：frameworks/base/core/java/preference。

组合控件：

　　PreferenceCategory :类似于LinearLayou、RelativeLayout，用于组合一组Preference，使布局更具备层次感 。

　　PreferenceScreen : 所有Preference元素的根节点。

显示Preference布局结构的方法为：

　　使我们的Activity继承PreferenceActivity，然后在onCreate()方法中通过 addPreferencesFromResource(R.xml.custom_preference) (我们自定义的Preference 布局)。

　　怎么样，是不是似曾相识？稍后会用一个Demo来为您详述。

Preference元素的通用XML Attributes说明：

　　android:key ：
每个Preference控件独一无二的”ID”,唯一表示此Preference。

　　android:defaultValue ：
默认值。 例如，CheckPreference的默认值可为”true”，默认为选中状态；

EditTextPreference的默认值可为”110” 。

　　android:enabled ：
表示该Preference是否可用状态。

　　android:title ：
每个Preference在PreferenceScreen布局上显示的标题——大标题

　　android:summary ：
每个Preference在PreferenceScreen布局上显示的标题——小标题(可以没有)

　　android:persistent：
表示Preference元素所对应的值是否写入sharedPreferen文件中，如果是true，则表示写

入；否则，则表示不写入该Preference元素的值。

　　android:dependency：
表示一个Preference(用A表示)的可用状态依赖另外一个Preference(用B表示)。B可用，

则A可用；B不可用，则A不可用。

　　android:disableDependentsState：
与android:dependency相反。B可用，则A不可用；B不可用，则A可用。

常用的方法则包括：

　　　　getKey() 　　setKey()

getSummary() 　　 setSummary()

getText() 　　setText()

getXXX()代表取得xxx属性的值。

一个简易的效果图如下：

Preference的跳转：

　　方法一：在配置每个Preference元素节点时，我们可以显示为点击它时所跳转的Intent。点击该Preference，跳转至目标Intent。除非在onPreferenceTreeClick()方法中进行抉择。在xml中配置如下：

1     <Preference android:key="wifi_setting" android:title="Wi-Fi设置"
2         android:summary="设置和管理无线接入点" android:dependency="apply_wifi">
3         <!-- 点击时 自定义一个默认跳转Intent  action指定隐式Intent -->
4         <!-- action指定隐式Intent ; targetPackage和targetClass指定显示Intent-->
5         <intent android:action="com.feixun.action.seemAction"
6             android:targetPackage="com.feixun.qin" android:targetClass="com.feixun.qin.MainActivity" />
7     </Preference>

　　方法二：可以在onPreferenceTreeClick()创建新的intent显示的进行跳转。

Preference的Attributes和方法

　　接下来，对每个Preference的的独有XML Attributes和方法进行一下总结，使大家有更好的深入理解。

1、EditPreference

　　方法：

　　　　getEditText() 返回的是我们在该控件中输入的文本框值

　　　　getText() 返回的是我们之前sharedPreferen文件保存的值

　　　　效果图：



2、ListPreference

　　XML Attributes：

　　　　android:dialogTitle：弹出控件对话框时显示的标题

　　　　android:entries：类型为array，控件欲显示的文本

　　　　android:entryValues：类型为array，与文本相对应的key-value键值对，value保存至sharedPreference文件

　　　　说明：entries和entryValue属性使用的数组为定义在资源文件arrays.xml的数组名：

　　方法：

　　　　CharSequence[] getEntries()：
返回的是控件显示文本的一个”key”数组，对应于属性android:entries

　　　　 CharSequence[] getEntryValues()：返回的一个”value”数组，对应于属性android:
entryValues

　　　　CharSequence getEntry():
返回当前选择文本

　　　　String
getValue() :返回当前选中文本选中的value 。

　　　　与之对应的还有它们所对应的setXXX()方法，可以参考SDK进行分析。效果图：



采用的数组为：

1     <?xml version="1.0" encoding="utf-8"?>
2     <resources>
3         <string-array name="department">
4             <item>IT</item>
5             <item>Commerce</item>
6             <item>HR</item>
7         </string-array>
8         <string-array name="department_value">
9             <item>001</item>
10             <item>002</item>
11             <item>003</item>
12         </string-array>
13     </resources>

3、RingtonePreference

　　XML Attributes：

　　　　android:ringtoneType：响铃的铃声类型，主要有：ringtone(音乐)、notification(通知)、alarm(闹铃)

、all(所有可用声 音类型)。

　　　　android:showDefault ：默认铃声，可以使用系统(布尔值---true,false)的或者自定义的铃声

　　　　android:showSilent
：指定铃声是否为静音。指定铃声包括系统默认铃声或者自定义的铃声

　　效果图：

重点：分析Preference事件

　　★在PreferenceActivity方法中，一个比较重要的监听点击事件方法为：

public booleanonPreferenceTreeClick (PreferenceScreen preferenceScreen, Preference preference)

　　　　说 明 ： 当Preference控件被点击时，触发该方法。

　　　　参数说明： preference 点击的对象。

　　　　返回值： true 代表点击事件已成功捕捉，无须执行默认动作或者返回上层调用链。 例如，不跳转至默认Intent。

false 代表执行默认动作并且返回上层调用链。例如，跳转至默认Intent。

　　

　　在我们继承PreferenceActivity的Activity可以重写该方法，来完成我们对Preference事件的捕捉。相信通过前面的介绍，你一定知道了如何使用了Preference家族并且对其触发方法。下面我们抛出另外两枚炸弹——Preference相关的两个重要监听接口。

　　★ Preference.OnPreferenceChangeListener
该监听器的一个重要方法如下：

boolean
onPreferenceChange(Preference preference,Object objValue)

说明： 当Preference的元素值发送改变时，触发该事件。

返回值：true 代表将新值写入sharedPreference文件中。

false 则不将新值写入sharedPreference文件

　　★ Preference.OnPreferenceClickListener
该监听器的一个重要方法如下：

public booleanonPreferenceClick(Preference preference)

说明：当点击控件时触发发生，可以做相应操作。

　　那么当一个Preference控件实现这两个接口时，当被点击或者值发生改变时，触发方法是如何执行的呢?事实上，它的触发规则如下：

　　1 先调用onPreferenceClick()方法，如果该方法返回true，则不再调用onPreferenceTreeClick方法
；如果onPreferenceClick方法返回false，则继续调用onPreferenceTreeClick方法。

　　2 onPreferenceChange的方法独立与其他两种方法的运行。也就是说，它总是会运行。

　　那么，开始我们的实战之旅吧！ 下面给您最火热的战场。

　　1，新建我们的preference.xml文件。

① 在res文件夹下，新建xml文件夹。

② 在新建的xml文件夹下，新建Android XML File。命名为mypeference.xml 。类型选择为Preference。

③ 打开我们的mypeference.xml，视图选择Structure。可以手动配置我们的布局文件。可选的Preference空间如下：



Demo中mypeference.xml的布局文件如下：

1 <?xml version="1.0" encoding="utf-8"?>
2 <PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android">
3
4     <PreferenceCategory android:title="我的位置"
5         android:key="set_local" />
6     <CheckBoxPreference android:key="apply_wireless"
7         android:title="使用无线网络" android:summary="使用无线网络在应用程序（例如Google地图）中查看位置"
8         android:defaultValue="true">
9     </CheckBoxPreference>
10     <CheckBoxPreference android:key="apply_gps"
11         android:title="使用GPS" android:summary="定位到街道级别（需要消耗更多的电量以及天气允许）">
12     </CheckBoxPreference>
13
14     <PreferenceCategory android:title="无线和网络设置"></PreferenceCategory>
15
16     <CheckBoxPreference android:key="apply_fly"
17         android:title="飞行模式" android:summary="禁用所有无线连接" >
18     </CheckBoxPreference>
19
20     <CheckBoxPreference android:key="apply_internet"
21         android:title="Internet共享" android:summary="禁用通过USB共享Internet连接">
22     </CheckBoxPreference>
23
24     <CheckBoxPreference android:key="apply_wifi"
25         android:title="Wi-Fi" android:summary="打开Wi-Fi">
26     </CheckBoxPreference>
27     <Preference android:key="wifi_setting" android:title="Wi-Fi设置"
28         android:summary="设置和管理无线接入点" android:dependency="apply_wifi">
29         <!-- 点击时 自定义一个默认跳转Intent  action指定隐式Intent -->
30         <!-- action指定隐式Intent ; targetPackage和targetClass指定显示Intent-->
31         <intent android:action="com.feixun.action.seemAction"
32             android:targetPackage="com.feixun.qin" android:targetClass="com.feixun.qin.MainActivity" />
33     </Preference>
34     <CheckBoxPreference android:key="apply_bluetooth"
35         android:title="蓝牙" android:summary="启用蓝牙">
36     </CheckBoxPreference>
37     <Preference android:key="bluetooth_setting" android:title="蓝牙设置"
38         android:summary="管理连接、设备设备名称和可检测性" android:dependency="apply_bluetooth">
39     </Preference>
40     <EditTextPreference android:key="number_edit"
41         android:title="输入电话号码" android:defaultValue="123">
42     </EditTextPreference>
43     <ListPreference android:key="depart_value"
44         android:title="部门设置" android:dialogTitle="选择部门" android:entries="@array/department"
45         android:entryValues="@array/department_value">
46     </ListPreference>
47     <RingtonePreference android:key="ring_key"
48         android:title="铃声" android:ringtoneType="all" android:showDefault="true"
49         android:showSilent="true">
50     </RingtonePreference>
51 </PreferenceScreen>

2，新建一个HelloActivity继承PreferenceActivity，代码如下：

1     package com.feixun.qin;
2
3     import android.content.Intent;
4     import android.content.SharedPreferences;
5     import android.os.Bundle;
6     import android.preference.CheckBoxPreference;
7     import android.preference.EditTextPreference;
8     import android.preference.ListPreference;
9     import android.preference.Preference;
10     import android.preference.PreferenceActivity;
11     import android.preference.PreferenceManager;
12     import android.preference.PreferenceScreen;
13     import android.preference.Preference.OnPreferenceClickListener;
14     import android.util.Log;
15
16     public class HelloPreference extends PreferenceActivity implements
17             Preference.OnPreferenceClickListener,
18             Preference.OnPreferenceChangeListener {
19         private static String TAG = "HelloPreference";
20         private CheckBoxPreference mapply_wifiPreference;       //打开wifi
21         private CheckBoxPreference mapply_internetPreference;   //Internet共享
22         private ListPreference depart_valuePreference;          //部门设置
23         private EditTextPreference number_editPreference;       //输入电话号码
24         private Preference mwifi_settingPreference;             //wifi设置
25         private String oldDeptId; // 旧部门的名称
26
27         public void onCreate(Bundle savedInstanceState) {
28             super.onCreate(savedInstanceState);
29             addPreferencesFromResource(R.xml.mypreference);
30             //根据key值找到控件
31             mapply_wifiPreference = (CheckBoxPreference) findPreference("apply_wifi");
32             mapply_internetPreference = (CheckBoxPreference) findPreference("apply_internet");
33             depart_valuePreference = (ListPreference) findPreference("depart_value");
34             number_editPreference = (EditTextPreference) findPreference("number_edit");
35             mwifi_settingPreference = (Preference) findPreference("wifi_setting");
36
37             // 设置监听器
38             mapply_internetPreference.setOnPreferenceClickListener(this);
39             mapply_internetPreference.setOnPreferenceChangeListener(this);
40             depart_valuePreference.setOnPreferenceClickListener(this);
41             depart_valuePreference.setOnPreferenceChangeListener(this);
42             number_editPreference.setOnPreferenceClickListener(this);
43             number_editPreference.setOnPreferenceChangeListener(this);
44             mwifi_settingPreference.setOnPreferenceClickListener(this);
45
46             // 得到我们的存储Preferences值的对象，然后对其进行相应操作
47             SharedPreferences shp = PreferenceManager.getDefaultSharedPreferences(this);
48             boolean apply_wifiChecked = shp.getBoolean("apply_wifi", false);
49         }
50
51         // 对控件进行的一些操作
52         private void operatePreference(Preference preference) {
53             if (preference == mapply_wifiPreference){                  //点击了    "打开wifi"
54                 Log.i(TAG, " Wifi CB, and isCheckd ="+ mapply_wifiPreference.isChecked());
55             }else if (preference.getKey().equals("apply_internet")){   //点击了"Internet共享"
56                 Log.i(TAG, " internet CB, and isCheckd = "+mapply_internetPreference.isChecked());
57             }else if (preference == depart_valuePreference){           //点击了 "部门设置"
58                 Log.i(TAG, " department CB,and selectValue = "+ depart_valuePreference.getValue() + ", Text="+ depart_valuePreference.getEntry());
59             }else if (preference.getKey().equals("wifi_setting")) {    //点击了"wifi设置"
60                 mwifi_settingPreference.setTitle("its turn me.");
61             }else if (preference == number_editPreference)             //点击了"输入电话号码"
62                 Log.i(TAG, "Old Value="+ number_editPreference.getText() + ", New Value="+ number_editPreference.getEditText().toString());
63         }
64         // 点击事件触发
65         @Override
66         public boolean onPreferenceClick(Preference preference) {
67             // TODO Auto-generated method stub
68             Log.i(TAG, "onPreferenceClick----->"+String.valueOf(preference.getKey()));
69             // 对控件进行操作
70             operatePreference(preference);
71             return false;
72         }
73             //点击事件触发
74         public boolean onPreferenceTreeClick(PreferenceScreen preferenceScreen,
75                 Preference preference) {
76             Log.i(TAG, "onPreferenceTreeClick----->"+preference.getKey());
77             // 对控件进行操作
78             operatePreference(preference);
79             if (preference.getKey().equals("wifi_setting")) {
80                 // 创建一个新的Intent，
81                 // 函数如果返回true， 则跳转至该自定义的新的Intent ;
82                 // 函数如果返回false，则跳转至xml文件中配置的Intent ;
83                 Intent i = new Intent(HelloPreference.this, OtherActivity.class);  //OtherActivity只是一个简单的Activity
84                 i.putExtra("type", "wifi");
85                 startActivity(i);
86                 return true;
87             }
88             return false;
89         }
90
91         // 当Preference的值发生改变时触发该事件，true则以新值更新控件的状态，false则do noting
92         public boolean onPreferenceChange(Preference preference, Object objValue) {
93             Log.i(TAG, "onPreferenceChange----->"+String.valueOf(preference.getKey()));
94             if (preference == mapply_wifiPreference){
95                 Log.i(TAG, "Wifi CB, and isCheckd = " + String.valueOf(objValue));
96             }else if (preference.getKey().equals("apply_internet")) {
97                 Log.i(TAG, "internet CB, and isCheckd = "+ String.valueOf(objValue));
98                 return false;  //不保存该新值
99             }else if (preference == depart_valuePreference){
100                 Log.i(TAG, "  Old Value"+ depart_valuePreference.getValue()+" NewDeptName"+objValue);
101             }else if (preference.getKey().equals("wifi_setting")) {
102                 Log.i(TAG, "change" + String.valueOf(objValue));
103                 mwifi_settingPreference.setTitle("its turn me.");  //重新设置title
104             } else if (preference == number_editPreference) {
105                 Log.i(TAG, "Old Value = " + String.valueOf(objValue));
106                 return false; // 不保存更新值
107             }
108             return true;  //保存更新后的值
109         }
110     }

3，AndroidManifest 文件如下：

1     <?xml version='1.0' encoding='utf-8' standalone='yes' ?>
2
3     <map>
4
5     <boolean name="apply_wifi" value="true" />
6
7     <boolean name="apply_internet" value="true" />
8
9     <string name="number_edit">45677</string>
10     <string name="ring_key">content://settings/system/ringtone</string>
11
12     <boolean name="apply_bluetooth" value="true" />
13
14     <boolean name="apply_fly" value="true" />
15
16     <string name="depart_value">001</string>
17
18     <boolean name="apply_gps" value="true" />
19
20     <boolean name="apply_wireless" value="false" />
21
22     </map>

程序运行后，效果如上所示，是不是很给力呀！

sharedPreference文件

　　前面我们说过，Android系统会将Preference元素的值存储在sharedPreference文件中。该文件存放路径位于DDMS视图下的data/data/[packgename]/shared_prefs/文件下，命名约定为：packagename_preferencse.xml。我们的com.feixun.qin_preferences.xm保存的值为：

1     <?xml version='1.0' encoding='utf-8' standalone='yes' ?>
2
3     <map>
4
5     <boolean name="apply_wifi" value="true" />
6
7     <boolean name="apply_internet" value="true" />
8
9     <string name="number_edit">45677</string>
10     <string name="ring_key">content://settings/system/ringtone</string>
11
12     <boolean name="apply_bluetooth" value="true" />
13
14     <boolean name="apply_fly" value="true" />
15
16     <string name="depart_value">001</string>
17
18     <boolean name="apply_gps" value="true" />
19
20     <boolean name="apply_wireless" value="false" />
21
22     </map>

　　以一个键值对的形式保存，name为Preference的key值，value为Preference的value值。

　　在应用程序中，我们可以通过代码的方式来访问该sharedPreference文件，继而可以对其进行读取甚至任何操作。

代码如下：

1     // 得到我们的存储Preferences值的对象，然后对其进行相应操作
2     SharedPreferences shp = PreferenceManager.getDefaultSharedPreferences(this);
3     boolean apply_wifiChecked = shp.getBoolean("apply_wifi", false);