All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class java.awt.AWTEventMulticaster

java.lang.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());
         }         
 }
 


Variable Index

 o a
 o b

Constructor Index

 o 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(ActionListener, ActionListener)
Adds action-listener-a with action-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(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(ItemListener, ItemListener)
Adds item-listener-a with item-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(TextListener, TextListener)
 o add(WindowListener, WindowListener)
Adds window-listener-a with window-listener-b and returns the resulting multicast listener.
 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(ActionListener, ActionListener)
Removes the old action-listener from action-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(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(EventListener)
Removes a listener from this multicaster 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(ItemListener, ItemListener)
Removes the old item-listener from item-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(TextListener, TextListener)
 o remove(WindowListener, WindowListener)
Removes the old window-listener from window-listener-l and returns the resulting multicast listener.
 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 EventListener a
 o b
 protected final 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 remove
 protected EventListener remove(EventListener oldl)
Removes a listener from this multicaster and returns the resulting multicast listener.

Parameters:
oldl - the listener to be removed
 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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
 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 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 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 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 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 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 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 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 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 textValueChanged
 public void textValueChanged(TextEvent e)
 o add
 public static 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 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 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 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 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 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 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 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 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 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 TextListener add(TextListener a,
                                TextListener b)
 o remove
 public static 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 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 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 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 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 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 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 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 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 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 TextListener remove(TextListener l,
                                   TextListener oldl)
 o addInternal
 protected static 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 removeInternal
 protected static 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 saveInternal
 protected void saveInternal(ObjectOutputStream s,
                             String k) throws IOException
 o save
 protected static void save(ObjectOutputStream s,
                            String k,
                            EventListener l) throws IOException

All Packages  Class Hierarchy  This Package  Previous  Next  Index

Submit a bug or feature - Version 1.1.8 of Java Platform API Specification
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1995-1999 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.