java.awt

Class AWTEventMulticaster

java.lang.Object

java.awt.AWTEventMulticaster

All Implemented Interfaces:

java.awt.event.ActionListener, java.awt.event.AdjustmentListener, java.awt.event.ComponentListener, java.awt.event.ContainerListener, java.awt.event.FocusListener, java.awt.event.HierarchyBoundsListener, java.awt.event.HierarchyListener, java.awt.event.InputMethodListener, java.awt.event.ItemListener, java.awt.event.KeyListener, java.awt.event.MouseListener, java.awt.event.MouseMotionListener, java.awt.event.MouseWheelListener, java.awt.event.TextListener, java.awt.event.WindowFocusListener, java.awt.event.WindowListener, java.awt.event.WindowStateListener, java.util.EventListener

public class AWTEventMulticaster
extends java.lang.Object
implements java.awt.event.ComponentListener, java.awt.event.ContainerListener, java.awt.event.FocusListener, java.awt.event.KeyListener, java.awt.event.MouseListener, java.awt.event.MouseMotionListener, java.awt.event.WindowListener, java.awt.event.WindowFocusListener, java.awt.event.WindowStateListener, java.awt.event.ActionListener, java.awt.event.ItemListener, java.awt.event.AdjustmentListener, java.awt.event.TextListener, java.awt.event.InputMethodListener, java.awt.event.HierarchyListener, java.awt.event.HierarchyBoundsListener, java.awt.event.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

Fields

Modifier and Type	Field and Description
protected java.util.EventListener	a A variable in the event chain.
protected java.util.EventListener	b A variable in the event chain.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AWTEventMulticaster(java.util.EventListener a, java.util.EventListener b) Initializes a new instance of AWTEventMulticaster with the specified event listener parameters.

Method Summary

Methods

