Class java.awt.AWTEventMulticaster 
All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class java.awt.AWTEventMulticaster 

Object
   |
   +----java.awt.AWTEventMulticaster
public class AWTEventMulticaster
extends Object
implements ComponentListener, ContainerListener, FocusListener, KeyListener, MouseListener, MouseMotionListener, WindowListener, ActionListener, ItemListener, AdjustmentListener, TextListener
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. 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 void addActionListener(ActionListener l) {
	   actionListener = AWTEventMulticaster.add(actionListener, l);
     }
     public void removeActionListener(ActionListener l) {
  	   actionListener = AWTEventMulticaster.remove(actionListener, l);
     }
     public void processEvent(AWTEvent e) {
         // when event occurs which causes "action" semantic
         if (actionListener != null) {
             actionListener.actionPerformed(new ActionEvent());
         }         
 }

Version:
1.13, 07/01/98
Author:
John Rose, Amy Fowler

Variable Index

o a
o b

Constructor Index

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

Method Index

o actionPerformed(ActionEvent)
Handles the actionPerformed event by invoking the actionPerformed methods on listener-a and listener-b.
o add(ComponentListener, ComponentListener)
Adds component-listener-a with component-listener-b and returns the resulting multicast listener.
o add(ContainerListener, ContainerListener)
Adds container-listener-a with container-listener-b and returns the resulting multicast listener.
o add(FocusListener, FocusListener)
Adds focus-listener-a with focus-listener-b and returns the resulting multicast listener.
o add(KeyListener, KeyListener)
Adds key-listener-a with key-listener-b and returns the resulting multicast listener.
o add(MouseListener, MouseListener)
Adds mouse-listener-a with mouse-listener-b and returns the resulting multicast listener.
o add(MouseMotionListener, MouseMotionListener)
Adds mouse-motion-listener-a with mouse-motion-listener-b and returns the resulting multicast listener.
o add(WindowListener, WindowListener)
Adds window-listener-a with window-listener-b and returns the resulting multicast listener.
o add(ActionListener, ActionListener)
Adds action-listener-a with action-listener-b and returns the resulting multicast listener.
o add(ItemListener, ItemListener)
Adds item-listener-a with item-listener-b and returns the resulting multicast listener.
o add(AdjustmentListener, AdjustmentListener)
Adds adjustment-listener-a with adjustment-listener-b and returns the resulting multicast listener.
o add(TextListener, TextListener)
o addInternal(EventListener, EventListener)
Returns the resulting multicast listener from adding listener-a and listener-b together.
o adjustmentValueChanged(AdjustmentEvent)
Handles the adjustmentValueChanged event by invoking the adjustmentValueChanged methods on listener-a and listener-b.
o componentAdded(ContainerEvent)
Handles the componentAdded container event by invoking the componentAdded methods on listener-a and listener-b.
o componentHidden(ComponentEvent)
Handles the componentHidden event by invoking the componentHidden methods on listener-a and listener-b.
o componentMoved(ComponentEvent)
Handles the componentMoved event by invoking the componentMoved methods on listener-a and listener-b.
o componentRemoved(ContainerEvent)
Handles the componentRemoved container event by invoking the componentRemoved methods on listener-a and listener-b.
o componentResized(ComponentEvent)
Handles the componentResized event by invoking the componentResized methods on listener-a and listener-b.
o componentShown(ComponentEvent)
Handles the componentShown event by invoking the componentShown methods on listener-a and listener-b.
o focusGained(FocusEvent)
Handles the focusGained event by invoking the focusGained methods on listener-a and listener-b.
o focusLost(FocusEvent)
Handles the focusLost event by invoking the focusLost methods on listener-a and listener-b.
o itemStateChanged(ItemEvent)
Handles the itemStateChanged event by invoking the itemStateChanged methods on listener-a and listener-b.
o keyPressed(KeyEvent)
Handles the keyPressed event by invoking the keyPressed methods on listener-a and listener-b.
o keyReleased(KeyEvent)
Handles the keyReleased event by invoking the keyReleased methods on listener-a and listener-b.
o keyTyped(KeyEvent)
Handles the keyTyped event by invoking the keyTyped methods on listener-a and listener-b.
o mouseClicked(MouseEvent)
Handles the mouseClicked event by invoking the mouseClicked methods on listener-a and listener-b.
o mouseDragged(MouseEvent)
Handles the mouseDragged event by invoking the mouseDragged methods on listener-a and listener-b.
o mouseEntered(MouseEvent)
Handles the mouseEntered event by invoking the mouseEntered methods on listener-a and listener-b.
o mouseExited(MouseEvent)
Handles the mouseExited event by invoking the mouseExited methods on listener-a and listener-b.
o mouseMoved(MouseEvent)
Handles the mouseMoved event by invoking the mouseMoved methods on listener-a and listener-b.
o mousePressed(MouseEvent)
Handles the mousePressed event by invoking the mousePressed methods on listener-a and listener-b.
o mouseReleased(MouseEvent)
Handles the mouseReleased event by invoking the mouseReleased methods on listener-a and listener-b.
o remove(EventListener)
Removes a listener from this multicaster and returns the resulting multicast listener.
o remove(ComponentListener, ComponentListener)
Removes the old component-listener from component-listener-l and returns the resulting multicast listener.
o remove(ContainerListener, ContainerListener)
Removes the old container-listener from container-listener-l and returns the resulting multicast listener.
o remove(FocusListener, FocusListener)
Removes the old focus-listener from focus-listener-l and returns the resulting multicast listener.
o remove(KeyListener, KeyListener)
Removes the old key-listener from key-listener-l and returns the resulting multicast listener.
o remove(MouseListener, MouseListener)
Removes the old mouse-listener from mouse-listener-l and returns the resulting multicast listener.
o remove(MouseMotionListener, MouseMotionListener)
Removes the old mouse-motion-listener from mouse-motion-listener-l and returns the resulting multicast listener.
o remove(WindowListener, WindowListener)
Removes the old window-listener from window-listener-l and returns the resulting multicast listener.
o remove(ActionListener, ActionListener)
Removes the old action-listener from action-listener-l and returns the resulting multicast listener.
o remove(ItemListener, ItemListener)
Removes the old item-listener from item-listener-l and returns the resulting multicast listener.
o remove(AdjustmentListener, AdjustmentListener)
Removes the old adjustment-listener from adjustment-listener-l and returns the resulting multicast listener.
o remove(TextListener, TextListener)
o removeInternal(EventListener, EventListener)
Returns the resulting multicast listener after removing the old listener from listener-l.
o save(ObjectOutputStream, String, EventListener)
o saveInternal(ObjectOutputStream, String)
o textValueChanged(TextEvent)
o windowActivated(WindowEvent)
Handles the windowActivated event by invoking the windowActivated methods on listener-a and listener-b.
o windowClosed(WindowEvent)
Handles the windowClosed event by invoking the windowClosed methods on listener-a and listener-b.
o windowClosing(WindowEvent)
Handles the windowClosing event by invoking the windowClosing methods on listener-a and listener-b.
o windowDeactivated(WindowEvent)
Handles the windowDeactivated event by invoking the windowDeactivated methods on listener-a and listener-b.
o windowDeiconified(WindowEvent)
Handles the windowDeiconfied event by invoking the windowDeiconified methods on listener-a and listener-b.
o windowIconified(WindowEvent)
Handles the windowIconified event by invoking the windowIconified methods on listener-a and listener-b.
o windowOpened(WindowEvent)
Handles the windowOpened event by invoking the windowOpened methods on listener-a and listener-b.

