Where Am I? Class Hierarchy (JDK) All Classes (JDK) All Fields and Methods (JDK)

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

a
b

Constructor Index

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

Method Index

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

Variables

a
 protected final EventListener a
b
 protected final EventListener b

Constructors

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

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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
textValueChanged
 public void textValueChanged(TextEvent e)
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
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
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
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
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
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
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
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
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
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
add
 public static TextListener add(TextListener a,
                                TextListener b)
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
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
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
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
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
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
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
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
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
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
remove
 public static TextListener remove(TextListener l,
                                   TextListener oldl)
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
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
saveInternal
 protected void saveInternal(ObjectOutputStream s,
                             String k) throws IOException
save
 protected static void save(ObjectOutputStream s,
                            String k,
                            EventListener l) throws IOException

Where Am I? Class Hierarchy (JDK) All Classes (JDK) All Fields and Methods (JDK)