Preference 三种监Preference 三种监听事件说明听事件说明
3者的区别
使用方式不同
-
onPreferenceClick 与onPreferenceChange 是通过preference.setOnPreferenceClickListener preference.setOnPreferenceChangeListener来注册listener使用的 。
-
Preference.OnPreferenceClickListener, Preference.OnPreferenceChangeListener 中是对上面两个listener的定义。
-
onPreferenceTreeClick 是PreferenceActivity 中的一个方法,我们可以通过复写它来处理我们自己需要的事务。
三者的关系
一、boolean onPreferenceTreeClick (PreferenceScreen preferenceScreen, Preference prefer)
说 明:当Preference控件被点击时,触发该方法。
参数说明: preference 点击的对象。
返 回 值: true 代表点击事件已成功捕捉,无须执行默认动作或返回上层调用链。 例如, 不跳转至默认Intent。
false 代表执行默认动作并且返回上层调用链。例如,跳转至默认Intent。
在继承PreferenceActivity的Activity可以重写该方法,来完成我们对Preference事件的捕捉。
二、boolean onPreferenceChange(Preference preference,Object objValue)
说 明: 当Preference的元素值发送改变时,触发该事件。
返回值:true 代表将新值写入sharedPreference文件中。
false 则不将新值写入sharedPreference文件.
三、public boolean onPreferenceClick(Preference preference)
说明:当点击控件时触发发生,可以做相应操作。
那么当一个Preference控件被点击或者值发生改变时,触发方法是如何执行的呢?
-
先调用onPreferenceClick()方法,
如果该方法返回true, 则不再调用onPreferenceTreeClick方法 。
如果该方法返回false,则继续调用onPreferenceTreeClick方法 。 -
onPreferenceChange的方法独立与其他两种方法的运行。也就是说,它总是会运行。
补充:点击某个Preference控件后,会先回调onPreferenceChange()方法,即是否保存值,然后再回调onPreferenceClick以及onPreferenceTreeClick()方法,因此在onPreferenceClick和onPreferenceTreeClick方法中我们得到的控件值就是最新的Preference控件值。
onPreferenceClick 与 onPreferenceTreeClick 的关系
源码:
在类Preference.java中
/**
* Called when a click should be performed.
*
* @param preferenceScreen A {@link PreferenceScreen} whose hierarchy click
* listener should be called in the proper order (between other
* processing). May be null.
* @hide
*/
public void performClick(PreferenceScreen preferenceScreen) {
if (!isEnabled()) {
return;
}
onClick();
if (mOnClickListener != null && mOnClickListener.onPreferenceClick(this)) {
return;
}
PreferenceManager preferenceManager = getPreferenceManager();
if (preferenceManager != null) {
PreferenceManager.OnPreferenceTreeClickListener listener = preferenceManager
.getOnPreferenceTreeClickListener();
if (preferenceScreen != null && listener != null
&& listener.onPreferenceTreeClick(preferenceScreen, this)) {
return;
}
}
if (mIntent != null) {
Context context = getContext();
context.startActivity(mIntent);
}
}