ilog.views.sdm.event

Class SDMPropertyChangeEvent

java.lang.Object

java.util.EventObject

ilog.views.sdm.event.SDMModelEvent

ilog.views.sdm.event.SDMPropertyChangeEvent

All Implemented Interfaces:

Serializable

public class SDMPropertyChangeEvent
extends SDMModelEvent

Events of type SDMPropertyChangeEvent are sent to SDMModelListeners by an IlvSDMModel when one or more properties of a data object have changed.

Since:

JViews 4.0

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static String	OBJECT_ID This string is passed as the property name when the SDMPropertyChangeEvent notifies the listeners that the ID of an object has changed.

Fields inherited from class java.util.EventObject

source

Constructor Summary

Constructors

Constructor and Description
SDMPropertyChangeEvent(Object source, Object object, boolean adjusting, String[] propertyNames, Object[] oldValues, Object[] newValues) Creates a new SDMPropertyChangeEvent for multiple simultaneous property changes.
SDMPropertyChangeEvent(Object source, Object object, boolean adjusting, String propertyName, Object oldValue, Object newValue) Creates a new SDMPropertyChangeEvent for a single property change or for an unspecified set of property changes.

Method Summary

Modifier and Type	Method and Description
Object	getNewValue() Returns the new value of the primary property, or null if an unspecified set of properties has changed.
Object[]	getNewValues() Returns the new values of the properties.
Object	getOldValue() Returns the old value of the primary property, or null if an unspecified set of properties has changed.
Object[]	getOldValues() Returns the old values of the properties.
String	getPropertyName() Returns the name of the primary property that has been modified, or null if an unspecified set of properties has changed.
String[]	getPropertyNames() Returns the names of the properties that have been modified, or null if an unspecified set of properties has changed.

Methods inherited from class ilog.views.sdm.event.SDMModelEvent

getModel, getObject, isAdjusting

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

Field Detail

OBJECT_ID

public static final String OBJECT_ID

This string is passed as the property name when the SDMPropertyChangeEvent notifies the listeners that the ID of an object has changed. This string is initialized to new String("id"), so you can test it safely using the expression:

 event.getPropertyName() == SDMPropertyChangeEvent.OBJECT_ID
 

Constructor Detail

SDMPropertyChangeEvent

public SDMPropertyChangeEvent(Object source,
                              Object object,
                              boolean adjusting,
                              String propertyName,
                              Object oldValue,
                              Object newValue)

Creates a new SDMPropertyChangeEvent for a single property change or for an unspecified set of property changes.

Parameters:

source - The event source.

object - The application object whose property has been changed.

adjusting - A flag that indicates whether the modification is part of a series of related modifications. This flag is set to the value passed during the last call to the model's IlvSDMModel.setAdjusting(boolean) method.

propertyName - The name of the property that has been modified, or null if an unspecified set of properties has changed.

oldValue - The old value of the property, or null if an unspecified set of properties has changed.

newValue - The new value of the property, or null if an unspecified set of properties has changed.

SDMPropertyChangeEvent

public SDMPropertyChangeEvent(Object source,
                              Object object,
                              boolean adjusting,
                              String[] propertyNames,
                              Object[] oldValues,
                              Object[] newValues)

Creates a new SDMPropertyChangeEvent for multiple simultaneous property changes.

Parameters:

source - The event source.

object - The application object whose properties have been changed.

adjusting - A flag that indicates whether the modification is part of a series of related modifications. This flag is set to the value passed during the last call to the model's IlvSDMModel.setAdjusting(boolean) method.

propertyNames - The names of the properties that have been modified. It must be a non-empty array.

oldValues - The old values of the properties. It must be an array of the same length as propertyNames.

newValues - The new values of the properties. It must be an array of the same length as propertyNames.

Since:

JViews 8.5

Method Detail

getPropertyName

public String getPropertyName()

Returns the name of the primary property that has been modified, or null if an unspecified set of properties has changed. If the event notifies the listeners that the ID of an object has changed, the property name is set to OBJECT_ID.

See Also:

getPropertyNames()

getOldValue

public Object getOldValue()

Returns the old value of the primary property, or null if an unspecified set of properties has changed.

getNewValue

public Object getNewValue()

Returns the new value of the primary property, or null if an unspecified set of properties has changed.

getPropertyNames

public String[] getPropertyNames()

Returns the names of the properties that have been modified, or null if an unspecified set of properties has changed. If the ID of an object has changed, the property name used to designate this change is OBJECT_ID.

Returns:

An array whose first element is the primary changed property, or null for an unspecified set of property changes.

Since:

JViews 8.5

See Also:

getPropertyName()

getOldValues

public Object[] getOldValues()

Returns the old values of the properties.

Returns:

An array of the same length as getPropertyNames(), or null for an unspecified set of property changes.

Since:

JViews 8.5

getNewValues

public Object[] getNewValues()

Returns the new values of the properties.

Returns:

An array of the same length as getPropertyNames(), or null for an unspecified set of property changes.

Since:

JViews 8.5