    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 multi-cast event dispatching for the AWT events defined in the java.awt.event package. This class will manage the structure of a chain of event listeners and dispatch events to those listeners. 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());
             }
     }

##

a
b

##

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

##

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.
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.

##

a

      protected EventListener a

b

      protected EventListener b

##

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

##

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

    All Packages  Class Hierarchy  This Package  Previous  Next  Index