Preferences.AddPreferenceChangeListener(IPreferenceChangeListener) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Registers the specified listener to receive preference change events for this preference node.
[Android.Runtime.Register("addPreferenceChangeListener", "(Ljava/util/prefs/PreferenceChangeListener;)V", "GetAddPreferenceChangeListener_Ljava_util_prefs_PreferenceChangeListener_Handler")]
public abstract void AddPreferenceChangeListener (Java.Util.Prefs.IPreferenceChangeListener? pcl);[<Android.Runtime.Register("addPreferenceChangeListener", "(Ljava/util/prefs/PreferenceChangeListener;)V", "GetAddPreferenceChangeListener_Ljava_util_prefs_PreferenceChangeListener_Handler")>]
abstract member AddPreferenceChangeListener : Java.Util.Prefs.IPreferenceChangeListener -> unitParameters
The preference change listener to add.
- Attributes
Exceptions
if the given listener is null.
if this node has been removed.
Remarks
Registers the specified listener to receive preference change events for this preference node. A preference change event is generated when a preference is added to this node, removed from this node, or when the value associated with a preference is changed. (Preference change events are not generated by the #removeNode() method, which generates a node change event. Preference change events are generated by the clear method.)
Events are only guaranteed for changes made within the same JVM as the registered listener, though some implementations may generate events for changes made outside this JVM. Events may be generated before the changes have been made persistent. Events are not generated when preferences are modified in descendants of this node; a caller desiring such events must register with each descendant.
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.