java.awt
类 AWTEventMulticaster

java.lang.Object
  java.awt.AWTEventMulticaster

所有已实现的接口：

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
     

AWTEventMulticaster 实现对 java.awt.event 包中定义的 AWT 事件的指派，该指派是有效的、线程安全的多路广播事件指派。

以下实例阐释了如何使用此类：

 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());
         }
     }
 }
 

AWTEventMulticaster 是作为一对 EventListeners 实现的，它们在构造时被设置。AWTEventMulticaster 是不可变的。add 和 remove 方法不得以任何方式改变 AWTEventMulticaster。如有必要，可以创建一个新的 AWTEventMulticaster。以这种方式在指派事件的过程中添加和移除侦听器是安全的。但是，不会向目前正指派的事件通知事件指派操作过程中添加的事件侦听器。

允许所有 add 方法使用 null 参数。如果第一个参数是 null，则返回第二个参数。如果第一个参数不是 null，而第二个参数是 null，则返回第一个参数。如果两个参数都是 non-null，则使用这两个参数创建一个新的 AWTEventMulticaster 并返回它。

对于使用两个参数的 remove 方法，返回以下内容：

• null，如果第一个参数是 null，或者参数相等（==）。
• 第一个参数，如果第一个参数不是一个 AWTEventMulticaster 实例。
• 在将第二个参数提供给 remove(EventListener) 方法的情况下，对第一个参数调用 remove(EventListener) 的结果。

Swing 基于类似的逻辑使用 EventListenerList。有关细节，请参见 EventListenerList。

从以下版本开始：

1.1

另请参见：

EventListenerList