svn commit: r1829099 - /pivot/trunk/wtk/src/org/apache/pivot/wtk/ListViewSelectionListener.java

[rw...@apache.org]

Author: rwhitcomb
Date: Fri Apr 13 20:34:27 2018
New Revision: 1829099

URL: http://svn.apache.org/viewvc?rev=1829099&view=rev
Log:
Update the Javaodoc in ListViewSelectionListener to better explain
how and when the various listener methods are called.

Modified:
    pivot/trunk/wtk/src/org/apache/pivot/wtk/ListViewSelectionListener.java

Modified: pivot/trunk/wtk/src/org/apache/pivot/wtk/ListViewSelectionListener.java
URL: http://svn.apache.org/viewvc/pivot/trunk/wtk/src/org/apache/pivot/wtk/ListViewSelectionListener.java?rev=1829099&r1=1829098&r2=1829099&view=diff
==============================================================================
--- pivot/trunk/wtk/src/org/apache/pivot/wtk/ListViewSelectionListener.java (original)
+++ pivot/trunk/wtk/src/org/apache/pivot/wtk/ListViewSelectionListener.java Fri Apr 13 20:34:27 2018
@@ -99,7 +99,10 @@ public interface ListViewSelectionListen
     }
 
     /**
-     * Called when a list view's selection state has changed.
+     * Called when a list view's selection state has changed. Called in any select mode, and
+     * will be called BEFORE the {@link #selectedItemChanged} callback if the ListView is in
+     * single-select mode.  But, will be called AFTER either {@link #selectedRangeAdded} or
+     * {@link #selectedRangeRemoved} if appropriate.
      *
      * @param listView The source of the event.
      * @param previousSelectedRanges If the selection changed directly, contains
@@ -111,7 +114,7 @@ public interface ListViewSelectionListen
     }
 
     /**
-     * Called when a list view's selected item has changed.
+     * Called when a list view's selected item has changed. Only called in single-select mode.
      *
      * @param listView The source of the event.
      * @param previousSelectedItem The item that was previously selected.