Preference 三种监听事件说明

时间：2025-01-27 12:35:09

Android preference onPreferenceClick/onPreferenceChange/onPreferenceTreeClick 分析

3者的区别

  1. 使用方式不同
    onPreferenceClick 与onPreferenceChange 是通过 和来注册listener使用的 。
    , 中是对上面两个listener的定义。

  2. 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控件被点击或者值发生改变时，触发方法是如何执行的呢?
1 先调用onPreferenceClick()方法，
如果该方法返回true， 则不再调用onPreferenceTreeClick方法 。
如果该方法返回false，则继续调用onPreferenceTreeClick方法 。
2 onPreferenceChange的方法独立与其他两种方法的运行。也就是说，它总是会运行。

补充：点击某个Preference控件后，会先回调onPreferenceChange()方法，即是否保存值，然后再回调onPreferenceClick以及onPreferenceTreeClick()方法，因此在onPreferenceClick和onPreferenceTreeClick方法中我们得到的控件值就是最新的Preference控件值。

onPreferenceClick 与 onPreferenceTreeClick 的关系

源码：
在类中

    /**
 * 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 && (this)) {
        return;
    }

    PreferenceManager preferenceManager = getPreferenceManager();
    if (preferenceManager != null) {
         listener = preferenceManager
                .getOnPreferenceTreeClickListener();
        if (preferenceScreen != null && listener != null
                && (preferenceScreen, this)) {
            return;
        }
    }

    if (mIntent != null) {
        Context context = getContext();
        (mIntent);
    }
}

从上面代码中，可以很清晰的看出，当onPreferenceClick 返回值为true是，不执行onPreferenceTreeClick

相关文章