com.google.gwt.user.client.ui

Class ListBox

java.lang.Object

com.google.gwt.user.client.ui.ListBox

public static class ListBox
extends Object

A widget that presents a list of choices to the user, either as a list box or as a drop-down list.

CSS Style Rules

• .gwt-ListBox { }

Example

Built-in Bidi Text Support

This widget is capable of automatically adjusting its direction according to its content. This feature is controlled by #setDirectionEstimator, and is off by default.

Use in UiBinder Templates

The items of a ListBox element are laid out in <g:item> elements. Each item contains text that will be added to the list of available items that will be shown, either in the drop down or list. (Note that the tags of the item elements are not capitalized. This is meant to signal that the item is not a runtime object, and so cannot have a ui:field attribute.) It is also possible to explicitly specify item's value using value attribute as shown below.

For example:

 <g:ListBox>
  <g:item>
    first
  </g:item>
  <g:item value='2'>
    second
  </g:item>
 </g:ListBox>
 

Important usage note

Subclasses should neither read nor write option text directly from the option elements created by this class, since such text may need to be wrapped in Unicode bidi formatting characters. They can use the getOptionText and/or setOptionText methods for this purpose instead.

See Also:

Serialized Form

Method Summary

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, toString