com.google.gwt.event.logical.shared
Class ValueChangeEvent<I>

java.lang.Object
  com.google.gwt.event.shared.GwtEvent<ValueChangeHandler<I>>
      com.google.gwt.event.logical.shared.ValueChangeEvent<I>

Type Parameters:

I - the value about to be changed

public class ValueChangeEvent<I>
extends GwtEvent<ValueChangeHandler<I>>

Represents a value change event.

Nested Class Summary

Nested classes/interfaces inherited from class com.google.gwt.event.shared.GwtEvent

GwtEvent.Type<H>

Method Summary

static <I> void	fire(HasValueChangeHandlers<I> source, I value) Fires a value change event on all registered handlers in the handler manager.If no such handlers exist, this method will do nothing.
static <I> void	fireIfNotEqual(HasValueChangeHandlers<I> source, I oldValue, I newValue) Fires value change event if the old value is not equal to the new value.
GwtEvent.Type<ValueChangeHandler<I>>	getAssociatedType() Returns the type used to register this event.
static GwtEvent.Type<ValueChangeHandler<?>>	getType() Gets the type associated with this event.
I	getValue() Gets the value.
java.lang.String	toDebugString() This is a method used primarily for debugging.

Methods inherited from class com.google.gwt.event.shared.GwtEvent

getSource, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

fire

public static <I> void fire(HasValueChangeHandlers<I> source,
                            I value)

Fires a value change event on all registered handlers in the handler manager.If no such handlers exist, this method will do nothing.

Type Parameters:

I - the old value type

Parameters:

source - the source of the handlers

value - the value

fireIfNotEqual

public static <I> void fireIfNotEqual(HasValueChangeHandlers<I> source,
                                      I oldValue,
                                      I newValue)

Fires value change event if the old value is not equal to the new value. Use this call rather than making the decision to short circuit yourself for safe handling of null.

Type Parameters:

I - the old value type

Parameters:

source - the source of the handlers

oldValue - the oldValue, may be null

newValue - the newValue, may be null

getType

public static GwtEvent.Type<ValueChangeHandler<?>> getType()

Gets the type associated with this event.

Returns:

returns the handler type

getAssociatedType

public final GwtEvent.Type<ValueChangeHandler<I>> getAssociatedType()

Description copied from class: GwtEvent

Returns the type used to register this event. Used by handler manager to dispatch events to the correct handlers.

Specified by:

getAssociatedType in class GwtEvent<ValueChangeHandler<I>>

Returns:

the type

getValue

public I getValue()

Gets the value.

Returns:

the value

toDebugString

public java.lang.String toDebugString()

Description copied from class: GwtEvent

This is a method used primarily for debugging. It gives a string representation of the event details. This does not override the toString method because the compiler cannot always optimize toString out correctly. Event types should override as desired.

Overrides:

toDebugString in class GwtEvent<ValueChangeHandler<I>>

Returns:

a string representing the event's specifics.