ilog.views.gantt.event

Class ResourceNameEvent

java.lang.Object

java.util.EventObject

ilog.views.gantt.util.event.IlvPropertyEvent

ilog.views.gantt.event.ResourcePropertyEvent

ilog.views.gantt.event.ResourceNameEvent

All Implemented Interfaces:

ResourceEvent, Serializable

public class ResourceNameEvent
extends ResourcePropertyEvent

ResourceNameEvent is fired by an IlvResource both before and after its name is modified. Immediately before its name is modified, an IlvResource fires an aboutToChange ResourceNameEvent in all listeners registered with the Gantt data model. Listeners can modify or constrain the proposed name by invoking setNewName(). Alternatively, a listener can veto the proposed change by invoking veto().

After its name is modified, an IlvResource will fire a changed ResourceNameEvent in all listeners registered with the Gantt data model. Listeners can access the old and new values of the resource's name, but cannot modify them via the event mechanism.

See Also:

IlvResource, IlvGanttModel.addResourceListener(ilog.views.gantt.event.ResourceListener), Serialized Form

Field Summary

Fields inherited from class java.util.EventObject

source

Constructor Summary

Constructors

Constructor and Description
ResourceNameEvent(IlvResource resource, String oldName, String newName, boolean aboutToChangeEvent) Constructs a new ResourceNameEvent generated by the specified resource and with the specified old and new name values.

Method Summary

Modifier and Type	Method and Description
String	getNewName() Returns the resource's new name.
String	getOldName() Returns the resource's old name.
void	setNewName(String name) Sets the resource's proposed new name.

Methods inherited from class ilog.views.gantt.event.ResourcePropertyEvent

getResource

Methods inherited from class ilog.views.gantt.util.event.IlvPropertyEvent

getNewValue, getOldValue, isAboutToChangeEvent, isChangedEvent, isVetoed, setNewValue, veto

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

ResourceNameEvent

public ResourceNameEvent(IlvResource resource,
                         String oldName,
                         String newName,
                         boolean aboutToChangeEvent)

Constructs a new ResourceNameEvent generated by the specified resource and with the specified old and new name values.

Parameters:

resource - the resource where the event originated

oldName - the resource's previous name

newName - the resource's new name

aboutToChangeEvent - true if this is a resourceNameAboutToChange event or false if this is a resourceNameChanged event.

Method Detail

getOldName

public String getOldName()

Returns the resource's old name. If this is a resourceNameAboutToChange event, then this will be the same as the resource's current name since the change has not actually occurred yet. If this is a resourceNameChanged event, this will be the resource's name prior to the current modification being reported.

Returns:

The String representing the old name.

getNewName

public String getNewName()

Returns the resource's new name. If this is a resourceNameAboutToChange event, then this is will be the resource's proposed value. If this is a resourceNameChanged event, this will be the resource's new name which is being reported.

Returns:

The String representing the new name.

setNewName

public void setNewName(String name)

Sets the resource's proposed new name. This method only has meaning if this is a resourceNameAboutToChange event. By using this method, a listener can constrain changes to the resource's name.

Parameters:

name - the resource's name