OnPreferenceChangeListener分析,以及与OnPreferenceClickListener的区别

http://www.cnblogs.com/LutherTsai/archive/2011/12/25/2301014.html
　　最近学习Android中PreferenceScreen的时候，遇到两种监听器OnPreferenceChangeListener和OnPreferenceClickListener，OnPreferenceClickListener的意思好理解，但是OnPreferenceChangeListener就不好懂了，所以就写了个Demo分析了一下，代码如下：

1 package com.luther.test;

3 import com.luther.test.R;

5 import android.content.SharedPreferences;

6 import android.os.Bundle;

7 import android.preference.CheckBoxPreference;

8 import android.preference.EditTextPreference;

9 import android.preference.ListPreference;

10 import android.preference.Preference;

11 import android.preference.Preference.OnPreferenceChangeListener;

12 import android.preference.Preference.OnPreferenceClickListener;

13 import android.preference.PreferenceActivity;

14 import android.preference.PreferenceManager;

15 import android.preference.PreferenceScreen;

16 import android.widget.Toast;

18 public class PreferenceDemoActivity extends PreferenceActivity

19         implements OnPreferenceChangeListener, OnPreferenceClickListener{

21     private ListPreference mList1Prefs;

22     private ListPreference mList2Prefs;

23     private CheckBoxPreference mCheckPrefs;

24     private EditTextPreference mEditPrefs;

25     private SharedPreferences mSharedPrefs;

27     /** Called when the activity is first created. */

29     public void onCreate(Bundle savedInstanceState) {

30         super.onCreate(savedInstanceState);

31         addPreferencesFromResource(R.xml.preference);

32         initViews();

33     }

35     private void initViews(){

36         //得到以包命名的SharedPreferences

37         mSharedPrefs = PreferenceManager.getDefaultSharedPreferences(this);

39         mList1Prefs = (ListPreference) findPreference("key_call_config");

40         mList2Prefs = (ListPreference) findPreference("key_msg_config");

41         mCheckPrefs = (CheckBoxPreference) findPreference("switch");

42         mEditPrefs = (EditTextPreference) findPreference("autoreply_text_cpntent");

44         mList1Prefs.setOnPreferenceClickListener(this);

45         mList1Prefs.setOnPreferenceChangeListener(this);

46         mList2Prefs.setOnPreferenceChangeListener(this);

47         mList2Prefs.setOnPreferenceClickListener(this);

48     }

49 	public boolean onPreferenceTreeClick(PreferenceScreen preferenceScreen, (此为回调函数)

52             Preference preference) {

53         if(preference == mEditPrefs){

54             String toastStr = mEditPrefs.getTitle() + "\n"

55                             + "Content: " + mEditPrefs.getText();

56             showToast(toastStr);

57         }

58         return super.onPreferenceTreeClick(preferenceScreen, preference);

59     }

61     public boolean onPreferenceClick(Preference preference) {

62         String prefsValue = mSharedPrefs.getString(preference.getKey(), "-1");

63         showToast(prefsValue);

64         return false;

65     }

67     public boolean onPreferenceChange(Preference preference, Object newValue) {  （此为回调函数）

69         if(mList1Prefs == preference){

70             String prefsValue = mSharedPrefs.getString(preference.getKey(), "-1");

71             showToast(prefsValue);

72         }

73         if(mList2Prefs == preference){

74             String prefsValue = newValue.toString();

75             showToast(prefsValue);

76             mList2Prefs.setValue(prefsValue);

77         }

78         return false;

79     }

81     private void showToast(String arg){

82         Toast.makeText(this, arg, Toast.LENGTH_SHORT).show();

83     }

84
85 }

程序原理：用一个ListPreference分别注册这两个监听器，然后用Tosat看他们在什么时候响应。

.../res/xml/preference文件如下：

