Module jdk.accessibility
Package com.sun.java.accessibility.util

# Class SwingEventMonitor

java.lang.Object
com.sun.java.accessibility.util.AWTEventMonitor
com.sun.java.accessibility.util.SwingEventMonitor

public class SwingEventMonitor extends AWTEventMonitor

`SwingEventMonitor` extends `AWTEventMonitor` by adding a suite of listeners conditionally installed on every Swing component instance in the Java Virtual Machine. The events captured by these listeners are made available through a unified set of listeners supported by `SwingEventMonitor`. With this, all the individual events on each of the AWT and Swing component instances are funneled into one set of listeners broken down by category (see `EventID` for the categories).

This class depends upon `EventQueueMonitor`, which provides the base level support for capturing the top-level containers as they are created.

Because this class extends `AWTEventMonitor`, it is not necessary to use this class and `AWTEventMonitor` at the same time. If you want to monitor both AWT and Swing components, you should use just this class.

See Also:
  - `AWTEventMonitor`

- ## Field Summary

  Fields
  Modifier and Type
  Field
  Description
  `protected static final EventListenerList`
  `listenerList`
  The master list of all listeners registered by other classes.

- ## Constructor Summary

  Constructors
  Constructor
  Description
  `SwingEventMonitor()`
  Constructs a `SwingEventMonitor`.