Modifier and Type	Method and Description
void	actionPerformed(java.awt.event.ActionEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
static java.awt.event.ActionListener	add(java.awt.event.ActionListener a, java.awt.event.ActionListener b) Chain ActionListener a and b.
static java.awt.event.AdjustmentListener	add(java.awt.event.AdjustmentListener a, java.awt.event.AdjustmentListener b) Chain AdjustmentListener a and b.
static java.awt.event.ComponentListener	add(java.awt.event.ComponentListener a, java.awt.event.ComponentListener b) Chain ComponentListener a and b.
static java.awt.event.ContainerListener	add(java.awt.event.ContainerListener a, java.awt.event.ContainerListener b) Chain ContainerListener a and b.
static java.awt.event.FocusListener	add(java.awt.event.FocusListener a, java.awt.event.FocusListener b) Chain FocusListener a and b.
static java.awt.event.HierarchyBoundsListener	add(java.awt.event.HierarchyBoundsListener a, java.awt.event.HierarchyBoundsListener b) Chain HierarchyBoundsListener a and b.
static java.awt.event.HierarchyListener	add(java.awt.event.HierarchyListener a, java.awt.event.HierarchyListener b) Chain HierarchyListener a and b.
static java.awt.event.InputMethodListener	add(java.awt.event.InputMethodListener a, java.awt.event.InputMethodListener b) Chain InputMethodListener a and b.
static java.awt.event.ItemListener	add(java.awt.event.ItemListener a, java.awt.event.ItemListener b) Chain ItemListener a and b.
static java.awt.event.KeyListener	add(java.awt.event.KeyListener a, java.awt.event.KeyListener b) Chain KeyListener a and b.
static java.awt.event.MouseListener	add(java.awt.event.MouseListener a, java.awt.event.MouseListener b) Chain MouseListener a and b.
static java.awt.event.MouseMotionListener	add(java.awt.event.MouseMotionListener a, java.awt.event.MouseMotionListener b) Chain MouseMotionListener a and b.
static java.awt.event.MouseWheelListener	add(java.awt.event.MouseWheelListener a, java.awt.event.MouseWheelListener b) Chain MouseWheelListener a and b.
static java.awt.event.TextListener	add(java.awt.event.TextListener a, java.awt.event.TextListener b) Chain AdjustmentListener a and b.
static java.awt.event.WindowFocusListener	add(java.awt.event.WindowFocusListener a, java.awt.event.WindowFocusListener b) Chain WindowFocusListener a and b.
static java.awt.event.WindowListener	add(java.awt.event.WindowListener a, java.awt.event.WindowListener b) Chain WindowListener a and b.
static java.awt.event.WindowStateListener	add(java.awt.event.WindowStateListener a, java.awt.event.WindowStateListener b) Chain WindowStateListener a and b.
protected static java.util.EventListener	addInternal(java.util.EventListener a, java.util.EventListener b) Chain EventListener a and b.
void	adjustmentValueChanged(java.awt.event.AdjustmentEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	ancestorMoved(java.awt.event.HierarchyEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	ancestorResized(java.awt.event.HierarchyEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	caretPositionChanged(java.awt.event.InputMethodEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	componentAdded(java.awt.event.ContainerEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	componentHidden(java.awt.event.ComponentEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	componentMoved(java.awt.event.ComponentEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	componentRemoved(java.awt.event.ContainerEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	componentResized(java.awt.event.ComponentEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	componentShown(java.awt.event.ComponentEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	focusGained(java.awt.event.FocusEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	focusLost(java.awt.event.FocusEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
static <T extends java.util.EventListener> T[]	getListeners(java.util.EventListener l, java.lang.Class<T> type) Returns an array of all chained listeners of the specified type in the given chain.
void	hierarchyChanged(java.awt.event.HierarchyEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	inputMethodTextChanged(java.awt.event.InputMethodEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	itemStateChanged(java.awt.event.ItemEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	keyPressed(java.awt.event.KeyEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	keyReleased(java.awt.event.KeyEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	keyTyped(java.awt.event.KeyEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	mouseClicked(java.awt.event.MouseEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	mouseDragged(java.awt.event.MouseEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	mouseEntered(java.awt.event.MouseEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	mouseExited(java.awt.event.MouseEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	mouseMoved(java.awt.event.MouseEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	mousePressed(java.awt.event.MouseEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	mouseReleased(java.awt.event.MouseEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	mouseWheelMoved(java.awt.event.MouseWheelEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
static java.awt.event.ActionListener	remove(java.awt.event.ActionListener l, java.awt.event.ActionListener oldl) Removes the listener oldl from the listener l.
static java.awt.event.AdjustmentListener	remove(java.awt.event.AdjustmentListener l, java.awt.event.AdjustmentListener oldl) Removes the listener oldl from the listener l.
static java.awt.event.ComponentListener	remove(java.awt.event.ComponentListener l, java.awt.event.ComponentListener oldl) Removes the listener oldl from the listener l.
static java.awt.event.ContainerListener	remove(java.awt.event.ContainerListener l, java.awt.event.ContainerListener oldl) Removes the listener oldl from the listener l.
protected java.util.EventListener	remove(java.util.EventListener oldl) Removes one instance of the specified listener from this multicaster chain.
static java.awt.event.FocusListener	remove(java.awt.event.FocusListener l, java.awt.event.FocusListener oldl) Removes the listener oldl from the listener l.
static java.awt.event.HierarchyBoundsListener	remove(java.awt.event.HierarchyBoundsListener l, java.awt.event.HierarchyBoundsListener oldl) Removes the listener oldl from the listener l.
static java.awt.event.HierarchyListener	remove(java.awt.event.HierarchyListener l, java.awt.event.HierarchyListener oldl) Removes the listener oldl from the listener l.
static java.awt.event.InputMethodListener	remove(java.awt.event.InputMethodListener l, java.awt.event.InputMethodListener oldl) Removes the listener oldl from the listener l.
static java.awt.event.ItemListener	remove(java.awt.event.ItemListener l, java.awt.event.ItemListener oldl) Removes the listener oldl from the listener l.
static java.awt.event.KeyListener	remove(java.awt.event.KeyListener l, java.awt.event.KeyListener oldl) Removes the listener oldl from the listener l.
static java.awt.event.MouseListener	remove(java.awt.event.MouseListener l, java.awt.event.MouseListener oldl) Removes the listener oldl from the listener l.
static java.awt.event.MouseMotionListener	remove(java.awt.event.MouseMotionListener l, java.awt.event.MouseMotionListener oldl) Removes the listener oldl from the listener l.
static java.awt.event.MouseWheelListener	remove(java.awt.event.MouseWheelListener l, java.awt.event.MouseWheelListener oldl) Removes the listener oldl from the listener l.
static java.awt.event.TextListener	remove(java.awt.event.TextListener l, java.awt.event.TextListener oldl) Removes the listener oldl from the listener l.
static java.awt.event.WindowFocusListener	remove(java.awt.event.WindowFocusListener l, java.awt.event.WindowFocusListener oldl) Removes the listener oldl from the listener l.
static java.awt.event.WindowListener	remove(java.awt.event.WindowListener l, java.awt.event.WindowListener oldl) Removes the listener oldl from the listener l.
static java.awt.event.WindowStateListener	remove(java.awt.event.WindowStateListener l, java.awt.event.WindowStateListener oldl) Removes the listener oldl from the listener l.
protected static java.util.EventListener	removeInternal(java.util.EventListener l, java.util.EventListener oldl) Removes the listener oldl from the listener l.
protected static void	save(java.io.ObjectOutputStream s, java.lang.String k, java.util.EventListener l) Saves a Serializable listener chain to a serialization stream.
protected void	saveInternal(java.io.ObjectOutputStream s, java.lang.String k) Saves all Serializable listeners to a serialization stream.
void	textValueChanged(java.awt.event.TextEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	windowActivated(java.awt.event.WindowEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	windowClosed(java.awt.event.WindowEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	windowClosing(java.awt.event.WindowEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	windowDeactivated(java.awt.event.WindowEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	windowDeiconified(java.awt.event.WindowEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	windowGainedFocus(java.awt.event.WindowEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	windowIconified(java.awt.event.WindowEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	windowLostFocus(java.awt.event.WindowEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	windowOpened(java.awt.event.WindowEvent e) Handles this event by dispatching it to the "a" and "b" listener instances.
void	windowStateChanged(java.awt.event.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 java.util.EventListener a

A variable in the event chain.

b

protected final java.util.EventListener b

A variable in the event chain.

Constructor Detail

AWTEventMulticaster

protected AWTEventMulticaster(java.util.EventListener a,
                   java.util.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 java.util.EventListener remove(java.util.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(java.awt.event.ComponentEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

componentResized in interface java.awt.event.ComponentListener

Parameters:

e - the event to handle

componentMoved

public void componentMoved(java.awt.event.ComponentEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

componentMoved in interface java.awt.event.ComponentListener

Parameters:

e - the event to handle

componentShown

public void componentShown(java.awt.event.ComponentEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

componentShown in interface java.awt.event.ComponentListener

Parameters:

e - the event to handle

componentHidden

public void componentHidden(java.awt.event.ComponentEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

componentHidden in interface java.awt.event.ComponentListener

Parameters:

e - the event to handle

componentAdded

public void componentAdded(java.awt.event.ContainerEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

componentAdded in interface java.awt.event.ContainerListener

Parameters:

e - the event to handle

componentRemoved

public void componentRemoved(java.awt.event.ContainerEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

componentRemoved in interface java.awt.event.ContainerListener

Parameters:

e - the event to handle

focusGained

public void focusGained(java.awt.event.FocusEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

focusGained in interface java.awt.event.FocusListener

Parameters:

e - the event to handle

focusLost

public void focusLost(java.awt.event.FocusEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

focusLost in interface java.awt.event.FocusListener

Parameters:

e - the event to handle

keyTyped

public void keyTyped(java.awt.event.KeyEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

keyTyped in interface java.awt.event.KeyListener

Parameters:

e - the event to handle

keyPressed

public void keyPressed(java.awt.event.KeyEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

keyPressed in interface java.awt.event.KeyListener

Parameters:

e - the event to handle

keyReleased

public void keyReleased(java.awt.event.KeyEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

keyReleased in interface java.awt.event.KeyListener

Parameters:

e - the event to handle

mouseClicked

public void mouseClicked(java.awt.event.MouseEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

mouseClicked in interface java.awt.event.MouseListener

Parameters:

e - the event to handle

mousePressed

public void mousePressed(java.awt.event.MouseEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

mousePressed in interface java.awt.event.MouseListener

Parameters:

e - the event to handle

mouseReleased

public void mouseReleased(java.awt.event.MouseEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

mouseReleased in interface java.awt.event.MouseListener

Parameters:

e - the event to handle

mouseEntered

public void mouseEntered(java.awt.event.MouseEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

mouseEntered in interface java.awt.event.MouseListener

Parameters:

e - the event to handle

mouseExited

public void mouseExited(java.awt.event.MouseEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

mouseExited in interface java.awt.event.MouseListener

Parameters:

e - the event to handle

mouseDragged

public void mouseDragged(java.awt.event.MouseEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

mouseDragged in interface java.awt.event.MouseMotionListener

Parameters:

e - the event to handle

mouseMoved

public void mouseMoved(java.awt.event.MouseEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

mouseMoved in interface java.awt.event.MouseMotionListener

Parameters:

e - the event to handle

windowOpened

public void windowOpened(java.awt.event.WindowEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

windowOpened in interface java.awt.event.WindowListener

Parameters:

e - the event to handle

windowClosing

public void windowClosing(java.awt.event.WindowEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

windowClosing in interface java.awt.event.WindowListener

Parameters:

e - the event to handle

windowClosed

public void windowClosed(java.awt.event.WindowEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

windowClosed in interface java.awt.event.WindowListener

Parameters:

e - the event to handle

windowIconified

public void windowIconified(java.awt.event.WindowEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

windowIconified in interface java.awt.event.WindowListener

Parameters:

e - the event to handle

See Also:

Frame.setIconImage(Image)

windowDeiconified

public void windowDeiconified(java.awt.event.WindowEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

windowDeiconified in interface java.awt.event.WindowListener

Parameters:

e - the event to handle

windowActivated

public void windowActivated(java.awt.event.WindowEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

windowActivated in interface java.awt.event.WindowListener

Parameters:

e - the event to handle

windowDeactivated

public void windowDeactivated(java.awt.event.WindowEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

windowDeactivated in interface java.awt.event.WindowListener

Parameters:

e - the event to handle

windowStateChanged

public void windowStateChanged(java.awt.event.WindowEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

windowStateChanged in interface java.awt.event.WindowStateListener

Parameters:

e - the event to handle

Since:

1.4

windowGainedFocus

public void windowGainedFocus(java.awt.event.WindowEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

windowGainedFocus in interface java.awt.event.WindowFocusListener

Parameters:

e - the event to handle

Since:

1.4

windowLostFocus

public void windowLostFocus(java.awt.event.WindowEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

windowLostFocus in interface java.awt.event.WindowFocusListener

Parameters:

e - the event to handle

Since:

1.4

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

actionPerformed in interface java.awt.event.ActionListener

Parameters:

e - the event to handle

itemStateChanged

public void itemStateChanged(java.awt.event.ItemEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

itemStateChanged in interface java.awt.event.ItemListener

Parameters:

e - the event to handle

adjustmentValueChanged

public void adjustmentValueChanged(java.awt.event.AdjustmentEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

adjustmentValueChanged in interface java.awt.event.AdjustmentListener

Parameters:

e - the event to handle

textValueChanged

public void textValueChanged(java.awt.event.TextEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

textValueChanged in interface java.awt.event.TextListener

Parameters:

e - the event to handle

inputMethodTextChanged

public void inputMethodTextChanged(java.awt.event.InputMethodEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

inputMethodTextChanged in interface java.awt.event.InputMethodListener

Parameters:

e - the event to handle

Since:

1.2

caretPositionChanged

public void caretPositionChanged(java.awt.event.InputMethodEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

caretPositionChanged in interface java.awt.event.InputMethodListener

Parameters:

e - the event to handle

Since:

1.2

hierarchyChanged

public void hierarchyChanged(java.awt.event.HierarchyEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

hierarchyChanged in interface java.awt.event.HierarchyListener

Parameters:

e - the event to handle

Since:

1.3

ancestorMoved

public void ancestorMoved(java.awt.event.HierarchyEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

ancestorMoved in interface java.awt.event.HierarchyBoundsListener

Parameters:

e - the event to handle

Since:

1.3

ancestorResized

public void ancestorResized(java.awt.event.HierarchyEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

ancestorResized in interface java.awt.event.HierarchyBoundsListener

Parameters:

e - the event to handle

Since:

1.3

mouseWheelMoved

public void mouseWheelMoved(java.awt.event.MouseWheelEvent e)

Handles this event by dispatching it to the "a" and "b" listener instances.

Specified by:

mouseWheelMoved in interface java.awt.event.MouseWheelListener

Parameters:

e - the event to handle

Since:

1.4

add

public static java.awt.event.ComponentListener add(java.awt.event.ComponentListener a,
                                   java.awt.event.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 java.awt.event.ContainerListener add(java.awt.event.ContainerListener a,
                                   java.awt.event.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 java.awt.event.FocusListener add(java.awt.event.FocusListener a,
                               java.awt.event.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 java.awt.event.KeyListener add(java.awt.event.KeyListener a,
                             java.awt.event.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 java.awt.event.MouseListener add(java.awt.event.MouseListener a,
                               java.awt.event.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 java.awt.event.MouseMotionListener add(java.awt.event.MouseMotionListener a,
                                     java.awt.event.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 java.awt.event.WindowListener add(java.awt.event.WindowListener a,
                                java.awt.event.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 java.awt.event.WindowStateListener add(java.awt.event.WindowStateListener a,
                                     java.awt.event.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 java.awt.event.WindowFocusListener add(java.awt.event.WindowFocusListener a,
                                     java.awt.event.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 java.awt.event.ActionListener add(java.awt.event.ActionListener a,
                                java.awt.event.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 java.awt.event.ItemListener add(java.awt.event.ItemListener a,
                              java.awt.event.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 java.awt.event.AdjustmentListener add(java.awt.event.AdjustmentListener a,
                                    java.awt.event.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 java.awt.event.TextListener add(java.awt.event.TextListener a,
                              java.awt.event.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 java.awt.event.InputMethodListener add(java.awt.event.InputMethodListener a,
                                     java.awt.event.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 java.awt.event.HierarchyListener add(java.awt.event.HierarchyListener a,
                                   java.awt.event.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 java.awt.event.HierarchyBoundsListener add(java.awt.event.HierarchyBoundsListener a,
                                         java.awt.event.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 java.awt.event.MouseWheelListener add(java.awt.event.MouseWheelListener a,
                                    java.awt.event.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 java.awt.event.ComponentListener remove(java.awt.event.ComponentListener l,
                                      java.awt.event.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 java.awt.event.ContainerListener remove(java.awt.event.ContainerListener l,
                                      java.awt.event.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 java.awt.event.FocusListener remove(java.awt.event.FocusListener l,
                                  java.awt.event.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 java.awt.event.KeyListener remove(java.awt.event.KeyListener l,
                                java.awt.event.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 java.awt.event.MouseListener remove(java.awt.event.MouseListener l,
                                  java.awt.event.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 java.awt.event.MouseMotionListener remove(java.awt.event.MouseMotionListener l,
                                        java.awt.event.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 java.awt.event.WindowListener remove(java.awt.event.WindowListener l,
                                   java.awt.event.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 java.awt.event.WindowStateListener remove(java.awt.event.WindowStateListener l,
                                        java.awt.event.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 java.awt.event.WindowFocusListener remove(java.awt.event.WindowFocusListener l,
                                        java.awt.event.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 java.awt.event.ActionListener remove(java.awt.event.ActionListener l,
                                   java.awt.event.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 java.awt.event.ItemListener remove(java.awt.event.ItemListener l,
                                 java.awt.event.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 java.awt.event.AdjustmentListener remove(java.awt.event.AdjustmentListener l,
                                       java.awt.event.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 java.awt.event.TextListener remove(java.awt.event.TextListener l,
                                 java.awt.event.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 java.awt.event.InputMethodListener remove(java.awt.event.InputMethodListener l,
                                        java.awt.event.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 java.awt.event.HierarchyListener remove(java.awt.event.HierarchyListener l,
                                      java.awt.event.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 java.awt.event.HierarchyBoundsListener remove(java.awt.event.HierarchyBoundsListener l,
                                            java.awt.event.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 java.awt.event.MouseWheelListener remove(java.awt.event.MouseWheelListener l,
                                       java.awt.event.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 java.util.EventListener addInternal(java.util.EventListener a,
                                  java.util.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 java.util.EventListener removeInternal(java.util.EventListener l,
                                     java.util.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(java.io.ObjectOutputStream s,
                java.lang.String k)
                     throws java.io.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:

java.io.IOException - if serialization fails

save

protected static void save(java.io.ObjectOutputStream s,
        java.lang.String k,
        java.util.EventListener l)
                    throws java.io.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:

java.io.IOException - if serialization fails

getListeners

public static <T extends java.util.EventListener> T[] getListeners(java.util.EventListener l,
                                                   java.lang.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:

java.lang.ClassCastException - if type is not assignable from EventListener

java.lang.NullPointerException - if type is null

java.lang.IllegalArgumentException - if type is Void.TYPE

Since:

1.4