1 <?xml version="1.0" encoding="utf-8"?>
2 <PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android"
3     android:title="@string/settings">
4     <PreferenceCategory
5 　　　　android:title="@string/general_settings">
6         <ListPreference
7 　　　　　　　android:key="key_call_config"
8             android:title="@string/incoming_call_come"
9             android:dialogTitle="@string/incoming_call_come"
10             android:entries="@array/response_entries"
11             android:entryValues="@array/response_entry_values"/>
12         <ListPreference
13 　　　　　　　android:key="key_msg_config"
14             android:title="@string/message_come"
15             android:dialogTitle="@string/message_come"
16             android:entries="@array/response_entries"
17             android:entryValues="@array/response_entry_values"/>
18     </PreferenceCategory>
19
20     <PreferenceCategory
21 　　　　　android:title="@string/user_defined_autoreply_settings">
22         <CheckBoxPreference
23 　　　　　　　android:title="@string/autoreply_switch"
24             android:key="switch"/>
25         <EditTextPreference
26 　　　　　　　android:title="@string/user_defined_autoreply_text"
27             android:key="autoreply_text_cpntent"
28             android:dependency="switch"
29             android:dialogTitle="@string/user_defined_autoreply_text"
30             android:positiveButtonText="@android:string/ok"
31             android:negativeButtonText="@android:string/cancel"/>
33     </PreferenceCategory>
34
35 </PreferenceScreen>

以下是ListPreference的Entries和EntryValues：

1 <?xml version="1.0" encoding="utf-8"?>
2 <resources>
3     <string-array name="response_entries">
4         <item>静音</item>
5         <item>振动</item>
6         <item>正常响铃</item>
7         <item>LED灯亮</item>
8     </string-array>
9     <string-array name="response_entry_values">
10         <item>0</item>
11         <item>1</item>
12         <item>2</item>
13         <item>3</item>
14     </string-array>
15
16 </resources>

string.xml文件：

1 <?xml version="1.0" encoding="utf-8"?>
2 <resources>
3     <string name="hello">Hello World, PreferenceDemoActivity!</string>
4     <string name="app_name">PreferenceDemo</string>
5     <string name="settings">设置</string>
6
7     <string name="general_settings">常规设置</string>
8     <string name="incoming_call_come">来电时</string>
9     <string name="message_come">来短信时</string>
10
11
12     <string name="user_defined_autoreply_settings">自定义回复设置</string>
13     <string name="autoreply_switch">自动回复</string>
14     <string name="user_defined_autoreply_text">自动回复短信</string>
15 </resources>

下面是Demo的主界面：



编译好，运行程序：点击mList1Prefs(来电时),Toast显示“-1”。再点击一个选项，对话框消失，Toast显示“-1”，为什么会这样？为什么不是第一次选中时的选项值？

其实，这是因为设置了OnPreferenceChangeListener。默认情况下，普通的ListPreference第一次选中一个值之后，Android框架会存贮好选中的值，下次打开，会默认选中上次选中的值，但是设置OnPreferenceChangeListener之后，值的存储就要自己来了，详见代码中的mList2Prefs.setValue();“来短信时”这一项就能够正常存贮选中的值。

现在区别就出来了：

OnPreferenceClickListener：是响应点击preference的事件，比如程序中，一点ListPreference，回调函数onPreferenceClick()中就弹出Toast。

OnPreferenceChangeListener：是响应preference的值被改变的事件（此时被改变的值需要自己存贮到SharedPreferences） ，比如程序中，点击ListPreference的某一项，回调函数onPreferenceChange()中就会弹出Toast。

另外：onPreferenceTreeClick（）这个方法感觉和OnPreferenceClickListener的回调方法onPreferenceClick（）的作用差不多，一样是响应点击的事件。

回头再看OnPreferenceChangeListener的文档：

Interface definition for a callback to be invoked when the value of this

Preference

has been changed by the user and is about
to be set and/or persisted. This gives the client a chance to prevent setting and/or persisting the value.

就非常明白了~