AWTEventMulticaster (Java 2 Platform SE 5.0) (original) (raw)

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

A class which implements efficient and thread-safe multi-cast event dispatching for the AWT events defined in the java.awt.event package. This class will manage an immutable structure consisting of a chain of event listeners and will dispatch events to those listeners. Because the structure is immutable, it is safe to use this API to add/remove listeners during the process of an event dispatch operation. However, event listeners added during the process of an event dispatch operation will not be notified of the event currently being dispatched. 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 synchronized void addActionListener(ActionListener l) {
           actionListener = AWTEventMulticaster.add(actionListener, l);
     }
     public synchronized void removeActionListener(ActionListener l) {
           actionListener = AWTEventMulticaster.remove(actionListener, l);
     }
     public void processEvent(AWTEvent e) {
         // when event occurs which causes "action" semantic
         ActionListener listener = actionListener;
         if (listener != null) {
             listener.actionPerformed(new ActionEvent());
         }
     }
 }

Since:

1.1

Field Summary
protected EventListener	a
protected EventListener	b

Constructor Summary
protected	[AWTEventMulticaster](../../java/awt/AWTEventMulticaster.html#AWTEventMulticaster%28java.util.EventListener, java.util.EventListener%29)(EventListener a,EventListener b) Creates an event multicaster instance which chains listener-a with listener-b.

Method Summary
void	actionPerformed(ActionEvent e) Handles the actionPerformed event by invoking the actionPerformed methods on listener-a and listener-b.
static ActionListener	[add](../../java/awt/AWTEventMulticaster.html#add%28java.awt.event.ActionListener, java.awt.event.ActionListener%29)(ActionListener a,ActionListener b) Adds action-listener-a with action-listener-b and returns the resulting multicast listener.
static AdjustmentListener	[add](../../java/awt/AWTEventMulticaster.html#add%28java.awt.event.AdjustmentListener, java.awt.event.AdjustmentListener%29)(AdjustmentListener a,AdjustmentListener b) Adds adjustment-listener-a with adjustment-listener-b and returns the resulting multicast listener.
static ComponentListener	[add](../../java/awt/AWTEventMulticaster.html#add%28java.awt.event.ComponentListener, java.awt.event.ComponentListener%29)(ComponentListener a,ComponentListener b) Adds component-listener-a with component-listener-b and returns the resulting multicast listener.
static ContainerListener	[add](../../java/awt/AWTEventMulticaster.html#add%28java.awt.event.ContainerListener, java.awt.event.ContainerListener%29)(ContainerListener a,ContainerListener b) Adds container-listener-a with container-listener-b and returns the resulting multicast listener.
static FocusListener	[add](../../java/awt/AWTEventMulticaster.html#add%28java.awt.event.FocusListener, java.awt.event.FocusListener%29)(FocusListener a,FocusListener b) Adds focus-listener-a with focus-listener-b and returns the resulting multicast listener.
static HierarchyBoundsListener	[add](../../java/awt/AWTEventMulticaster.html#add%28java.awt.event.HierarchyBoundsListener, java.awt.event.HierarchyBoundsListener%29)(HierarchyBoundsListener a,HierarchyBoundsListener b) Adds hierarchy-bounds-listener-a with hierarchy-bounds-listener-b and returns the resulting multicast listener.
static HierarchyListener	[add](../../java/awt/AWTEventMulticaster.html#add%28java.awt.event.HierarchyListener, java.awt.event.HierarchyListener%29)(HierarchyListener a,HierarchyListener b) Adds hierarchy-listener-a with hierarchy-listener-b and returns the resulting multicast listener.
static InputMethodListener	[add](../../java/awt/AWTEventMulticaster.html#add%28java.awt.event.InputMethodListener, java.awt.event.InputMethodListener%29)(InputMethodListener a,InputMethodListener b) Adds input-method-listener-a with input-method-listener-b and returns the resulting multicast listener.
static ItemListener	[add](../../java/awt/AWTEventMulticaster.html#add%28java.awt.event.ItemListener, java.awt.event.ItemListener%29)(ItemListener a,ItemListener b) Adds item-listener-a with item-listener-b and returns the resulting multicast listener.
static KeyListener	[add](../../java/awt/AWTEventMulticaster.html#add%28java.awt.event.KeyListener, java.awt.event.KeyListener%29)(KeyListener a,KeyListener b) Adds key-listener-a with key-listener-b and returns the resulting multicast listener.
static MouseListener	[add](../../java/awt/AWTEventMulticaster.html#add%28java.awt.event.MouseListener, java.awt.event.MouseListener%29)(MouseListener a,MouseListener b) Adds mouse-listener-a with mouse-listener-b and returns the resulting multicast listener.
static MouseMotionListener	[add](../../java/awt/AWTEventMulticaster.html#add%28java.awt.event.MouseMotionListener, java.awt.event.MouseMotionListener%29)(MouseMotionListener a,MouseMotionListener b) Adds mouse-motion-listener-a with mouse-motion-listener-b and returns the resulting multicast listener.
static MouseWheelListener	[add](../../java/awt/AWTEventMulticaster.html#add%28java.awt.event.MouseWheelListener, java.awt.event.MouseWheelListener%29)(MouseWheelListener a,MouseWheelListener b) Adds mouse-wheel-listener-a with mouse-wheel-listener-b and returns the resulting multicast listener.
static TextListener	[add](../../java/awt/AWTEventMulticaster.html#add%28java.awt.event.TextListener, java.awt.event.TextListener%29)(TextListener a,TextListener b)
static WindowFocusListener	[add](../../java/awt/AWTEventMulticaster.html#add%28java.awt.event.WindowFocusListener, java.awt.event.WindowFocusListener%29)(WindowFocusListener a,WindowFocusListener b) Adds window-focus-listener-a with window-focus-listener-b and returns the resulting multicast listener.
static WindowListener	[add](../../java/awt/AWTEventMulticaster.html#add%28java.awt.event.WindowListener, java.awt.event.WindowListener%29)(WindowListener a,WindowListener b) Adds window-listener-a with window-listener-b and returns the resulting multicast listener.
static WindowStateListener	[add](../../java/awt/AWTEventMulticaster.html#add%28java.awt.event.WindowStateListener, java.awt.event.WindowStateListener%29)(WindowStateListener a,WindowStateListener b) Adds window-state-listener-a with window-state-listener-b and returns the resulting multicast listener.
protected static EventListener	[addInternal](../../java/awt/AWTEventMulticaster.html#addInternal%28java.util.EventListener, java.util.EventListener%29)(EventListener a,EventListener b) Returns the resulting multicast listener from adding listener-a and listener-b together.
void	adjustmentValueChanged(AdjustmentEvent e) Handles the adjustmentValueChanged event by invoking the adjustmentValueChanged methods on listener-a and listener-b.
void	ancestorMoved(HierarchyEvent e) Handles the ancestorMoved event by invoking the ancestorMoved methods on listener-a and listener-b.
void	ancestorResized(HierarchyEvent e) Handles the ancestorResized event by invoking the ancestorResized methods on listener-a and listener-b.
void	caretPositionChanged(InputMethodEvent e) Handles the caretPositionChanged event by invoking the caretPositionChanged methods on listener-a and listener-b.
void	componentAdded(ContainerEvent e) Handles the componentAdded container event by invoking the componentAdded methods on listener-a and listener-b.
void	componentHidden(ComponentEvent e) Handles the componentHidden event by invoking the componentHidden methods on listener-a and listener-b.
void	componentMoved(ComponentEvent e) Handles the componentMoved event by invoking the componentMoved methods on listener-a and listener-b.
void	componentRemoved(ContainerEvent e) Handles the componentRemoved container event by invoking the componentRemoved methods on listener-a and listener-b.
void	componentResized(ComponentEvent e) Handles the componentResized event by invoking the componentResized methods on listener-a and listener-b.
void	componentShown(ComponentEvent e) Handles the componentShown event by invoking the componentShown methods on listener-a and listener-b.
void	focusGained(FocusEvent e) Handles the focusGained event by invoking the focusGained methods on listener-a and listener-b.
void	focusLost(FocusEvent e) Handles the focusLost event by invoking the focusLost methods on listener-a and listener-b.
static <T extends EventListener> T[]	[getListeners](../../java/awt/AWTEventMulticaster.html#getListeners%28java.util.EventListener, java.lang.Class%29)(EventListener l,Class listenerType) Returns an array of all the objects chained as_Foo_Listeners by the specifiedjava.util.EventListener.
void	hierarchyChanged(HierarchyEvent e) Handles the hierarchyChanged event by invoking the hierarchyChanged methods on listener-a and listener-b.
void	inputMethodTextChanged(InputMethodEvent e) Handles the inputMethodTextChanged event by invoking the inputMethodTextChanged methods on listener-a and listener-b.
void	itemStateChanged(ItemEvent e) Handles the itemStateChanged event by invoking the itemStateChanged methods on listener-a and listener-b.
void	keyPressed(KeyEvent e) Handles the keyPressed event by invoking the keyPressed methods on listener-a and listener-b.
void	keyReleased(KeyEvent e) Handles the keyReleased event by invoking the keyReleased methods on listener-a and listener-b.
void	keyTyped(KeyEvent e) Handles the keyTyped event by invoking the keyTyped methods on listener-a and listener-b.
void	mouseClicked(MouseEvent e) Handles the mouseClicked event by invoking the mouseClicked methods on listener-a and listener-b.
void	mouseDragged(MouseEvent e) Handles the mouseDragged event by invoking the mouseDragged methods on listener-a and listener-b.
void	mouseEntered(MouseEvent e) Handles the mouseEntered event by invoking the mouseEntered methods on listener-a and listener-b.
void	mouseExited(MouseEvent e) Handles the mouseExited event by invoking the mouseExited methods on listener-a and listener-b.
void	mouseMoved(MouseEvent e) Handles the mouseMoved event by invoking the mouseMoved methods on listener-a and listener-b.
void	mousePressed(MouseEvent e) Handles the mousePressed event by invoking the mousePressed methods on listener-a and listener-b.
void	mouseReleased(MouseEvent e) Handles the mouseReleased event by invoking the mouseReleased methods on listener-a and listener-b.
void	mouseWheelMoved(MouseWheelEvent e) Handles the mouseWheelMoved event by invoking the mouseWheelMoved methods on listener-a and listener-b.
static ActionListener	[remove](../../java/awt/AWTEventMulticaster.html#remove%28java.awt.event.ActionListener, java.awt.event.ActionListener%29)(ActionListener l,ActionListener oldl) Removes the old action-listener from action-listener-l and returns the resulting multicast listener.
static AdjustmentListener	[remove](../../java/awt/AWTEventMulticaster.html#remove%28java.awt.event.AdjustmentListener, java.awt.event.AdjustmentListener%29)(AdjustmentListener l,AdjustmentListener oldl) Removes the old adjustment-listener from adjustment-listener-l and returns the resulting multicast listener.
static ComponentListener	[remove](../../java/awt/AWTEventMulticaster.html#remove%28java.awt.event.ComponentListener, java.awt.event.ComponentListener%29)(ComponentListener l,ComponentListener oldl) Removes the old component-listener from component-listener-l and returns the resulting multicast listener.
static ContainerListener	[remove](../../java/awt/AWTEventMulticaster.html#remove%28java.awt.event.ContainerListener, java.awt.event.ContainerListener%29)(ContainerListener l,ContainerListener oldl) Removes the old container-listener from container-listener-l and returns the resulting multicast listener.
protected EventListener	remove(EventListener oldl) Removes a listener from this multicaster and returns the resulting multicast listener.
static FocusListener	[remove](../../java/awt/AWTEventMulticaster.html#remove%28java.awt.event.FocusListener, java.awt.event.FocusListener%29)(FocusListener l,FocusListener oldl) Removes the old focus-listener from focus-listener-l and returns the resulting multicast listener.
static HierarchyBoundsListener	[remove](../../java/awt/AWTEventMulticaster.html#remove%28java.awt.event.HierarchyBoundsListener, java.awt.event.HierarchyBoundsListener%29)(HierarchyBoundsListener l,HierarchyBoundsListener oldl) Removes the old hierarchy-bounds-listener from hierarchy-bounds-listener-l and returns the resulting multicast listener.
static HierarchyListener	[remove](../../java/awt/AWTEventMulticaster.html#remove%28java.awt.event.HierarchyListener, java.awt.event.HierarchyListener%29)(HierarchyListener l,HierarchyListener oldl) Removes the old hierarchy-listener from hierarchy-listener-l and returns the resulting multicast listener.
static InputMethodListener	[remove](../../java/awt/AWTEventMulticaster.html#remove%28java.awt.event.InputMethodListener, java.awt.event.InputMethodListener%29)(InputMethodListener l,InputMethodListener oldl) Removes the old input-method-listener from input-method-listener-l and returns the resulting multicast listener.
static ItemListener	[remove](../../java/awt/AWTEventMulticaster.html#remove%28java.awt.event.ItemListener, java.awt.event.ItemListener%29)(ItemListener l,ItemListener oldl) Removes the old item-listener from item-listener-l and returns the resulting multicast listener.
static KeyListener	[remove](../../java/awt/AWTEventMulticaster.html#remove%28java.awt.event.KeyListener, java.awt.event.KeyListener%29)(KeyListener l,KeyListener oldl) Removes the old key-listener from key-listener-l and returns the resulting multicast listener.
static MouseListener	[remove](../../java/awt/AWTEventMulticaster.html#remove%28java.awt.event.MouseListener, java.awt.event.MouseListener%29)(MouseListener l,MouseListener oldl) Removes the old mouse-listener from mouse-listener-l and returns the resulting multicast listener.
static MouseMotionListener	[remove](../../java/awt/AWTEventMulticaster.html#remove%28java.awt.event.MouseMotionListener, java.awt.event.MouseMotionListener%29)(MouseMotionListener l,MouseMotionListener oldl) Removes the old mouse-motion-listener from mouse-motion-listener-l and returns the resulting multicast listener.
static MouseWheelListener	[remove](../../java/awt/AWTEventMulticaster.html#remove%28java.awt.event.MouseWheelListener, java.awt.event.MouseWheelListener%29)(MouseWheelListener l,MouseWheelListener oldl) Removes the old mouse-wheel-listener from mouse-wheel-listener-l and returns the resulting multicast listener.
static TextListener	[remove](../../java/awt/AWTEventMulticaster.html#remove%28java.awt.event.TextListener, java.awt.event.TextListener%29)(TextListener l,TextListener oldl)
static WindowFocusListener	[remove](../../java/awt/AWTEventMulticaster.html#remove%28java.awt.event.WindowFocusListener, java.awt.event.WindowFocusListener%29)(WindowFocusListener l,WindowFocusListener oldl) Removes the old window-focus-listener from window-focus-listener-l and returns the resulting multicast listener.
static WindowListener	[remove](../../java/awt/AWTEventMulticaster.html#remove%28java.awt.event.WindowListener, java.awt.event.WindowListener%29)(WindowListener l,WindowListener oldl) Removes the old window-listener from window-listener-l and returns the resulting multicast listener.
static WindowStateListener	[remove](../../java/awt/AWTEventMulticaster.html#remove%28java.awt.event.WindowStateListener, java.awt.event.WindowStateListener%29)(WindowStateListener l,WindowStateListener oldl) Removes the old window-state-listener from window-state-listener-l and returns the resulting multicast listener.
protected static EventListener	[removeInternal](../../java/awt/AWTEventMulticaster.html#removeInternal%28java.util.EventListener, java.util.EventListener%29)(EventListener l,EventListener oldl) Returns the resulting multicast listener after removing the old listener from listener-l.
protected static void	[save](../../java/awt/AWTEventMulticaster.html#save%28java.io.ObjectOutputStream, java.lang.String, java.util.EventListener%29)(ObjectOutputStream s,String k,EventListener l)
protected void	[saveInternal](../../java/awt/AWTEventMulticaster.html#saveInternal%28java.io.ObjectOutputStream, java.lang.String%29)(ObjectOutputStream s,String k)
void	textValueChanged(TextEvent e) Invoked when the value of the text has changed.
void	windowActivated(WindowEvent e) Handles the windowActivated event by invoking the windowActivated methods on listener-a and listener-b.
void	windowClosed(WindowEvent e) Handles the windowClosed event by invoking the windowClosed methods on listener-a and listener-b.
void	windowClosing(WindowEvent e) Handles the windowClosing event by invoking the windowClosing methods on listener-a and listener-b.
void	windowDeactivated(WindowEvent e) Handles the windowDeactivated event by invoking the windowDeactivated methods on listener-a and listener-b.
void	windowDeiconified(WindowEvent e) Handles the windowDeiconfied event by invoking the windowDeiconified methods on listener-a and listener-b.
void	windowGainedFocus(WindowEvent e) Handles the windowGainedFocus event by invoking the windowGainedFocus methods on listener-a and listener-b.
void	windowIconified(WindowEvent e) Handles the windowIconified event by invoking the windowIconified methods on listener-a and listener-b.
void	windowLostFocus(WindowEvent e) Handles the windowLostFocus event by invoking the windowLostFocus methods on listener-a and listener-b.
void	windowOpened(WindowEvent e) Handles the windowOpened event by invoking the windowOpened methods on listener-a and listener-b.
void	windowStateChanged(WindowEvent e) Handles the windowStateChanged event by invoking the windowStateChanged methods on listener-a and listener-b.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, [wait](../../java/lang/Object.html#wait%28long, int%29)

Field Detail

a

protected final EventListener a

b

protected final EventListener b

Constructor Detail

AWTEventMulticaster

protected AWTEventMulticaster(EventListener a, EventListener b)

Creates an event multicaster instance which chains listener-a with listener-b. Input parameters a and b should not be null, though implementations may vary in choosing whether or not to throw NullPointerException in that case.

Parameters:

a - listener-a

b - listener-b

Method Detail

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.

Specified by:

[componentResized](../../java/awt/event/ComponentListener.html#componentResized%28java.awt.event.ComponentEvent%29) in interface [ComponentListener](../../java/awt/event/ComponentListener.html "interface in java.awt.event")

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.

Specified by:

[componentMoved](../../java/awt/event/ComponentListener.html#componentMoved%28java.awt.event.ComponentEvent%29) in interface [ComponentListener](../../java/awt/event/ComponentListener.html "interface in java.awt.event")

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.

Specified by:

[componentShown](../../java/awt/event/ComponentListener.html#componentShown%28java.awt.event.ComponentEvent%29) in interface [ComponentListener](../../java/awt/event/ComponentListener.html "interface in java.awt.event")

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.

Specified by:

[componentHidden](../../java/awt/event/ComponentListener.html#componentHidden%28java.awt.event.ComponentEvent%29) in interface [ComponentListener](../../java/awt/event/ComponentListener.html "interface in java.awt.event")

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.

Specified by:

[componentAdded](../../java/awt/event/ContainerListener.html#componentAdded%28java.awt.event.ContainerEvent%29) in interface [ContainerListener](../../java/awt/event/ContainerListener.html "interface in java.awt.event")

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.

Specified by:

[componentRemoved](../../java/awt/event/ContainerListener.html#componentRemoved%28java.awt.event.ContainerEvent%29) in interface [ContainerListener](../../java/awt/event/ContainerListener.html "interface in java.awt.event")

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.

Specified by:

[focusGained](../../java/awt/event/FocusListener.html#focusGained%28java.awt.event.FocusEvent%29) in interface [FocusListener](../../java/awt/event/FocusListener.html "interface in java.awt.event")

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.

Specified by:

[focusLost](../../java/awt/event/FocusListener.html#focusLost%28java.awt.event.FocusEvent%29) in interface [FocusListener](../../java/awt/event/FocusListener.html "interface in java.awt.event")

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.

Specified by:

[keyTyped](../../java/awt/event/KeyListener.html#keyTyped%28java.awt.event.KeyEvent%29) in interface [KeyListener](../../java/awt/event/KeyListener.html "interface in java.awt.event")

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.

Specified by:

[keyPressed](../../java/awt/event/KeyListener.html#keyPressed%28java.awt.event.KeyEvent%29) in interface [KeyListener](../../java/awt/event/KeyListener.html "interface in java.awt.event")

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.

Specified by:

[keyReleased](../../java/awt/event/KeyListener.html#keyReleased%28java.awt.event.KeyEvent%29) in interface [KeyListener](../../java/awt/event/KeyListener.html "interface in java.awt.event")

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.

Specified by:

[mouseClicked](../../java/awt/event/MouseListener.html#mouseClicked%28java.awt.event.MouseEvent%29) in interface [MouseListener](../../java/awt/event/MouseListener.html "interface in java.awt.event")

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.

Specified by:

[mousePressed](../../java/awt/event/MouseListener.html#mousePressed%28java.awt.event.MouseEvent%29) in interface [MouseListener](../../java/awt/event/MouseListener.html "interface in java.awt.event")

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.

Specified by:

[mouseReleased](../../java/awt/event/MouseListener.html#mouseReleased%28java.awt.event.MouseEvent%29) in interface [MouseListener](../../java/awt/event/MouseListener.html "interface in java.awt.event")

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.

Specified by:

[mouseEntered](../../java/awt/event/MouseListener.html#mouseEntered%28java.awt.event.MouseEvent%29) in interface [MouseListener](../../java/awt/event/MouseListener.html "interface in java.awt.event")

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.

Specified by:

[mouseExited](../../java/awt/event/MouseListener.html#mouseExited%28java.awt.event.MouseEvent%29) in interface [MouseListener](../../java/awt/event/MouseListener.html "interface in java.awt.event")

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.

Specified by:

[mouseDragged](../../java/awt/event/MouseMotionListener.html#mouseDragged%28java.awt.event.MouseEvent%29) in interface [MouseMotionListener](../../java/awt/event/MouseMotionListener.html "interface in java.awt.event")

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.

Specified by:

[mouseMoved](../../java/awt/event/MouseMotionListener.html#mouseMoved%28java.awt.event.MouseEvent%29) in interface [MouseMotionListener](../../java/awt/event/MouseMotionListener.html "interface in java.awt.event")

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.

Specified by:

[windowOpened](../../java/awt/event/WindowListener.html#windowOpened%28java.awt.event.WindowEvent%29) in interface [WindowListener](../../java/awt/event/WindowListener.html "interface in java.awt.event")

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.

Specified by:

[windowClosing](../../java/awt/event/WindowListener.html#windowClosing%28java.awt.event.WindowEvent%29) in interface [WindowListener](../../java/awt/event/WindowListener.html "interface in java.awt.event")

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.

Specified by:

[windowClosed](../../java/awt/event/WindowListener.html#windowClosed%28java.awt.event.WindowEvent%29) in interface [WindowListener](../../java/awt/event/WindowListener.html "interface in java.awt.event")

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.

Specified by:

[windowIconified](../../java/awt/event/WindowListener.html#windowIconified%28java.awt.event.WindowEvent%29) in interface [WindowListener](../../java/awt/event/WindowListener.html "interface in java.awt.event")

Parameters:

e - the window event

See Also:

Frame.setIconImage(java.awt.Image)

windowDeiconified

public void windowDeiconified(WindowEvent e)

Handles the windowDeiconfied event by invoking the windowDeiconified methods on listener-a and listener-b.

Specified by:

[windowDeiconified](../../java/awt/event/WindowListener.html#windowDeiconified%28java.awt.event.WindowEvent%29) in interface [WindowListener](../../java/awt/event/WindowListener.html "interface in java.awt.event")

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.

Specified by:

[windowActivated](../../java/awt/event/WindowListener.html#windowActivated%28java.awt.event.WindowEvent%29) in interface [WindowListener](../../java/awt/event/WindowListener.html "interface in java.awt.event")

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.

Specified by:

[windowDeactivated](../../java/awt/event/WindowListener.html#windowDeactivated%28java.awt.event.WindowEvent%29) in interface [WindowListener](../../java/awt/event/WindowListener.html "interface in java.awt.event")

Parameters:

e - the window event

windowStateChanged

public void windowStateChanged(WindowEvent e)

Handles the windowStateChanged event by invoking the windowStateChanged methods on listener-a and listener-b.

Specified by:

[windowStateChanged](../../java/awt/event/WindowStateListener.html#windowStateChanged%28java.awt.event.WindowEvent%29) in interface [WindowStateListener](../../java/awt/event/WindowStateListener.html "interface in java.awt.event")

Parameters:

e - the window event

windowGainedFocus

public void windowGainedFocus(WindowEvent e)

Handles the windowGainedFocus event by invoking the windowGainedFocus methods on listener-a and listener-b.

Specified by:

[windowGainedFocus](../../java/awt/event/WindowFocusListener.html#windowGainedFocus%28java.awt.event.WindowEvent%29) in interface [WindowFocusListener](../../java/awt/event/WindowFocusListener.html "interface in java.awt.event")

Parameters:

e - the window event

windowLostFocus

public void windowLostFocus(WindowEvent e)

Handles the windowLostFocus event by invoking the windowLostFocus methods on listener-a and listener-b.

Specified by:

[windowLostFocus](../../java/awt/event/WindowFocusListener.html#windowLostFocus%28java.awt.event.WindowEvent%29) in interface [WindowFocusListener](../../java/awt/event/WindowFocusListener.html "interface in java.awt.event")

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.

Specified by:

[actionPerformed](../../java/awt/event/ActionListener.html#actionPerformed%28java.awt.event.ActionEvent%29) in interface [ActionListener](../../java/awt/event/ActionListener.html "interface in java.awt.event")

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.

Specified by:

[itemStateChanged](../../java/awt/event/ItemListener.html#itemStateChanged%28java.awt.event.ItemEvent%29) in interface [ItemListener](../../java/awt/event/ItemListener.html "interface in java.awt.event")

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.

Specified by:

[adjustmentValueChanged](../../java/awt/event/AdjustmentListener.html#adjustmentValueChanged%28java.awt.event.AdjustmentEvent%29) in interface [AdjustmentListener](../../java/awt/event/AdjustmentListener.html "interface in java.awt.event")

Parameters:

e - the adjustment event

textValueChanged

public void textValueChanged(TextEvent e)

Description copied from interface: [TextListener](../../java/awt/event/TextListener.html#textValueChanged%28java.awt.event.TextEvent%29)

Invoked when the value of the text has changed. The code written for this method performs the operations that need to occur when text changes.

Specified by:

[textValueChanged](../../java/awt/event/TextListener.html#textValueChanged%28java.awt.event.TextEvent%29) in interface [TextListener](../../java/awt/event/TextListener.html "interface in java.awt.event")

inputMethodTextChanged

public void inputMethodTextChanged(InputMethodEvent e)

Handles the inputMethodTextChanged event by invoking the inputMethodTextChanged methods on listener-a and listener-b.

Specified by:

[inputMethodTextChanged](../../java/awt/event/InputMethodListener.html#inputMethodTextChanged%28java.awt.event.InputMethodEvent%29) in interface [InputMethodListener](../../java/awt/event/InputMethodListener.html "interface in java.awt.event")

Parameters:

e - the item event

caretPositionChanged

public void caretPositionChanged(InputMethodEvent e)

Handles the caretPositionChanged event by invoking the caretPositionChanged methods on listener-a and listener-b.

Specified by:

[caretPositionChanged](../../java/awt/event/InputMethodListener.html#caretPositionChanged%28java.awt.event.InputMethodEvent%29) in interface [InputMethodListener](../../java/awt/event/InputMethodListener.html "interface in java.awt.event")

Parameters:

e - the item event

hierarchyChanged

public void hierarchyChanged(HierarchyEvent e)

Handles the hierarchyChanged event by invoking the hierarchyChanged methods on listener-a and listener-b.

Specified by:

[hierarchyChanged](../../java/awt/event/HierarchyListener.html#hierarchyChanged%28java.awt.event.HierarchyEvent%29) in interface [HierarchyListener](../../java/awt/event/HierarchyListener.html "interface in java.awt.event")

Parameters:

e - the item event

See Also:

HierarchyEvent.getChangeFlags()

ancestorMoved

public void ancestorMoved(HierarchyEvent e)

Handles the ancestorMoved event by invoking the ancestorMoved methods on listener-a and listener-b.

Specified by:

[ancestorMoved](../../java/awt/event/HierarchyBoundsListener.html#ancestorMoved%28java.awt.event.HierarchyEvent%29) in interface [HierarchyBoundsListener](../../java/awt/event/HierarchyBoundsListener.html "interface in java.awt.event")

Parameters:

e - the item event

ancestorResized

public void ancestorResized(HierarchyEvent e)

Handles the ancestorResized event by invoking the ancestorResized methods on listener-a and listener-b.

Specified by:

[ancestorResized](../../java/awt/event/HierarchyBoundsListener.html#ancestorResized%28java.awt.event.HierarchyEvent%29) in interface [HierarchyBoundsListener](../../java/awt/event/HierarchyBoundsListener.html "interface in java.awt.event")

Parameters:

e - the item event

mouseWheelMoved

public void mouseWheelMoved(MouseWheelEvent e)

Handles the mouseWheelMoved event by invoking the mouseWheelMoved methods on listener-a and listener-b.

Specified by:

[mouseWheelMoved](../../java/awt/event/MouseWheelListener.html#mouseWheelMoved%28java.awt.event.MouseWheelEvent%29) in interface [MouseWheelListener](../../java/awt/event/MouseWheelListener.html "interface in java.awt.event")

Parameters:

e - the mouse event

Since:

1.4

See Also:

MouseWheelEvent

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 WindowStateListener add(WindowStateListener a, WindowStateListener b)

Adds window-state-listener-a with window-state-listener-b and returns the resulting multicast listener.

Parameters:

a - window-state-listener-a

b - window-state-listener-b

add

public static WindowFocusListener add(WindowFocusListener a, WindowFocusListener b)

Adds window-focus-listener-a with window-focus-listener-b and returns the resulting multicast listener.

Parameters:

a - window-focus-listener-a

b - window-focus-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)

add

public static InputMethodListener add(InputMethodListener a, InputMethodListener b)

Adds input-method-listener-a with input-method-listener-b and returns the resulting multicast listener.

Parameters:

a - input-method-listener-a

b - input-method-listener-b

add

public static HierarchyListener add(HierarchyListener a, HierarchyListener b)

Adds hierarchy-listener-a with hierarchy-listener-b and returns the resulting multicast listener.

Parameters:

a - hierarchy-listener-a

b - hierarchy-listener-b

add

public static HierarchyBoundsListener add(HierarchyBoundsListener a, HierarchyBoundsListener b)

Adds hierarchy-bounds-listener-a with hierarchy-bounds-listener-b and returns the resulting multicast listener.

Parameters:

a - hierarchy-bounds-listener-a

b - hierarchy-bounds-listener-b

add

public static MouseWheelListener add(MouseWheelListener a, MouseWheelListener b)

Adds mouse-wheel-listener-a with mouse-wheel-listener-b and returns the resulting multicast listener.

Parameters:

a - mouse-wheel-listener-a

b - mouse-wheel-listener-b

Since:

1.4

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 WindowStateListener remove(WindowStateListener l, WindowStateListener oldl)

Removes the old window-state-listener from window-state-listener-l and returns the resulting multicast listener.

Parameters:

l - window-state-listener-l

oldl - the window-state-listener being removed

remove

public static WindowFocusListener remove(WindowFocusListener l, WindowFocusListener oldl)

Removes the old window-focus-listener from window-focus-listener-l and returns the resulting multicast listener.

Parameters:

l - window-focus-listener-l

oldl - the window-focus-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)

remove

public static InputMethodListener remove(InputMethodListener l, InputMethodListener oldl)

Removes the old input-method-listener from input-method-listener-l and returns the resulting multicast listener.

Parameters:

l - input-method-listener-l

oldl - the input-method-listener being removed

remove

public static HierarchyListener remove(HierarchyListener l, HierarchyListener oldl)

Removes the old hierarchy-listener from hierarchy-listener-l and returns the resulting multicast listener.

Parameters:

l - hierarchy-listener-l

oldl - the hierarchy-listener being removed

remove

public static HierarchyBoundsListener remove(HierarchyBoundsListener l, HierarchyBoundsListener oldl)

Removes the old hierarchy-bounds-listener from hierarchy-bounds-listener-l and returns the resulting multicast listener.

Parameters:

l - hierarchy-bounds-listener-l

oldl - the hierarchy-bounds-listener being removed

remove

public static MouseWheelListener remove(MouseWheelListener l, MouseWheelListener oldl)

Removes the old mouse-wheel-listener from mouse-wheel-listener-l and returns the resulting multicast listener.

Parameters:

l - mouse-wheel-listener-l

oldl - the mouse-wheel-listener being removed

Since:

1.4

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

Throws:

[IOException](../../java/io/IOException.html "class in java.io")

save

protected static void save(ObjectOutputStream s, String k, EventListener l) throws IOException

Throws:

[IOException](../../java/io/IOException.html "class in java.io")

getListeners

public static <T extends EventListener> T[] getListeners(EventListener l, Class listenerType)

Returns an array of all the objects chained as_Foo_Listeners by the specifiedjava.util.EventListener._Foo_Listeners are chained by theAWTEventMulticaster using theadd_Foo_Listener method. If a null listener is specified, this method returns an empty array. If the specified listener is not an instance ofAWTEventMulticaster, this method returns an array which contains only the specified listener. If no such listeners are chanined, this method returns an empty array.

Parameters:

l - the specified java.util.EventListener

listenerType - the type of listeners requested; this parameter should specify an interface that descends fromjava.util.EventListener

Returns:

an array of all objects chained as_Foo_Listeners by the specified multicast listener, or an empty array if no such listeners have been chained by the specified multicast listener

Throws:

[ClassCastException](../../java/lang/ClassCastException.html "class in java.lang") - if listenerType doesn't specify a class or interface that implementsjava.util.EventListener

Since:

1.4

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.