Variables

o a 
protected final java.util.EventListener a
o b 
protected final java.util.EventListener b

Constructors

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

Parameters:
a - listener-a
b - listener-b

Methods

o actionPerformed 
public void actionPerformed(ActionEvent e)
Handles the actionPerformed event by invoking the actionPerformed methods on listener-a and listener-b.

Parameters:
e - the action event
o add 
public static java.awt.event.ComponentListener add(ComponentListener a,
                                                   ComponentListener b)
Adds component-listener-a with component-listener-b and returns the resulting multicast listener.

Parameters:
a - component-listener-a
b - component-listener-b
o add 
public static java.awt.event.ContainerListener add(ContainerListener a,
                                                   ContainerListener b)
Adds container-listener-a with container-listener-b and returns the resulting multicast listener.

Parameters:
a - container-listener-a
b - container-listener-b
o add 
public static java.awt.event.FocusListener add(FocusListener a,
                                               FocusListener b)
Adds focus-listener-a with focus-listener-b and returns the resulting multicast listener.

Parameters:
a - focus-listener-a
b - focus-listener-b
o add 
public static java.awt.event.KeyListener add(KeyListener a,
                                             KeyListener b)
Adds key-listener-a with key-listener-b and returns the resulting multicast listener.

Parameters:
a - key-listener-a
b - key-listener-b
o add 
public static java.awt.event.MouseListener add(MouseListener a,
                                               MouseListener b)
