Module java.desktop

Class 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.
    See Also:
    Serialized Form
    • 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)
        Fires a property change event to listeners that have been registered to track updates of all properties or a property with the specified name.

        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 to be fired
        Throws:
        NullPointerException - if evt is null
        Since:
        1.6