com.google.gwt.user.client.ui

Class DelegatingClickListenerCollection

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

java.util.ArrayList<ClickListener>

com.google.gwt.user.client.ui.ClickListenerCollection

com.google.gwt.user.client.ui.DelegatingClickListenerCollection

All Implemented Interfaces:

ClickListener, Serializable, Cloneable, Iterable<ClickListener>, Collection<ClickListener>, EventListener, List<ClickListener>, RandomAccess

Deprecated.

Use Widget.delegateEvent(com.google.gwt.user.client.ui.Widget, com.google.gwt.event.shared.GwtEvent<?>) instead

@Deprecated
public class DelegatingClickListenerCollection
extends ClickListenerCollection
implements ClickListener

ClickListenerCollection 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 DelegatingClickListenerCollection, simply use the DelegatingClickListenerCollection instead of a ClickListenerCollection. For example, in SuggestBox, the following code is used to listen to click events on the SuggestBox's underlying widget.

  public void addClickListener(ClickListener listener) {
    if (clickListeners == null) {
      clickListeners = new DelegatingClickListenerCollection(this, box);
    }
    clickListeners.add(listener);
  }

See Also:

Serialized Form

Field Summary

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor and Description
DelegatingClickListenerCollection(Widget owner, SourcesClickEvents delegatedTo) Deprecated. Constructor for DelegatingClickListenerCollection.

Method Summary

Modifier and Type	Method and Description
void	onClick(Widget sender) Deprecated. Fired when the user clicks on a widget.

Methods inherited from class com.google.gwt.user.client.ui.ClickListenerCollection

fireClick

Methods inherited from class java.util.ArrayList

add, add, addAll, addAll, clear, clone, contains, ensureCapacity, get, indexOf, isEmpty, lastIndexOf, remove, remove, removeRange, set, size, toArray, toArray, trimToSize

Methods inherited from class java.util.AbstractList

equals, hashCode, iterator, listIterator, listIterator, subList

Methods inherited from class java.util.AbstractCollection

containsAll, removeAll, retainAll, toString

Methods inherited from class java.lang.Object

finalize, getClass

Methods inherited from interface java.util.List

containsAll, equals, hashCode, iterator, listIterator, listIterator, removeAll, retainAll, subList

Constructor Detail

DelegatingClickListenerCollection

public DelegatingClickListenerCollection(Widget owner,
                                         SourcesClickEvents delegatedTo)

Deprecated.

Constructor for DelegatingClickListenerCollection.

Parameters:

owner - owner of listeners

delegatedTo - source of events

Method Detail

onClick

public void onClick(Widget sender)

Deprecated.

Description copied from interface: ClickListener

Fired when the user clicks on a widget.

Specified by:

onClick in interface ClickListener

Parameters:

sender - the widget sending the event.