java.awt
Class AWTEventMulticaster

java.lang.Object   
  java.awt.AWTEventMulticaster

All Implemented Interfaces:

ActionListener , AdjustmentListener , ComponentListener , ContainerListener , FocusListener , HierarchyBoundsListener , HierarchyListener , InputMethodListener , ItemListener , KeyListener , MouseListener , MouseMotionListener , MouseWheelListener , TextListener , WindowFocusListener , WindowListener , WindowStateListener , EventListener

public class AWTEventMulticaster
extends Object   
implements ComponentListener   , ContainerListener   , FocusListener   , KeyListener   , MouseListener   , MouseMotionListener   , WindowListener   , WindowFocusListener   , WindowStateListener   , ActionListener   , ItemListener   , AdjustmentListener   , TextListener   , InputMethodListener   , HierarchyListener   , HierarchyBoundsListener   , MouseWheelListener   

A class which implements efficient and thread-safe multi-cast event dispatching for the AWT events defined in the java.awt.event package. This class will manage an immutable structure consisting of a chain of event listeners and will dispatch events to those listeners. Because the structure is immutable, it is safe to use this API to add/remove listeners during the process of an event dispatch operation. However, event listeners added during the process of an event dispatch operation will not be notified of the event currently being dispatched. An example of how this class could be used to implement a new component which fires "action" events:

 public myComponent extends Component {
     ActionListener actionListener = null;

     public synchronized void addActionListener(ActionListener l) {
           actionListener = AWTEventMulticaster.add(actionListener, l);
     }
     public synchronized void removeActionListener(ActionListener l) {
           actionListener = AWTEventMulticaster.remove(actionListener, l);
     }
     public void processEvent(AWTEvent e) {
         // when event occurs which causes "action" semantic
         ActionListener listener = actionListener;
         if (listener != null) {
             listener.actionPerformed(new ActionEvent());
         }
     }
 }
 

Since:

1.1

Field Summary

protected EventListener	a
protected EventListener	b

Constructor Summary

protected

AWTEventMulticaster (EventListener a, EventListener b) Creates an event multicaster instance which chains listener-a with listener-b.

Method Summary

void	actionPerformed (ActionEvent e) Handles the actionPerformed event by invoking the actionPerformed methods on listener-a and listener-b.
static ActionListener	add (ActionListener a, ActionListener b) Adds action-listener-a with action-listener-b and returns the resulting multicast listener.
static AdjustmentListener	add (AdjustmentListener a, AdjustmentListener b) Adds adjustment-listener-a with adjustment-listener-b and returns the resulting multicast listener.
static ComponentListener	add (ComponentListener a, ComponentListener b) Adds component-listener-a with component-listener-b and returns the resulting multicast listener.
static ContainerListener	add (ContainerListener a, ContainerListener b) Adds container-listener-a with container-listener-b and returns the resulting multicast listener.
static FocusListener	add (FocusListener a, FocusListener b) Adds focus-listener-a with focus-listener-b and returns the resulting multicast listener.
static HierarchyBoundsListener	add (HierarchyBoundsListener a, HierarchyBoundsListener b) Adds hierarchy-bounds-listener-a with hierarchy-bounds-listener-b and returns the resulting multicast listener.
static HierarchyListener	add (HierarchyListener a, HierarchyListener b) Adds hierarchy-listener-a with hierarchy-listener-b and returns the resulting multicast listener.
static InputMethodListener	add (InputMethodListener a, InputMethodListener b) Adds input-method-listener-a with input-method-listener-b and returns the resulting multicast listener.
static ItemListener	add (ItemListener a, ItemListener b) Adds item-listener-a with item-listener-b and returns the resulting multicast listener.
static KeyListener	add (KeyListener a, KeyListener b) Adds key-listener-a with key-listener-b and returns the resulting multicast listener.
static MouseListener	add (MouseListener a, MouseListener b) Adds mouse-listener-a with mouse-listener-b and returns the resulting multicast listener.
static MouseMotionListener	add (MouseMotionListener a, MouseMotionListener b) Adds mouse-motion-listener-a with mouse-motion-listener-b and returns the resulting multicast listener.
static MouseWheelListener	add (MouseWheelListener a, MouseWheelListener b) Adds mouse-wheel-listener-a with mouse-wheel-listener-b and returns the resulting multicast listener.
static TextListener	add (TextListener a, TextListener b)
static WindowFocusListener	add (WindowFocusListener a, WindowFocusListener b) Adds window-focus-listener-a with window-focus-listener-b and returns the resulting multicast listener.
static WindowListener	add (WindowListener a, WindowListener b) Adds window-listener-a with window-listener-b and returns the resulting multicast listener.
static WindowStateListener	add (WindowStateListener a, WindowStateListener b) Adds window-state-listener-a with window-state-listener-b and returns the resulting multicast listener.
protected static EventListener	addInternal (EventListener a, EventListener b) Returns the resulting multicast listener from adding listener-a and listener-b together.
void	adjustmentValueChanged (AdjustmentEvent e) Handles the adjustmentValueChanged event by invoking the adjustmentValueChanged methods on listener-a and listener-b.
void	ancestorMoved (HierarchyEvent e) Handles the ancestorMoved event by invoking the ancestorMoved methods on listener-a and listener-b.
void	ancestorResized (HierarchyEvent e) Handles the ancestorResized event by invoking the ancestorResized methods on listener-a and listener-b.
void	caretPositionChanged (InputMethodEvent e) Handles the caretPositionChanged event by invoking the caretPositionChanged methods on listener-a and listener-b.
void	componentAdded (ContainerEvent e) Handles the componentAdded container event by invoking the componentAdded methods on listener-a and listener-b.
void	componentHidden (ComponentEvent e) Handles the componentHidden event by invoking the componentHidden methods on listener-a and listener-b.
void	componentMoved (ComponentEvent e) Handles the componentMoved event by invoking the componentMoved methods on listener-a and listener-b.
void	componentRemoved (ContainerEvent e) Handles the componentRemoved container event by invoking the componentRemoved methods on listener-a and listener-b.
void	componentResized (ComponentEvent e) Handles the componentResized event by invoking the componentResized methods on listener-a and listener-b.
void	componentShown (ComponentEvent e) Handles the componentShown event by invoking the componentShown methods on listener-a and listener-b.
void	focusGained (FocusEvent e) Handles the focusGained event by invoking the focusGained methods on listener-a and listener-b.
void	focusLost (FocusEvent e) Handles the focusLost event by invoking the focusLost methods on listener-a and listener-b.
static <T extends EventListener > T[]	getListeners (EventListener l, Class <T> listenerType) Returns an array of all the objects chained as FooListeners by the specified java.util.EventListener.
void	hierarchyChanged (HierarchyEvent e) Handles the hierarchyChanged event by invoking the hierarchyChanged methods on listener-a and listener-b.
void	inputMethodTextChanged (InputMethodEvent e) Handles the inputMethodTextChanged event by invoking the inputMethodTextChanged methods on listener-a and listener-b.
void	itemStateChanged