java.awt
Class AWTEventMulticaster

java.lang.Object
  extended by 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

This class is used to implement a chain of event handlers. Dispatching using this class is thread safe. Here is a quick example of how to add and delete listeners using this class. For this example, we will assume are firing AdjustmentEvent's. However, this same approach is useful for all events in the java.awt.event package, and more if this class is subclassed.

AdjustmentListener al; public void addAdjustmentListener(AdjustmentListener listener) { al = AWTEventMulticaster.add(al, listener); } public void removeAdjustmentListener(AdjustmentListener listener) { al = AWTEventMulticaster.remove(al, listener); }

When it come time to process an event, simply call al, assuming it is not null, and all listeners in the chain will be fired.

The first time add is called it is passed null and listener as its arguments. This starts building the chain. This class returns listener which becomes the new al. The next time, add is called with al and listener and the new listener is then chained to the old.

Since:
1.1

Field Summary
protected  EventListener a
          A variable in the event chain.
protected  EventListener b
          A variable in the event chain.
 
Constructor Summary
protected AWTEventMulticaster(EventListener a, EventListener b)
          Initializes a new instance of AWTEventMulticaster with the specified event listener parameters.
 
Method Summary
 void actionPerformed(ActionEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
static ActionListener add(ActionListener a, ActionListener b)
          Chain ActionListener a and b.
static AdjustmentListener add(AdjustmentListener a, AdjustmentListener b)
          Chain AdjustmentListener a and b.
static ComponentListener add(ComponentListener a, ComponentListener b)
          Chain ComponentListener a and b.
static ContainerListener add(ContainerListener a, ContainerListener b)
          Chain ContainerListener a and b.
static FocusListener add(FocusListener a, FocusListener b)
          Chain FocusListener a and b.
static HierarchyBoundsListener add(HierarchyBoundsListener a, HierarchyBoundsListener b)
          Chain HierarchyBoundsListener a and b.
static HierarchyListener add(HierarchyListener a, HierarchyListener b)
          Chain HierarchyListener a and b.
static InputMethodListener add(InputMethodListener a, InputMethodListener b)
          Chain InputMethodListener a and b.
static ItemListener add(ItemListener a, ItemListener b)
          Chain ItemListener a and b.
static KeyListener add(KeyListener a, KeyListener b)
          Chain KeyListener a and b.
static MouseListener add(MouseListener a, MouseListener b)
          Chain MouseListener a and b.
static MouseMotionListener add(MouseMotionListener a, MouseMotionListener b)
          Chain MouseMotionListener a and b.
static MouseWheelListener add(MouseWheelListener a, MouseWheelListener b)
          Chain MouseWheelListener a and b.
static TextListener add(TextListener a, TextListener b)
          Chain AdjustmentListener a and b.
static WindowFocusListener add(WindowFocusListener a, WindowFocusListener b)
          Chain WindowFocusListener a and b.
static WindowListener add(WindowListener a, WindowListener b)
          Chain WindowListener a and b.
static WindowStateListener add(WindowStateListener a, WindowStateListener b)
          Chain WindowStateListener a and b.
protected static EventListener addInternal(EventListener a, EventListener b)
          Chain EventListener a and b.
 void adjustmentValueChanged(AdjustmentEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void ancestorMoved(HierarchyEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void ancestorResized(HierarchyEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void caretPositionChanged(InputMethodEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void componentAdded(ContainerEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void componentHidden(ComponentEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void componentMoved(ComponentEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void componentRemoved(ContainerEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void componentResized(ComponentEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void componentShown(ComponentEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void focusGained(FocusEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void focusLost(FocusEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
static
<T extends EventListener>
T[]
getListeners(EventListener l, Class<T> type)
          Returns an array of all chained listeners of the specified type in the given chain.
 void hierarchyChanged(HierarchyEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void inputMethodTextChanged(InputMethodEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void itemStateChanged(ItemEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void keyPressed(KeyEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void keyReleased(KeyEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void keyTyped(KeyEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void mouseClicked(MouseEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void mouseDragged(MouseEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void mouseEntered(MouseEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void mouseExited(MouseEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void mouseMoved(MouseEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void mousePressed(MouseEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void mouseReleased(MouseEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void mouseWheelMoved(MouseWheelEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
static ActionListener remove(ActionListener l, ActionListener oldl)
          Removes the listener oldl from the listener l.
static AdjustmentListener remove(AdjustmentListener l, AdjustmentListener oldl)
          Removes the listener oldl from the listener l.
static ComponentListener remove(ComponentListener l, ComponentListener oldl)
          Removes the listener oldl from the listener l.
static ContainerListener remove(ContainerListener l, ContainerListener oldl)
          Removes the listener oldl from the listener l.
protected  EventListener remove(EventListener oldl)
          Removes one instance of the specified listener from this multicaster chain.
static FocusListener remove(FocusListener l, FocusListener oldl)
          Removes the listener oldl from the listener l.
static HierarchyBoundsListener remove(HierarchyBoundsListener l, HierarchyBoundsListener oldl)
          Removes the listener oldl from the listener l.
static HierarchyListener remove(HierarchyListener l, HierarchyListener oldl)
          Removes the listener oldl from the listener l.
static InputMethodListener remove(InputMethodListener l, InputMethodListener oldl)
          Removes the listener oldl from the listener l.
static ItemListener remove(ItemListener l, ItemListener oldl)
          Removes the listener oldl from the listener l.
static KeyListener remove(KeyListener l, KeyListener oldl)
          Removes the listener oldl from the listener l.
static MouseListener remove(MouseListener l, MouseListener oldl)
          Removes the listener oldl from the listener l.
static MouseMotionListener remove(MouseMotionListener l, MouseMotionListener oldl)
          Removes the listener oldl from the listener l.
static MouseWheelListener remove(MouseWheelListener l, MouseWheelListener oldl)
          Removes the listener oldl from the listener l.
static TextListener remove(TextListener l, TextListener oldl)
          Removes the listener oldl from the listener l.
static WindowFocusListener remove(WindowFocusListener l, WindowFocusListener oldl)
          Removes the listener oldl from the listener l.
static WindowListener remove(WindowListener l, WindowListener oldl)
          Removes the listener oldl from the listener l.
static WindowStateListener remove(WindowStateListener l, WindowStateListener oldl)
          Removes the listener oldl from the listener l.
protected static EventListener removeInternal(EventListener l, EventListener oldl)
          Removes the listener oldl from the listener l.
protected static void save(ObjectOutputStream s, String k, EventListener l)
          Saves a Serializable listener chain to a serialization stream.
protected  void saveInternal(ObjectOutputStream s, String k)
          Saves all Serializable listeners to a serialization stream.
 void textValueChanged(TextEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void windowActivated(WindowEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void windowClosed(WindowEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void windowClosing(WindowEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void windowDeactivated(WindowEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void windowDeiconified(WindowEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void windowGainedFocus(WindowEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void windowIconified(WindowEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void windowLostFocus(WindowEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void windowOpened(WindowEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 void windowStateChanged(WindowEvent e)
          Handles this event by dispatching it to the "a" and "b" listener instances.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

a

protected final EventListener a
A variable in the event chain.


b

protected final EventListener b
A variable in the event chain.

Constructor Detail

AWTEventMulticaster

protected AWTEventMulticaster(EventListener a,
                              EventListener b)
Initializes a new instance of AWTEventMulticaster with the specified event listener parameters. The parameters should not be null, although it is not required to enforce this with a NullPointerException.

Parameters:
a - the "a" listener object
b - the "b" listener object
Method Detail

remove

protected EventListener remove(EventListener oldl)
Removes one instance of the specified listener from this multicaster chain. This descends recursively if either child is a multicaster, and returns a multicaster chain with the old listener removed.

Parameters:
oldl - the object to remove from this multicaster
Returns:
the resulting multicaster with the specified listener removed

componentResized

public void componentResized(ComponentEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
componentResized in interface ComponentListener
Parameters:
e - the event to handle

componentMoved

public void componentMoved(ComponentEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
componentMoved in interface ComponentListener
Parameters:
e - the event to handle

componentShown

public void componentShown(ComponentEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
componentShown in interface ComponentListener
Parameters:
e - the event to handle

componentHidden

public void componentHidden(ComponentEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
componentHidden in interface ComponentListener
Parameters:
e - the event to handle

componentAdded

public void componentAdded(ContainerEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
componentAdded in interface ContainerListener
Parameters:
e - the event to handle

componentRemoved

public void componentRemoved(ContainerEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
componentRemoved in interface ContainerListener
Parameters:
e - the event to handle

focusGained

public void focusGained(FocusEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
focusGained in interface FocusListener
Parameters:
e - the event to handle

focusLost

public void focusLost(FocusEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
focusLost in interface FocusListener
Parameters:
e - the event to handle

keyTyped

public void keyTyped(KeyEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
keyTyped in interface KeyListener
Parameters:
e - the event to handle

keyPressed

public void keyPressed(KeyEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
keyPressed in interface KeyListener
Parameters:
e - the event to handle

keyReleased

public void keyReleased(KeyEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
keyReleased in interface KeyListener
Parameters:
e - the event to handle

mouseClicked

public void mouseClicked(MouseEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
mouseClicked in interface MouseListener
Parameters:
e - the event to handle

mousePressed

public void mousePressed(MouseEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
mousePressed in interface MouseListener
Parameters:
e - the event to handle

mouseReleased

public void mouseReleased(MouseEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
mouseReleased in interface MouseListener
Parameters:
e - the event to handle

mouseEntered

public void mouseEntered(MouseEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
mouseEntered in interface MouseListener
Parameters:
e - the event to handle

mouseExited

public void mouseExited(MouseEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
mouseExited in interface MouseListener
Parameters:
e - the event to handle

mouseDragged

public void mouseDragged(MouseEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
mouseDragged in interface MouseMotionListener
Parameters:
e - the event to handle

mouseMoved

public void mouseMoved(MouseEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
mouseMoved in interface MouseMotionListener
Parameters:
e - the event to handle

windowOpened

public void windowOpened(WindowEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
windowOpened in interface WindowListener
Parameters:
e - the event to handle

windowClosing

public void windowClosing(WindowEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
windowClosing in interface WindowListener
Parameters:
e - the event to handle

windowClosed

public void windowClosed(WindowEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
windowClosed in interface WindowListener
Parameters:
e - the event to handle

windowIconified

public void windowIconified(WindowEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
windowIconified in interface WindowListener
Parameters:
e - the event to handle
See Also:
Frame.setIconImage(Image)

windowDeiconified

public void windowDeiconified(WindowEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
windowDeiconified in interface WindowListener
Parameters:
e - the event to handle

windowActivated

public void windowActivated(WindowEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
windowActivated in interface WindowListener
Parameters:
e - the event to handle

windowDeactivated

public void windowDeactivated(WindowEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
windowDeactivated in interface WindowListener
Parameters:
e - the event to handle

windowStateChanged

public void windowStateChanged(WindowEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
windowStateChanged in interface WindowStateListener
Parameters:
e - the event to handle
Since:
1.4

windowGainedFocus

public void windowGainedFocus(WindowEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
windowGainedFocus in interface WindowFocusListener
Parameters:
e - the event to handle
Since:
1.4

windowLostFocus

public void windowLostFocus(WindowEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
windowLostFocus in interface WindowFocusListener
Parameters:
e - the event to handle
Since:
1.4

actionPerformed

public void actionPerformed(ActionEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
actionPerformed in interface ActionListener
Parameters:
e - the event to handle

itemStateChanged

public void itemStateChanged(ItemEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
itemStateChanged in interface ItemListener
Parameters:
e - the event to handle

adjustmentValueChanged

public void adjustmentValueChanged(AdjustmentEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
adjustmentValueChanged in interface AdjustmentListener
Parameters:
e - the event to handle

textValueChanged

public void textValueChanged(TextEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
textValueChanged in interface TextListener
Parameters:
e - the event to handle

inputMethodTextChanged

public void inputMethodTextChanged(InputMethodEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
inputMethodTextChanged in interface InputMethodListener
Parameters:
e - the event to handle
Since:
1.2

caretPositionChanged

public void caretPositionChanged(InputMethodEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
caretPositionChanged in interface InputMethodListener
Parameters:
e - the event to handle
Since:
1.2

hierarchyChanged

public void hierarchyChanged(HierarchyEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
hierarchyChanged in interface HierarchyListener
Parameters:
e - the event to handle
Since:
1.3

ancestorMoved

public void ancestorMoved(HierarchyEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
ancestorMoved in interface HierarchyBoundsListener
Parameters:
e - the event to handle
Since:
1.3

ancestorResized

public void ancestorResized(HierarchyEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
ancestorResized in interface HierarchyBoundsListener
Parameters:
e - the event to handle
Since:
1.3

mouseWheelMoved

public void mouseWheelMoved(MouseWheelEvent e)
Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:
mouseWheelMoved in interface MouseWheelListener
Parameters:
e - the event to handle
Since:
1.4

add

public static ComponentListener add(ComponentListener a,
                                    ComponentListener b)
Chain ComponentListener a and b.

Parameters:
a - the "a" listener, may be null
b - the "b" listener, may be null
Returns:
latest entry in the chain

add

public static ContainerListener add(ContainerListener a,
                                    ContainerListener b)
Chain ContainerListener a and b.

Parameters:
a - the "a" listener, may be null
b - the "b" listener, may be null
Returns:
latest entry in the chain

add

public static FocusListener add(FocusListener a,
                                FocusListener b)
Chain FocusListener a and b.

Parameters:
a - the "a" listener, may be null
b - the "b" listener, may be null
Returns:
latest entry in the chain

add

public static KeyListener add(KeyListener a,
                              KeyListener b)
Chain KeyListener a and b.

Parameters:
a - the "a" listener, may be null
b - the "b" listener, may be null
Returns:
latest entry in the chain

add

public static MouseListener add(MouseListener a,
                                MouseListener b)
Chain MouseListener a and b.

Parameters:
a - the "a" listener, may be null
b - the "b" listener, may be null
Returns:
latest entry in the chain

add

public static MouseMotionListener add(MouseMotionListener a,
                                      MouseMotionListener b)
Chain MouseMotionListener a and b.

Parameters:
a - the "a" listener, may be null
b - the "b" listener, may be null
Returns:
latest entry in the chain

add

public static WindowListener add(WindowListener a,
                                 WindowListener b)
Chain WindowListener a and b.

Parameters:
a - the "a" listener, may be null
b - the "b" listener, may be null
Returns:
latest entry in the chain

add

public static WindowStateListener add(WindowStateListener a,
                                      WindowStateListener b)
Chain WindowStateListener a and b.

Parameters:
a - the "a" listener, may be null
b - the "b" listener, may be null
Returns:
latest entry in the chain
Since:
1.4

add

public static WindowFocusListener add(WindowFocusListener a,
                                      WindowFocusListener b)
Chain WindowFocusListener a and b.

Parameters:
a - the "a" listener, may be null
b - the "b" listener, may be null
Returns:
latest entry in the chain
Since:
1.4

add

public static ActionListener add(ActionListener a,
                                 ActionListener b)
Chain ActionListener a and b.

Parameters:
a - the "a" listener, may be null
b - the "b" listener, may be null
Returns:
latest entry in the chain

add

public static ItemListener add(ItemListener a,
                               ItemListener b)
Chain ItemListener a and b.

Parameters:
a - the "a" listener, may be null
b - the "b" listener, may be null
Returns:
latest entry in the chain

add

public static AdjustmentListener add(AdjustmentListener a,
                                     AdjustmentListener b)
Chain AdjustmentListener a and b.

Parameters:
a - the "a" listener, may be null
b - the "b" listener, may be null
Returns:
latest entry in the chain

add

public static TextListener add(TextListener a,
                               TextListener b)
Chain AdjustmentListener a and b.

Parameters:
a - the "a" listener, may be null
b - the "b" listener, may be null
Returns:
latest entry in the chain

add

public static InputMethodListener add(InputMethodListener a,
                                      InputMethodListener b)
Chain InputMethodListener a and b.

Parameters:
a - the "a" listener, may be null
b - the "b" listener, may be null
Returns:
latest entry in the chain
Since:
1.2

add

public static HierarchyListener add(HierarchyListener a,
                                    HierarchyListener b)
Chain HierarchyListener a and b.

Parameters:
a - the "a" listener, may be null
b - the "b" listener, may be null
Returns:
latest entry in the chain
Since:
1.3

add

public static HierarchyBoundsListener add(HierarchyBoundsListener a,
                                          HierarchyBoundsListener b)
Chain HierarchyBoundsListener a and b.

Parameters:
a - the "a" listener, may be null
b - the "b" listener, may be null
Returns:
latest entry in the chain
Since:
1.3

add

public static MouseWheelListener add(MouseWheelListener a,
                                     MouseWheelListener b)
Chain MouseWheelListener a and b.

Parameters:
a - the "a" listener, may be null
b - the "b" listener, may be null
Returns:
latest entry in the chain
Since:
1.4

remove

public static ComponentListener remove(ComponentListener l,
                                       ComponentListener oldl)
Removes the listener oldl from the listener l.

Parameters:
l - the listener chain to reduce
oldl - the listener to remove
Returns:
the resulting listener chain

remove

public static ContainerListener remove(ContainerListener l,
                                       ContainerListener oldl)
Removes the listener oldl from the listener l.

Parameters:
l - the listener chain to reduce
oldl - the listener to remove
Returns:
the resulting listener chain

remove

public static FocusListener remove(FocusListener l,
                                   FocusListener oldl)
Removes the listener oldl from the listener l.

Parameters:
l - the listener chain to reduce
oldl - the listener to remove
Returns:
the resulting listener chain

remove

public static KeyListener remove(KeyListener l,
                                 KeyListener oldl)
Removes the listener oldl from the listener l.

Parameters:
l - the listener chain to reduce
oldl - the listener to remove
Returns:
the resulting listener chain

remove

public static MouseListener remove(MouseListener l,
                                   MouseListener oldl)
Removes the listener oldl from the listener l.

Parameters:
l - the listener chain to reduce
oldl - the listener to remove
Returns:
the resulting listener chain

remove

public static MouseMotionListener remove(MouseMotionListener l,
                                         MouseMotionListener oldl)
Removes the listener oldl from the listener l.

Parameters:
l - the listener chain to reduce
oldl - the listener to remove
Returns:
the resulting listener chain

remove

public static WindowListener remove(WindowListener l,
                                    WindowListener oldl)
Removes the listener oldl from the listener l.

Parameters:
l - the listener chain to reduce
oldl - the listener to remove
Returns:
the resulting listener chain

remove

public static WindowStateListener remove(WindowStateListener l,
                                         WindowStateListener oldl)
Removes the listener oldl from the listener l.

Parameters:
l - the listener chain to reduce
oldl - the listener to remove
Returns:
the resulting listener chain
Since:
1.4

remove

public static WindowFocusListener remove(WindowFocusListener l,
                                         WindowFocusListener oldl)
Removes the listener oldl from the listener l.

Parameters:
l - the listener chain to reduce
oldl - the listener to remove
Returns:
the resulting listener chain
Since:
1.4

remove

public static ActionListener remove(ActionListener l,
                                    ActionListener oldl)
Removes the listener oldl from the listener l.

Parameters:
l - the listener chain to reduce
oldl - the listener to remove
Returns:
the resulting listener chain

remove

public static ItemListener remove(ItemListener l,
                                  ItemListener oldl)
Removes the listener oldl from the listener l.

Parameters:
l - the listener chain to reduce
oldl - the listener to remove
Returns:
the resulting listener chain

remove

public static AdjustmentListener remove(AdjustmentListener l,
                                        AdjustmentListener oldl)
Removes the listener oldl from the listener l.

Parameters:
l - the listener chain to reduce
oldl - the listener to remove
Returns:
the resulting listener chain

remove

public static TextListener remove(TextListener l,
                                  TextListener oldl)
Removes the listener oldl from the listener l.

Parameters:
l - the listener chain to reduce
oldl - the listener to remove
Returns:
the resulting listener chain

remove

public static InputMethodListener remove(InputMethodListener l,
                                         InputMethodListener oldl)
Removes the listener oldl from the listener l.

Parameters:
l - the listener chain to reduce
oldl - the listener to remove
Returns:
the resulting listener chain
Since:
1.2

remove

public static HierarchyListener remove(HierarchyListener l,
                                       HierarchyListener oldl)
Removes the listener oldl from the listener l.

Parameters:
l - the listener chain to reduce
oldl - the listener to remove
Returns:
the resulting listener chain
Since:
1.3

remove

public static HierarchyBoundsListener remove(HierarchyBoundsListener l,
                                             HierarchyBoundsListener oldl)
Removes the listener oldl from the listener l.

Parameters:
l - the listener chain to reduce
oldl - the listener to remove
Returns:
the resulting listener chain
Since:
1.3

remove

public static MouseWheelListener remove(MouseWheelListener l,
                                        MouseWheelListener oldl)
Removes the listener oldl from the listener l.

Parameters:
l - the listener chain to reduce
oldl - the listener to remove
Returns:
the resulting listener chain
Since:
1.4

addInternal

protected static EventListener addInternal(EventListener a,
                                           EventListener b)
Chain EventListener a and b.

Parameters:
a - the "a" listener, may be null
b - the "b" listener, may be null
Returns:
latest entry in the chain

removeInternal

protected static EventListener removeInternal(EventListener l,
                                              EventListener oldl)
Removes the listener oldl from the listener l.

Parameters:
l - the listener chain to reduce
oldl - the listener to remove
Returns:
the resulting listener chain

saveInternal

protected void saveInternal(ObjectOutputStream s,
                            String k)
                     throws IOException
Saves all Serializable listeners to a serialization stream.

Parameters:
s - the stream to save to
k - a prefix stream put before each serializable listener
Throws:
IOException - if serialization fails

save

protected static void save(ObjectOutputStream s,
                           String k,
                           EventListener l)
                    throws IOException
Saves a Serializable listener chain to a serialization stream.

Parameters:
s - the stream to save to
k - a prefix stream put before each serializable listener
l - the listener chain to save
Throws:
IOException - if serialization fails

getListeners

public static <T extends EventListener> T[] getListeners(EventListener l,
                                                         Class<T> type)
Returns an array of all chained listeners of the specified type in the given chain. A null listener returns an empty array, and a listener which is not an AWTEventMulticaster returns an array of one element. If no listeners in the chain are of the specified type, an empty array is returned.

Parameters:
l - the listener chain to convert to an array
type - the type of listeners to collect
Returns:
an array of the listeners of that type in the chain
Throws:
ClassCastException - if type is not assignable from EventListener
NullPointerException - if type is null
IllegalArgumentException - if type is Void.TYPE
Since:
1.4