Docs the fact that setting selection programmatically does not fire events.
Issue: 689
Patch by: jgw
Review by: rdayal
git-svn-id: https://google-web-toolkit.googlecode.com/svn/trunk@1144 8db76d5a-ed1c-0410-87a9-c151d255dfc7
diff --git a/user/src/com/google/gwt/user/client/ui/ListBox.java b/user/src/com/google/gwt/user/client/ui/ListBox.java
index d26b083..6c5c5c8 100644
--- a/user/src/com/google/gwt/user/client/ui/ListBox.java
+++ b/user/src/com/google/gwt/user/client/ui/ListBox.java
@@ -1,5 +1,5 @@
/*
- * Copyright 2006 Google Inc.
+ * Copyright 2007 Google Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
@@ -240,6 +240,11 @@
/**
* Sets whether an individual list item is selected.
*
+ * <p>
+ * Note that setting the selection programmatically does <em>not</em> cause
+ * the {@link ChangeListener#onChange(Widget)} event to be fired.
+ * </p>
+ *
* @param index the index of the item to be selected or unselected
* @param selected <code>true</code> to select the item
*/
@@ -285,6 +290,11 @@
/**
* Sets the currently selected index.
*
+ * <p>
+ * Note that setting the selected index programmatically does <em>not</em>
+ * cause the {@link ChangeListener#onChange(Widget)} event to be fired.
+ * </p>
+ *
* @param index the index of the item to be selected
*/
public void setSelectedIndex(int index) {
