Package com.google.gwt.user.client.ui

Class DelegatingChangeListenerCollection

java.lang.Object
java.util.AbstractCollection<ChangeListener>
java.util.AbstractList<ChangeListener>
java.util.ArrayList<ChangeListener>
com.google.gwt.user.client.ui.ChangeListenerCollection
com.google.gwt.user.client.ui.DelegatingChangeListenerCollection
All Implemented Interfaces:
ChangeListener, Serializable, Cloneable, Iterable<ChangeListener>, Collection<ChangeListener>, EventListener, List<ChangeListener>, RandomAccess, SequencedCollection<ChangeListener>
@Deprecated public class DelegatingChangeListenerCollection extends ChangeListenerCollection implements ChangeListener
Deprecated.
Use Widget.delegateEvent instead
ChangeListenerCollection used to correctly hook up listeners which need to listen to events from another source.

For example, Composite widgets often need to listen to events generated on their wrapped widget. Upon the firing of a wrapped widget's event, the composite widget must fire its own listeners with itself as the source of the event. To use a DelegatingChangeListenerCollection, simply use the DelegatingChangeListenerCollection instead of a ChangeListenerCollection. For example, in SuggestBox, the following code is used to listen to change events on the SuggestBox's underlying widget. 

  public void addChangeListener(ChangeListener listener) {
    if (changeListeners == null) {
      changeListeners = new DelegatingChangeListenerCollection(this, box);
    }
    changeListeners.add(listener);
  }
See Also: