javax.faces.event: public class: ValueChangeEvent

javax.faces.event
public class: ValueChangeEvent [javadoc | source]

java.lang.Object
   java.util.EventObject
      javax.faces.event.FacesEvent
         javax.faces.event.ValueChangeEvent

All Implemented Interfaces:
Serializable

A ValueChangeEvent is a notification that the local value of the source component has been change as a result of user interface activity. It is not fired unless validation of the new value was completed successfully.

Fields inherited from java.util.EventObject:
source

Constructor:

Constructor:
public ValueChangeEvent(UIComponent component, Object oldValue, Object newValue) { super(component); this.oldValue = oldValue; this.newValue = newValue; } Construct a new event object from the specified source component, old value, and new value. The default PhaseId for this event is PhaseId#ANY_PHASE . Parameters: `component` - Source UIComponent for this event `oldValue` - The previous local value of this UIComponent `newValue` - The new local value of thie UIComponent Throws: `IllegalArgumentException` - if `component` is `null`

 public ValueChangeEvent(UIComponent component,
    Object oldValue,
    Object newValue) {
        super(component);
        this.oldValue = oldValue;
        this.newValue = newValue;
}

Construct a new event object from the specified source component, old value, and new value.

The default PhaseId for this event is PhaseId#ANY_PHASE .

Parameters:

component - Source UIComponent for this event

oldValue - The previous local value of this UIComponent

newValue - The new local value of thie UIComponent

Throws:

IllegalArgumentException - if component is null

Method from javax.faces.event.ValueChangeEvent Summary:
getNewValue, getOldValue, isAppropriateListener, processListener

Methods from javax.faces.event.FacesEvent:
getComponent, getPhaseId, isAppropriateListener, processListener, queue, setPhaseId

Methods from java.util.EventObject:
getSource, toString

Methods from java.lang.Object:
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from javax.faces.event.ValueChangeEvent Detail:
public Object getNewValue() { return (this.newValue); } Return the current local value of the source UIComponent .
public Object getOldValue() { return (this.oldValue); } Return the previous local value of the source UIComponent .
public boolean isAppropriateListener(FacesListener listener) { return (listener instanceof ValueChangeListener); }
public void processListener(FacesListener listener) { ((ValueChangeListener) listener).processValueChange(this); }