Adds mouse-listener-a with mouse-listener-b and returns the resulting multicast listener.

Parameters:
a - mouse-listener-a
b - mouse-listener-b
o add 
public static java.awt.event.MouseMotionListener add(MouseMotionListener a,
                                                     MouseMotionListener b)
Adds mouse-motion-listener-a with mouse-motion-listener-b and returns the resulting multicast listener.

Parameters:
a - mouse-motion-listener-a
b - mouse-motion-listener-b
o add 
public static java.awt.event.WindowListener add(WindowListener a,
                                                WindowListener b)
Adds window-listener-a with window-listener-b and returns the resulting multicast listener.

Parameters:
a - window-listener-a
b - window-listener-b
o add 
public static java.awt.event.ActionListener add(ActionListener a,
                                                ActionListener b)
Adds action-listener-a with action-listener-b and returns the resulting multicast listener.

Parameters:
a - action-listener-a
b - action-listener-b
o add 
public static java.awt.event.ItemListener add(ItemListener a,
                                              ItemListener b)
Adds item-listener-a with item-listener-b and returns the resulting multicast listener.

Parameters:
a - item-listener-a
b - item-listener-b
o add 
public static java.awt.event.AdjustmentListener add(AdjustmentListener a,
                                                    AdjustmentListener b)
Adds adjustment-listener-a with adjustment-listener-b and returns the resulting multicast listener.

Parameters:
a - adjustment-listener-a
b - adjustment-listener-b
o add 
public static java.awt.event.TextListener add(TextListener a,
                                              TextListener b)
o addInternal 
protected static java.util.EventListener addInternal(EventListener a,
                                                     EventListener b)
Returns the resulting multicast listener from adding listener-a and listener-b together. If listener-a is null, it returns listener-b; If listener-b is null, it returns listener-a If neither are null, then it creates and returns a new AWTEventMulticaster instance which chains a with b.

Parameters:
a - event listener-a
b - event listener-b
o adjustmentValueChanged 
public void adjustmentValueChanged(AdjustmentEvent e)
Handles the adjustmentValueChanged event by invoking the adjustmentValueChanged methods on listener-a and listener-b.

Parameters:
e - the adjustment event
o componentAdded 
public void componentAdded(ContainerEvent e)
Handles the componentAdded container event by invoking the componentAdded methods on listener-a and listener-b.

Parameters:
e - the component event
o componentHidden 
public void componentHidden(ComponentEvent e)
Handles the componentHidden event by invoking the componentHidden methods on listener-a and listener-b.

Parameters:
e - the component event
o componentMoved 
public void componentMoved(ComponentEvent e)
Handles the componentMoved event by invoking the componentMoved methods on listener-a and listener-b.

Parameters:
e - the component event
o componentRemoved 
public void componentRemoved(ContainerEvent e)
Handles the componentRemoved container event by invoking the componentRemoved methods on listener-a and listener-b.

