Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| Eclipse Platform Release 3.0
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## org.eclipse.jface.util
Class PropertyChangeEvent

    java.lang.Object
      java.util.EventObject
          org.eclipse.jface.util.PropertyChangeEvent

All Implemented Interfaces:
  Serializable

public class PropertyChangeEvent
extends EventObject

An event object describing a change to a named property.

This concrete class was designed to be instantiated, but may also be subclassed if required.

The JFace frameworks contain classes that report property change events for internal state changes that may be of interest to external parties. A special listener interface (`IPropertyChangeListener`) is defined for this purpose, and a typical class allow listeners to be registered via an `addPropertyChangeListener` method.

See Also:
  `IPropertyChangeListener`, Serialized Form

Field Summary

Fields inherited from class java.util.EventObject
`source`

Constructor Summary
`PropertyChangeEvent(Object source, String property, Object oldValue, Object newValue)` Creates a new property change event.

Method Summary
`Object` | `getNewValue()` Returns the new value of the property.
`Object` | `getOldValue()` Returns the old value of the property.
`String` | `getProperty()` Returns the name of the property that changed.

Methods inherited from class java.util.EventObject
`getSource, toString`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

Constructor Detail

### PropertyChangeEvent

    public PropertyChangeEvent(Object source,
                               String property,
                               Object oldValue,
                               Object newValue)

  Creates a new property change event.

Parameters:
  `source` - the object whose property has changed
  `property` - the property that has changed (must not be `null`)
  `oldValue` - the old value of the property, or `null` if none
  `newValue` - the new value of the property, or `null` if none

Method Detail

### getNewValue

    public Object getNewValue()

  Returns the new value of the property.

  Returns:
    the new value, or `null` if not known or not relevant

### getOldValue

    public Object getOldValue()

  Returns the old value of the property.

  Returns:
    the old value, or `null` if not known or not relevant

### getProperty

    public String getProperty()

  Returns the name of the property that changed.

  Warning: there is no guarantee that the property name returned is a constant string. Callers must compare property names using equals, not ==.

  Returns:
    the name of the property that changed

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| Eclipse Platform Release 3.0
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Guidelines for using Eclipse APIs.

Copyright (c) IBM Corp. and others 2000, 2004. All rights reserved.