Java™ Platform
Standard Ed. 6

javax.swing.event
Class SwingPropertyChangeSupport

java.lang.Object
  extended by java.beans.PropertyChangeSupport
      extended by 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
SwingPropertyChangeSupport(Object sourceBean)
          Constructs a SwingPropertyChangeSupport object.
SwingPropertyChangeSupport(Object sourceBean, boolean notifyOnEDT)
          Constructs a SwingPropertyChangeSupport object.
 
Method Summary
 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)

Java™ Platform
Standard Ed. 6

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

Copyright 2008 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.