Parameters:
e - the component event
o componentResized 
public void componentResized(ComponentEvent e)
Handles the componentResized event by invoking the componentResized methods on listener-a and listener-b.

Parameters:
e - the component event
o componentShown 
public void componentShown(ComponentEvent e)
Handles the componentShown event by invoking the componentShown methods on listener-a and listener-b.

Parameters:
e - the component event
o focusGained 
public void focusGained(FocusEvent e)
Handles the focusGained event by invoking the focusGained methods on listener-a and listener-b.

Parameters:
e - the focus event
o focusLost 
public void focusLost(FocusEvent e)
Handles the focusLost event by invoking the focusLost methods on listener-a and listener-b.

Parameters:
e - the focus event
o itemStateChanged 
public void itemStateChanged(ItemEvent e)
Handles the itemStateChanged event by invoking the itemStateChanged methods on listener-a and listener-b.

Parameters:
e - the item event
o keyPressed 
public void keyPressed(KeyEvent e)
Handles the keyPressed event by invoking the keyPressed methods on listener-a and listener-b.

Parameters:
e - the key event
o keyReleased 
public void keyReleased(KeyEvent e)
Handles the keyReleased event by invoking the keyReleased methods on listener-a and listener-b.

Parameters:
e - the key event
o keyTyped 
public void keyTyped(KeyEvent e)
Handles the keyTyped event by invoking the keyTyped methods on listener-a and listener-b.

Parameters:
e - the key event
o mouseClicked 
public void mouseClicked(MouseEvent e)
Handles the mouseClicked event by invoking the mouseClicked methods on listener-a and listener-b.

Parameters:
e - the mouse event
o mouseDragged 
public void mouseDragged(MouseEvent e)
Handles the mouseDragged event by invoking the mouseDragged methods on listener-a and listener-b.

Parameters:
e - the mouse event
o mouseEntered 
public void mouseEntered(MouseEvent e)
Handles the mouseEntered event by invoking the mouseEntered methods on listener-a and listener-b.

Parameters:
e - the mouse event
o mouseExited 
public void mouseExited(MouseEvent e)
Handles the mouseExited event by invoking the mouseExited methods on listener-a and listener-b.

Parameters:
e - the mouse event
o mouseMoved 
public void mouseMoved(MouseEvent e)
Handles the mouseMoved event by invoking the mouseMoved methods on listener-a and listener-b.

Parameters:
e - the mouse event
o mousePressed 
public void mousePressed(MouseEvent e)
Handles the mousePressed event by invoking the mousePressed methods on listener-a and listener-b.

Parameters:
e - the mouse event
o mouseReleased 
public void mouseReleased(MouseEvent e)
Handles the mouseReleased event by invoking the mouseReleased methods on listener-a and listener-b.

Parameters:
e - the mouse event
o remove 
protected java.util.EventListener remove(EventListener oldl)
Removes a listener from this multicaster and returns the resulting multicast listener.

Parameters:
oldl - the listener to be removed
o remove 
public static java.awt.event.ComponentListener remove(ComponentListener l,
                                                      ComponentListener oldl)
Removes the old component-listener from component-listener-l and returns the resulting multicast listener.

Parameters:
l - component-listener-l
oldl - the component-listener being removed
o remove 
public static java.awt.event.ContainerListener remove(ContainerListener l,
                                                      ContainerListener oldl)
Removes the old container-listener from container-listener-l and returns the resulting multicast listener.

Parameters:
l - container-listener-l
oldl - the container-listener being removed
o remove 
public static java.awt.event.FocusListener remove(FocusListener l,
                                                  FocusListener oldl)
Removes the old focus-listener from focus-listener-l and returns the resulting multicast listener.

Parameters:
l - focus-listener-l
oldl - the focus-listener being removed
o remove 
public static java.awt.event.KeyListener remove(KeyListener l,
                                                KeyListener oldl)