- ## Method Summary

  Modifier and Type
  Method
  Description
  `static void`
  `addAncestorListener(AncestorListener l)`
  Adds the specified listener to receive all `ANCESTOR` events on each component instance in the Java Virtual Machine as they occur.
  `static void`
  `addCaretListener(CaretListener l)`
  Adds the specified listener to receive all `CARET` events on each component instance in the Java Virtual Machine as they occur.
  `static void`
  `addCellEditorListener(CellEditorListener l)`
  Adds the specified listener to receive all `CELLEDITOR` events on each component instance in the Java Virtual Machine as they occur.
  `static void`
  `addChangeListener(ChangeListener l)`
  Adds the specified listener to receive all `CHANGE` events on each component instance in the Java Virtual Machine as they occur.
  `static void`
  `addColumnModelListener(TableColumnModelListener l)`
  Adds the specified listener to receive all `COLUMNMODEL` events on each component instance in the Java Virtual Machine as they occur.
  `static void`
  `addDocumentListener(DocumentListener l)`
  Adds the specified listener to receive all `DOCUMENT` events on each component instance in the Java Virtual Machine as they occur.
  `static void`
  `addInternalFrameListener(InternalFrameListener l)`
  Adds the specified listener to receive all `INTERNALFRAME` events on each component instance in the Java Virtual Machine as they occur.
  `static void`
  `addListDataListener(ListDataListener l)`
  Adds the specified listener to receive all `LISTDATA` events on each component instance in the Java Virtual Machine as they occur.
  `static void`
  `addListSelectionListener(ListSelectionListener l)`
  Adds the specified listener to receive all `LISTSELECTION` events on each component instance in the Java Virtual Machine as they occur.
  `static void`
  `addMenuListener(MenuListener l)`
  Adds the specified listener to receive all `MENU` events on each component instance in the Java Virtual Machine as they occur.
  `static void`
  `addPopupMenuListener(PopupMenuListener l)`
  Adds the specified listener to receive all `POPUPMENU` events on each component instance in the Java Virtual Machine as they occur.
  `static void`
  `addPropertyChangeListener(PropertyChangeListener l)`
  Adds the specified listener to receive all `PROPERTYCHANGE` events on each component instance in the Java Virtual Machine as they occur.
  `static void`
  `addTableModelListener(TableModelListener l)`
  Adds the specified listener to receive all `TABLEMODEL` events on each component instance in the Java Virtual Machine as they occur.
  `static void`
  `addTreeExpansionListener(TreeExpansionListener l)`
  Adds the specified listener to receive all `TREEEXPANSION` events on each component instance in the Java Virtual Machine as they occur.
  `static void`
  `addTreeModelListener(TreeModelListener l)`
  Adds the specified listener to receive all `TREEMODEL` events on each component instance in the Java Virtual Machine as they occur.
  `static void`
  `addTreeSelectionListener(TreeSelectionListener l)`
  Adds the specified listener to receive all `TREESELECTION` events on each component instance in the Java Virtual Machine as they occur.
  `static void`
  `addUndoableEditListener(UndoableEditListener l)`
  Adds the specified listener to receive all `UNDOABLEEDIT` events on each component instance in the Java Virtual Machine as they occur.
  `static void`
  `addVetoableChangeListener(VetoableChangeListener l)`
  Adds the specified listener to receive all `VETOABLECHANGE` events on each component instance in the Java Virtual Machine as they occur.
  `static void`
  `removeAncestorListener(AncestorListener l)`
  Removes the specified listener so it no longer receives `ANCESTOR` events when they occur.
  `static void`
  `removeCaretListener(CaretListener l)`
  Removes the specified listener so it no longer receives `CARET` events when they occur.
  `static void`
  `removeCellEditorListener(CellEditorListener l)`
  Removes the specified listener so it no longer receives `CELLEDITOR` events when they occur.
  `static void`
  `removeChangeListener(ChangeListener l)`
  Removes the specified listener so it no longer receives `CHANGE` events when they occur.
  `static void`
  `removeColumnModelListener(TableColumnModelListener l)`
  Removes the specified listener so it no longer receives `COLUMNMODEL` events when they occur.
  `static void`
  `removeDocumentListener(DocumentListener l)`
  Removes the specified listener so it no longer receives `DOCUMENT` events when they occur.
  `static void`
  `removeInternalFrameListener(InternalFrameListener l)`
  Removes the specified listener so it no longer receives `INTERNALFRAME` events when they occur.
  `static void`
  `removeListDataListener(ListDataListener l)`
  Removes the specified listener so it no longer receives `LISTDATA` events when they occur.
  `static void`
  `removeListSelectionListener(ListSelectionListener l)`
  Removes the specified listener so it no longer receives `LISTSELECTION` events when they occur.
  `static void`
  `removeMenuListener(MenuListener l)`
  Removes the specified listener so it no longer receives `MENU` events when they occur.
  `static void`
  `removePopupMenuListener(PopupMenuListener l)`
  Removes the specified listener so it no longer receives `POPUPMENU` events when they occur.
  `static void`
  `removePropertyChangeListener(PropertyChangeListener l)`
  Removes the specified listener so it no longer receives `PROPERTYCHANGE` events when they occur.
  `static void`
  `removeTableModelListener(TableModelListener l)`
  Removes the specified listener so it no longer receives `TABLEMODEL` events when they occur.
  `static void`
  `removeTreeExpansionListener(TreeExpansionListener l)`
  Removes the specified listener so it no longer receives `TREEEXPANSION` events when they occur.
  `static void`
  `removeTreeModelListener(TreeModelListener l)`
  Removes the specified listener so it no longer receives `TREEMODEL` events when they occur.
  `static void`
  `removeTreeSelectionListener(TreeSelectionListener l)`
  Removes the specified listener so it no longer receives `TREESELECTION` events when they occur.
  `static void`
  `removeUndoableEditListener(UndoableEditListener l)`
  Removes the specified listener so it no longer receives `UNDOABLEEDIT` events when they occur.
  `static void`
  `removeVetoableChangeListener(VetoableChangeListener l)`
  Removes the specified listener so it no longer receives `VETOABLECHANGE` events when they occur.

  ### Methods declared in class com.sun.java.accessibility.util.AWTEventMonitor

  `addActionListener, addAdjustmentListener, addComponentListener, addContainerListener, addFocusListener, addItemListener, addKeyListener, addMouseListener, addMouseMotionListener, addTextListener, addWindowListener, getComponentWithFocus, removeActionListener, removeAdjustmentListener, removeComponentListener, removeContainerListener, removeFocusListener, removeItemListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeTextListener, removeWindowListener`

  ### Methods declared in class java.lang.Object

  `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- ## Field Details

  - ### listenerList

    protected static final EventListenerList listenerList
    The master list of all listeners registered by other classes. This can only be publicly modified by calling the add or remove listener methods in this class.

- ## Constructor Details

  - ### SwingEventMonitor

    public SwingEventMonitor()
    Constructs a `SwingEventMonitor`.

- ## Method Details

  - ### addAncestorListener

    public static void addAncestorListener(AncestorListener l)
    Adds the specified listener to receive all `ANCESTOR` events on each component instance in the Java Virtual Machine as they occur.

    Note: This listener is automatically added to all component instances created after this method is called. In addition, it is only added to component instances that support this listener type.

    Parameters:
      `l` - the listener to add
    See Also:
      - `removeAncestorListener(javax.swing.event.AncestorListener)`

  - ### removeAncestorListener

    public static void removeAncestorListener(AncestorListener l)
    Removes the specified listener so it no longer receives `ANCESTOR` events when they occur.
    Parameters:
      `l` - the listener to remove
    See Also:
      - `addAncestorListener(javax.swing.event.AncestorListener)`

  - ### addCaretListener

    public static void addCaretListener(CaretListener l)
    Adds the specified listener to receive all `CARET` events on each component instance in the Java Virtual Machine as they occur.

    Note: This listener is automatically added to all component instances created after this method is called. In addition, it is only added to component instances that support this listener type.

    Parameters:
      `l` - the listener to add
    See Also:
      - `removeCaretListener(javax.swing.event.CaretListener)`

  - ### removeCaretListener

    public static void removeCaretListener(CaretListener l)
    Removes the specified listener so it no longer receives `CARET` events when they occur.
    Parameters:
      `l` - the listener to remove
    See Also:
      - `addCaretListener(javax.swing.event.CaretListener)`

  - ### addCellEditorListener

    public static void addCellEditorListener(CellEditorListener l)
    Adds the specified listener to receive all `CELLEDITOR` events on each component instance in the Java Virtual Machine as they occur.

    Note: This listener is automatically added to all component instances created after this method is called. In addition, it is only added to component instances that support this listener type.

    Parameters:
      `l` - the listener to add
    See Also:
      - `removeCellEditorListener(javax.swing.event.CellEditorListener)`

  - ### removeCellEditorListener

    public static void removeCellEditorListener(CellEditorListener l)
    Removes the specified listener so it no longer receives `CELLEDITOR` events when they occur.
    Parameters:
      `l` - the listener to remove
    See Also:
      - `addCellEditorListener(javax.swing.event.CellEditorListener)`

  - ### addChangeListener

    public static void addChangeListener(ChangeListener l)
    Adds the specified listener to receive all `CHANGE` events on each component instance in the Java Virtual Machine as they occur.

    Note: This listener is automatically added to all component instances created after this method is called. In addition, it is only added to component instances that support this listener type.

    Parameters:
      `l` - the listener to add
    See Also:
      - `removeChangeListener(javax.swing.event.ChangeListener)`

  - ### removeChangeListener

    public static void removeChangeListener(ChangeListener l)
    Removes the specified listener so it no longer receives `CHANGE` events when they occur.
    Parameters:
      `l` - the listener to remove
    See Also:
      - `addChangeListener(javax.swing.event.ChangeListener)`

  - ### addColumnModelListener

    public static void addColumnModelListener(TableColumnModelListener l)
    Adds the specified listener to receive all `COLUMNMODEL` events on each component instance in the Java Virtual Machine as they occur.

    Note: This listener is automatically added to all component instances created after this method is called. In addition, it is only added to component instances that support this listener type.

    Parameters:
      `l` - the listener to add
    See Also:
      - `removeColumnModelListener(javax.swing.event.TableColumnModelListener)`

  - ### removeColumnModelListener

    public static void removeColumnModelListener(TableColumnModelListener l)
    Removes the specified listener so it no longer receives `COLUMNMODEL` events when they occur.
    Parameters:
      `l` - the listener to remove
    See Also:
      - `addColumnModelListener(javax.swing.event.TableColumnModelListener)`

  - ### addDocumentListener

    public static void addDocumentListener(DocumentListener l)
    Adds the specified listener to receive all `DOCUMENT` events on each component instance in the Java Virtual Machine as they occur.

    Note: This listener is automatically added to all component instances created after this method is called. In addition, it is only added to component instances that support this listener type.

    Parameters:
      `l` - the listener to add
    See Also:
      - `removeDocumentListener(javax.swing.event.DocumentListener)`

  - ### removeDocumentListener

    public static void removeDocumentListener(DocumentListener l)
    Removes the specified listener so it no longer receives `DOCUMENT` events when they occur.
    Parameters:
      `l` - the listener to remove
    See Also:
      - `addDocumentListener(javax.swing.event.DocumentListener)`

  - ### addListDataListener

    public static void addListDataListener(ListDataListener l)
    Adds the specified listener to receive all `LISTDATA` events on each component instance in the Java Virtual Machine as they occur.

    Note: This listener is automatically added to all component instances created after this method is called. In addition, it is only added to component instances that support this listener type.

    Parameters:
      `l` - the listener to add
    See Also:
      - `removeListDataListener(javax.swing.event.ListDataListener)`

  - ### removeListDataListener

    public static void removeListDataListener(ListDataListener l)
    Removes the specified listener so it no longer receives `LISTDATA` events when they occur.
    Parameters:
      `l` - the listener to remove
    See Also:
      - `addListDataListener(javax.swing.event.ListDataListener)`

  - ### addListSelectionListener

    public static void addListSelectionListener(ListSelectionListener l)
    Adds the specified listener to receive all `LISTSELECTION` events on each component instance in the Java Virtual Machine as they occur.

    Note: This listener is automatically added to all component instances created after this method is called. In addition, it is only added to component instances that support this listener type.

    Parameters:
      `l` - the listener to add
    See Also:
      - `removeListSelectionListener(javax.swing.event.ListSelectionListener)`

  - ### removeListSelectionListener

    public static void removeListSelectionListener(ListSelectionListener l)
    Removes the specified listener so it no longer receives `LISTSELECTION` events when they occur.
    Parameters:
      `l` - the listener to remove
    See Also:
      - `addListSelectionListener(javax.swing.event.ListSelectionListener)`

  - ### addMenuListener

    public static void addMenuListener(MenuListener l)
    Adds the specified listener to receive all `MENU` events on each component instance in the Java Virtual Machine as they occur.

    Note: This listener is automatically added to all component instances created after this method is called. In addition, it is only added to component instances that support this listener type.

    Parameters:
      `l` - the listener to add
    See Also:
      - `removeMenuListener(javax.swing.event.MenuListener)`

  - ### removeMenuListener

    public static void removeMenuListener(MenuListener l)
    Removes the specified listener so it no longer receives `MENU` events when they occur.
    Parameters:
      `l` - the listener to remove
    See Also:
      - `addMenuListener(javax.swing.event.MenuListener)`

  - ### addPopupMenuListener

    public static void addPopupMenuListener(PopupMenuListener l)
    Adds the specified listener to receive all `POPUPMENU` events on each component instance in the Java Virtual Machine as they occur.

    Note: This listener is automatically added to all component instances created after this method is called. In addition, it is only added to component instances that support this listener type.

    Parameters:
      `l` - the listener to add
    See Also:
      - `removePopupMenuListener(javax.swing.event.PopupMenuListener)`

  - ### removePopupMenuListener

    public static void removePopupMenuListener(PopupMenuListener l)
    Removes the specified listener so it no longer receives `POPUPMENU` events when they occur.
    Parameters:
      `l` - the listener to remove
    See Also:
      - `addPopupMenuListener(javax.swing.event.PopupMenuListener)`

  - ### addTableModelListener

    public static void addTableModelListener(TableModelListener l)
    Adds the specified listener to receive all `TABLEMODEL` events on each component instance in the Java Virtual Machine as they occur.

    Note: This listener is automatically added to all component instances created after this method is called. In addition, it is only added to component instances that support this listener type.

    Parameters:
      `l` - the listener to add
    See Also:
      - `removeTableModelListener(javax.swing.event.TableModelListener)`

  - ### removeTableModelListener

    public static void removeTableModelListener(TableModelListener l)
    Removes the specified listener so it no longer receives `TABLEMODEL` events when they occur.
    Parameters:
      `l` - the listener to remove
    See Also:
      - `addTableModelListener(javax.swing.event.TableModelListener)`

  - ### addTreeExpansionListener

    public static void addTreeExpansionListener(TreeExpansionListener l)
    Adds the specified listener to receive all `TREEEXPANSION` events on each component instance in the Java Virtual Machine as they occur.

    Note: This listener is automatically added to all component instances created after this method is called. In addition, it is only added to component instances that support this listener type.

    Parameters:
      `l` - the listener to add
    See Also:
      - `removeTreeExpansionListener(javax.swing.event.TreeExpansionListener)`

  - ### removeTreeExpansionListener

    public static void removeTreeExpansionListener(TreeExpansionListener l)
    Removes the specified listener so it no longer receives `TREEEXPANSION` events when they occur.
    Parameters:
      `l` - the listener to remove
    See Also:
      - `addTreeExpansionListener(javax.swing.event.TreeExpansionListener)`

  - ### addTreeModelListener

    public static void addTreeModelListener(TreeModelListener l)
    Adds the specified listener to receive all `TREEMODEL` events on each component instance in the Java Virtual Machine as they occur.

    Note: This listener is automatically added to all component instances created after this method is called. In addition, it is only added to component instances that support this listener type.

    Parameters:
      `l` - the listener to add
    See Also:
      - `removeTreeModelListener(javax.swing.event.TreeModelListener)`

  - ### removeTreeModelListener

    public static void removeTreeModelListener(TreeModelListener l)
    Removes the specified listener so it no longer receives `TREEMODEL` events when they occur.
    Parameters:
      `l` - the listener to remove
    See Also:
      - `addTreeModelListener(javax.swing.event.TreeModelListener)`

  - ### addTreeSelectionListener

    public static void addTreeSelectionListener(TreeSelectionListener l)
    Adds the specified listener to receive all `TREESELECTION` events on each component instance in the Java Virtual Machine as they occur.

    Note: This listener is automatically added to all component instances created after this method is called. In addition, it is only added to component instances that support this listener type.

    Parameters:
      `l` - the listener to add
    See Also:
      - `removeTreeSelectionListener(javax.swing.event.TreeSelectionListener)`

  - ### removeTreeSelectionListener

    public static void removeTreeSelectionListener(TreeSelectionListener l)
    Removes the specified listener so it no longer receives `TREESELECTION` events when they occur.
    Parameters:
      `l` - the listener to remove
    See Also:
      - `addTreeSelectionListener(javax.swing.event.TreeSelectionListener)`

  - ### addUndoableEditListener

    public static void addUndoableEditListener(UndoableEditListener l)
    Adds the specified listener to receive all `UNDOABLEEDIT` events on each component instance in the Java Virtual Machine as they occur.

    Note: This listener is automatically added to all component instances created after this method is called. In addition, it is only added to component instances that support this listener type.

    Parameters:
      `l` - the listener to add
    See Also:
      - `removeUndoableEditListener(javax.swing.event.UndoableEditListener)`

  - ### removeUndoableEditListener

    public static void removeUndoableEditListener(UndoableEditListener l)
    Removes the specified listener so it no longer receives `UNDOABLEEDIT` events when they occur.
    Parameters:
      `l` - the listener to remove
    See Also:
      - `addUndoableEditListener(javax.swing.event.UndoableEditListener)`

  - ### addInternalFrameListener

    public static void addInternalFrameListener(InternalFrameListener l)
    Adds the specified listener to receive all `INTERNALFRAME` events on each component instance in the Java Virtual Machine as they occur.

    Note: This listener is automatically added to all component instances created after this method is called. In addition, it is only added to component instances that support this listener type.

    Parameters:
      `l` - the listener to add
    See Also:
      - `removeInternalFrameListener(javax.swing.event.InternalFrameListener)`

  - ### removeInternalFrameListener

    public static void removeInternalFrameListener(InternalFrameListener l)
    Removes the specified listener so it no longer receives `INTERNALFRAME` events when they occur.
    Parameters:
      `l` - the listener to remove
    See Also:
      - `addInternalFrameListener(javax.swing.event.InternalFrameListener)`

  - ### addPropertyChangeListener

    public static void addPropertyChangeListener(PropertyChangeListener l)
    Adds the specified listener to receive all `PROPERTYCHANGE` events on each component instance in the Java Virtual Machine as they occur.

    Note: This listener is automatically added to all component instances created after this method is called. In addition, it is only added to component instances that support this listener type.

    Parameters:
      `l` - the listener to add
    See Also:
      - `removePropertyChangeListener(java.beans.PropertyChangeListener)`

  - ### removePropertyChangeListener

    public static void removePropertyChangeListener(PropertyChangeListener l)
    Removes the specified listener so it no longer receives `PROPERTYCHANGE` events when they occur.
    Parameters:
      `l` - the listener to remove
    See Also:
      - `addPropertyChangeListener(java.beans.PropertyChangeListener)`

  - ### addVetoableChangeListener

    public static void addVetoableChangeListener(VetoableChangeListener l)
    Adds the specified listener to receive all `VETOABLECHANGE` events on each component instance in the Java Virtual Machine as they occur.

    Note: This listener is automatically added to all component instances created after this method is called. In addition, it is only added to component instances that support this listener type.

    Parameters:
      `l` - the listener to add
    See Also:
      - `removeVetoableChangeListener(java.beans.VetoableChangeListener)`

  - ### removeVetoableChangeListener

    public static void removeVetoableChangeListener(VetoableChangeListener l)
    Removes the specified listener so it no longer receives `VETOABLECHANGE` events when they occur.
    Parameters:
      `l` - the listener to remove
    See Also:
      - `addVetoableChangeListener(java.beans.VetoableChangeListener)`