public interface

HasValue

implements HasValueChangeHandlers<T> TakesValue<V>
com.google.gwt.user.client.ui.HasValue<T>
Known Indirect Subclasses

Class Overview

Extends TakesValue to allow the value to be pulled back out, and to throw ValueChangeEvent events.

An object that implements this interface should be a user input widget, where the user and programmer can both set and get the object's value. It is intended to provide a unified interface to widgets with "atomic" values, like Strings and Dates.

Summary

Public Methods
abstract T getValue()
Gets this object's value.
abstract void setValue(T value, boolean fireEvents)
Sets this object's value.
abstract void setValue(T value)
Sets this object's value without firing any events.
[Expand]
Inherited Methods
From interface com.google.gwt.event.logical.shared.HasValueChangeHandlers
From interface com.google.gwt.event.shared.HasHandlers
From interface com.google.gwt.user.client.TakesValue

Public Methods

public abstract T getValue ()

Gets this object's value.

Returns
  • the object's value

public abstract void setValue (T value, boolean fireEvents)

Sets this object's value. Fires ValueChangeEvent when fireEvents is true and the new value does not equal the existing value.

It is acceptable to fail assertions or throw (documented) unchecked exceptions in response to bad values.

Parameters
value the object's new value
fireEvents fire events if true and value is new

public abstract void setValue (T value)

Sets this object's value without firing any events. This should be identical to calling setValue(value, false).

It is acceptable to fail assertions or throw (documented) unchecked exceptions in response to bad values.

Widgets must accept null as a valid value. By convention, setting a widget to null clears value, calling getValue() on a cleared widget returns null. Widgets that can not be cleared (e.g. CheckBox) must find another valid meaning for null input.

Parameters
value the object's new value