OnPreferenceClickListener: what does the boolean return value do?

Question

From this example:

private static Preference.OnPreferenceClickListener BindToPreferenceClickListener = new Preference.OnPreferenceClickListener() {
    public boolean onPreferenceClick(Preference preference) {
        boolean isHandled = false;
        if (...) {
           isHandled = true;
        }
        return isHandled;
    }
}

What does the return value of 'true' do? The API documentation states that the value indicates that the click was handled if 'true', but what does that really mean? I thought it meant that the editor for the passed preference was not called and a custom editor could be used instead, but my experimentation concludes that the default editor is called in either state.

Answer 1

As the OnPreferenceChangeListener.onPreferenceChange method documentation says:

Returns True to update the state of the Preference with the new value.

The method is run before persisting the new value to the preferences. If you return false, the value is not persisted. If you return true, it is persisted.