GWT 2.7.0

com.google.gwt.user.client.ui
Class DelegatingFocusListenerCollection

java.lang.Object
  extended by java.util.AbstractCollection<E>
      extended by java.util.AbstractList<E>
          extended by java.util.ArrayList<FocusListener>
              extended by com.google.gwt.user.client.ui.FocusListenerCollection
                  extended by com.google.gwt.user.client.ui.DelegatingFocusListenerCollection
All Implemented Interfaces:
FocusListener, java.io.Serializable, java.lang.Cloneable, java.lang.Iterable<FocusListener>, java.util.Collection<FocusListener>, java.util.EventListener, java.util.List<FocusListener>, java.util.RandomAccess

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

@Deprecated
public class DelegatingFocusListenerCollection
extends FocusListenerCollection
implements FocusListener

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

  public void addFocusListener(FocusListener listener) {
    if (focusListeners == null) {
      focusListeners = new DelegatingFocusListenerCollection(this, box);
    }
    focusListeners.add(listener);
  }

See Also:
Serialized Form

Field Summary
 
Fields inherited from class java.util.AbstractList
modCount
 
Constructor Summary
DelegatingFocusListenerCollection(Widget owner, SourcesFocusEvents delegatedTo)
          Deprecated. Constructor for DelegatingFocusListenerCollection.
 
Method Summary
 void onFocus(Widget sender)
          Deprecated. Fired when a widget receives keyboard focus.
 void onLostFocus(Widget sender)
          Deprecated. Fired when a widget loses keyboard focus.
 
Methods inherited from class com.google.gwt.user.client.ui.FocusListenerCollection
fireFocus, fireFocusEvent, fireLostFocus
 
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, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface java.util.List
containsAll, equals, hashCode, iterator, listIterator, listIterator, removeAll, retainAll, subList
 

Constructor Detail

DelegatingFocusListenerCollection

public DelegatingFocusListenerCollection(Widget owner,
                                         SourcesFocusEvents delegatedTo)
Deprecated. 
Constructor for DelegatingFocusListenerCollection. *

Parameters:
owner - owner of listeners
delegatedTo - source of events
Method Detail

onFocus

public void onFocus(Widget sender)
Deprecated. 
Description copied from interface: FocusListener
Fired when a widget receives keyboard focus.

Specified by:
onFocus in interface FocusListener
Parameters:
sender - the widget receiving focus.

onLostFocus

public void onLostFocus(Widget sender)
Deprecated. 
Description copied from interface: FocusListener
Fired when a widget loses keyboard focus.

Specified by:
onLostFocus in interface FocusListener
Parameters:
sender - the widget losing focus.

GWT 2.7.0