Clarify documentation of AdapterView.OnItemSelectedListener

Bug #5331587

Change-Id: Ic3d6aca573639d6cae3abb45bfe821f5fd31f1bc

diff --git a/core/java/android/widget/AdapterView.java b/core/java/android/widget/AdapterView.java
index 72db8e8..d9c22c4 100644 (file)
--- a/core/java/android/widget/AdapterView.java
+++ b/core/java/android/widget/AdapterView.java
@@ -338,8 +338,10 @@ public abstract class AdapterView<T extends Adapter> extends ViewGroup {
      */
     public interface OnItemSelectedListener {
         /**
-         * Callback method to be invoked when an item in this view has been
-         * selected.
+         * <p>Callback method to be invoked when an item in this view has been
+         * selected. This callback is invoked only when the newly selected
+         * position is different from the previously selected position or if
+         * there was no selected item.</p>
          *
          * Impelmenters can call getItemAtPosition(position) if they need to access the
          * data associated with the selected item.