javax.swing.event

## Class SwingPropertyChangeSupport

- java.lang.Object
- - java.beans.PropertyChangeSupport
  - - javax.swing.event.SwingPropertyChangeSupport

- All Implemented Interfaces:
    Serializable

      public final class SwingPropertyChangeSupport
      extends PropertyChangeSupport

  This subclass of `java.beans.PropertyChangeSupport` is almost identical in functionality. The only difference is if constructed with `SwingPropertyChangeSupport(sourceBean, true)` it ensures listeners are only ever notified on the Event Dispatch Thread.

- - ### Constructor Summary

    Constructors
    Constructor and Description
    `SwingPropertyChangeSupport(Object sourceBean)` Constructs a SwingPropertyChangeSupport object.
    `SwingPropertyChangeSupport(Object sourceBean, boolean notifyOnEDT)` Constructs a SwingPropertyChangeSupport object.

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `void` | `firePropertyChange(PropertyChangeEvent evt)` Fire an existing PropertyChangeEvent to any registered listeners.
    `boolean` | `isNotifyOnEDT()` Returns `notifyOnEDT` property.

    - ### Methods inherited from class java.beans.PropertyChangeSupport

      `addPropertyChangeListener, addPropertyChangeListener, fireIndexedPropertyChange, fireIndexedPropertyChange, fireIndexedPropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getPropertyChangeListeners, getPropertyChangeListeners, hasListeners, removePropertyChangeListener, removePropertyChangeListener`

    - ### Methods inherited from class java.lang.Object

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

- - ### Constructor Detail

    - #### SwingPropertyChangeSupport

          public SwingPropertyChangeSupport(Object sourceBean)

      Constructs a SwingPropertyChangeSupport object.
      Parameters:
        `sourceBean` - The bean to be given as the source for any events.
      Throws:
        `NullPointerException` - if `sourceBean` is `null`

    - #### SwingPropertyChangeSupport

          public SwingPropertyChangeSupport(Object sourceBean,
                                    boolean notifyOnEDT)

      Constructs a SwingPropertyChangeSupport object.
      Parameters:
        `sourceBean` - the bean to be given as the source for any events
        `notifyOnEDT` - whether to notify listeners on the Event Dispatch Thread only
      Throws:
        `NullPointerException` - if `sourceBean` is `null`
      Since:
        1.6

  - ### Method Detail

    - #### firePropertyChange

          public void firePropertyChange(PropertyChangeEvent evt)

      Fire an existing PropertyChangeEvent to any registered listeners. No event is fired if the given event's old and new values are equal and non-null.

      If `isNotifyOnEDT()` is `true` and called off the Event Dispatch Thread this implementation uses `SwingUtilities.invokeLater` to send out the notification on the Event Dispatch Thread. This ensures listeners are only ever notified on the Event Dispatch Thread.

      Overrides:
        `firePropertyChange` in class `PropertyChangeSupport`
      Parameters:
        `evt` - The PropertyChangeEvent object.
      Throws:
        `NullPointerException` - if `evt` is `null`
      Since:
        1.6

    - #### isNotifyOnEDT

          public final boolean isNotifyOnEDT()

      Returns `notifyOnEDT` property.
      Returns:
        `notifyOnEDT` property
      Since:
        1.6
      See Also:
        `SwingPropertyChangeSupport(Object sourceBean, boolean notifyOnEDT)`

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

Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.