Removes the old key-listener from key-listener-l and returns the resulting multicast listener.

Parameters:
l - key-listener-l
oldl - the key-listener being removed
o remove 
public static java.awt.event.MouseListener remove(MouseListener l,
                                                  MouseListener oldl)
Removes the old mouse-listener from mouse-listener-l and returns the resulting multicast listener.

Parameters:
l - mouse-listener-l
oldl - the mouse-listener being removed
o remove 
public static java.awt.event.MouseMotionListener remove(MouseMotionListener l,
                                                        MouseMotionListener oldl)
Removes the old mouse-motion-listener from mouse-motion-listener-l and returns the resulting multicast listener.

Parameters:
l - mouse-motion-listener-l
oldl - the mouse-motion-listener being removed
o remove 
public static java.awt.event.WindowListener remove(WindowListener l,
                                                   WindowListener oldl)
Removes the old window-listener from window-listener-l and returns the resulting multicast listener.

Parameters:
l - window-listener-l
oldl - the window-listener being removed
o remove 
public static java.awt.event.ActionListener remove(ActionListener l,
                                                   ActionListener oldl)
Removes the old action-listener from action-listener-l and returns the resulting multicast listener.

Parameters:
l - action-listener-l
oldl - the action-listener being removed
o remove 
public static java.awt.event.ItemListener remove(ItemListener l,
                                                 ItemListener oldl)
Removes the old item-listener from item-listener-l and returns the resulting multicast listener.

Parameters:
l - item-listener-l
oldl - the item-listener being removed
o remove 
public static java.awt.event.AdjustmentListener remove(AdjustmentListener l,
                                                       AdjustmentListener oldl)
Removes the old adjustment-listener from adjustment-listener-l and returns the resulting multicast listener.

Parameters:
l - adjustment-listener-l
oldl - the adjustment-listener being removed
o remove 
public static java.awt.event.TextListener remove(TextListener l,
                                                 TextListener oldl)
o removeInternal 
protected static java.util.EventListener removeInternal(EventListener l,
                                                        EventListener oldl)
Returns the resulting multicast listener after removing the old listener from listener-l. If listener-l equals the old listener OR listener-l is null, returns null. Else if listener-l is an instance of AWTEventMulticaster, then it removes the old listener from it. Else, returns listener l.

Parameters:
l - the listener being removed from
oldl - the listener being removed
o save 
protected static void save(ObjectOutputStream s,
                           String k,
                           EventListener l) throws IOException
o saveInternal 
protected void saveInternal(ObjectOutputStream s,
                            String k) throws IOException
o textValueChanged 
public void textValueChanged(TextEvent e)
o windowActivated 
public void windowActivated(WindowEvent e)
Handles the windowActivated event by invoking the windowActivated methods on listener-a and listener-b.

Parameters:
e - the window event
o windowClosed 
public void windowClosed(WindowEvent e)
Handles the windowClosed event by invoking the windowClosed methods on listener-a and listener-b.

Parameters:
e - the window event
o windowClosing 
public void windowClosing(WindowEvent e)
Handles the windowClosing event by invoking the windowClosing methods on listener-a and listener-b.

Parameters:
e - the window event
o windowDeactivated 
public void windowDeactivated(WindowEvent e)
Handles the windowDeactivated event by invoking the windowDeactivated methods on listener-a and listener-b.

Parameters:
e - the window event
o windowDeiconified 
public void windowDeiconified(WindowEvent e)
Handles the windowDeiconfied event by invoking the windowDeiconified methods on listener-a and listener-b.

Parameters:
e - the window event
o windowIconified 
public void windowIconified(WindowEvent e)
Handles the windowIconified event by invoking the windowIconified methods on listener-a and listener-b.

Parameters:
e - the window event
o windowOpened 
public void windowOpened(WindowEvent e)
Handles the windowOpened event by invoking the windowOpened methods on listener-a and listener-b.

Parameters:
e - the window event 
All Packages  Class Hierarchy  This Package  Previous  Next  Index