com.threerings.gwt.ui

Class ItemListBox<T>

java.lang.Object

com.google.gwt.user.client.ui.UIObject

com.google.gwt.user.client.ui.Widget

com.google.gwt.user.client.ui.FocusWidget

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

com.threerings.gwt.ui.ItemListBox<T>

All Implemented Interfaces:

HasAllDragAndDropHandlers, HasAllFocusHandlers, HasAllGestureHandlers, HasAllKeyHandlers, HasAllMouseHandlers, HasAllTouchHandlers, HasBlurHandlers, HasChangeHandlers, HasClickHandlers, HasDoubleClickHandlers, HasDragEndHandlers, HasDragEnterHandlers, HasDragHandlers, HasDragLeaveHandlers, HasDragOverHandlers, HasDragStartHandlers, HasDropHandlers, HasFocusHandlers, HasGestureChangeHandlers, HasGestureEndHandlers, HasGestureStartHandlers, HasKeyDownHandlers, HasKeyPressHandlers, HasKeyUpHandlers, HasMouseDownHandlers, HasMouseMoveHandlers, HasMouseOutHandlers, HasMouseOverHandlers, HasMouseUpHandlers, HasMouseWheelHandlers, HasTouchCancelHandlers, HasTouchEndHandlers, HasTouchMoveHandlers, HasTouchStartHandlers, HasAttachHandlers, HasHandlers, HasDirectionEstimator, EventListener, Focusable, HasEnabled, HasFocus, HasName, HasVisibility, IsWidget, SourcesChangeEvents, SourcesClickEvents, SourcesFocusEvents, SourcesKeyboardEvents, SourcesMouseEvents

public class ItemListBox<T>
extends ListBox

A list box that maintains a list of actual Java objects.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ItemListBox.Builder<T,Box extends ItemListBox<T>> Simple builder that allows multiple items to be added to the list box during construction.

Nested classes/interfaces inherited from class com.google.gwt.user.client.ui.UIObject

UIObject.DebugIdImpl, UIObject.DebugIdImplEnabled

Field Summary

Fields inherited from class com.google.gwt.user.client.ui.ListBox

DEFAULT_DIRECTION_ESTIMATOR

Fields inherited from class com.google.gwt.user.client.ui.UIObject

DEBUG_ID_PREFIX

Constructor Summary

Constructors

Constructor and Description
ItemListBox() Creates an empty item list box.
ItemListBox(Iterable<T> items) Creates a list box with the supplied set of initial items.

Method Summary

Methods

Modifier and Type	Method and Description
void	addItem(T item) Adds the supplied item to this list box at the end of the list.
void	addItem(T item, String label) Adds the supplied item to this list box at the end of the list, using the supplied label if not null.
static <T> ItemListBox.Builder<T,ItemListBox<T>>	builder() Creates a new builder for an ItemListBox.
T	getSelectedItem() Returns the currently selected item, or null if no item is selected.
void	insertItem(T item, int index) Inserts the supplied item into this list box at the specified position.
void	insertItem(T item, int index, String label) Inserts the supplied item into this list box at the specified position, using the specified label if given.
boolean	removeItem(T item) Removes the supplied item from this list box, returning true if the item was found.
void	setSelectedItem(T value) Selects the specified item.

Methods inherited from class com.google.gwt.user.client.ui.ListBox

addChangeHandler, addChangeListener, addItem, addItem, addItem, addItem, clear, getDirectionEstimator, getItemCount, getItemText, getName, getSelectedIndex, getValue, getVisibleItemCount, insertItem, insertItem, insertItem, insertItem, isItemSelected, isMultipleSelect, removeChangeListener, removeItem, setDirectionEstimator, setDirectionEstimator, setItemSelected, setItemText, setItemText, setMultipleSelect, setName, setSelectedIndex, setValue, setVisibleItemCount, wrap

Methods inherited from class com.google.gwt.user.client.ui.FocusWidget

addBlurHandler, addClickHandler, addClickListener, addDoubleClickHandler, addDragEndHandler, addDragEnterHandler, addDragHandler, addDragLeaveHandler, addDragOverHandler, addDragStartHandler, addDropHandler, addFocusHandler, addFocusListener, addGestureChangeHandler, addGestureEndHandler, addGestureStartHandler, addKeyboardListener, addKeyDownHandler, addKeyPressHandler, addKeyUpHandler, addMouseDownHandler, addMouseListener, addMouseMoveHandler, addMouseOutHandler, addMouseOverHandler, addMouseUpHandler, addMouseWheelHandler, addMouseWheelListener, addTouchCancelHandler, addTouchEndHandler, addTouchMoveHandler, addTouchStartHandler, getTabIndex, isEnabled, removeClickListener, removeFocusListener, removeKeyboardListener, removeMouseListener, removeMouseWheelListener, setAccessKey, setEnabled, setFocus, setTabIndex

Methods inherited from class com.google.gwt.user.client.ui.Widget

addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, fireEvent, getLayoutData, getParent, isAttached, onBrowserEvent, removeFromParent, setLayoutData, sinkEvents

Methods inherited from class com.google.gwt.user.client.ui.UIObject

addStyleDependentName, addStyleName, ensureDebugId, ensureDebugId, getAbsoluteLeft, getAbsoluteTop, getElement, getOffsetHeight, getOffsetWidth, getStyleName, getStylePrimaryName, getTitle, isVisible, isVisible, removeStyleDependentName, removeStyleName, setHeight, setPixelSize, setSize, setStyleDependentName, setStyleName, setStyleName, setStylePrimaryName, setTitle, setVisible, setVisible, setWidth, sinkBitlessEvent, toString, unsinkEvents

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.google.gwt.event.shared.HasHandlers

fireEvent

Constructor Detail

ItemListBox

public ItemListBox()

Creates an empty item list box.

ItemListBox

public ItemListBox(Iterable<T> items)

Creates a list box with the supplied set of initial items.

Method Detail

builder

public static <T> ItemListBox.Builder<T,ItemListBox<T>> builder()

Creates a new builder for an ItemListBox.

addItem

public void addItem(T item,
           String label)

Adds the supplied item to this list box at the end of the list, using the supplied label if not null. If no label is given, #toLabel() is used to calculate it.

addItem

public void addItem(T item)

Adds the supplied item to this list box at the end of the list.

insertItem

public void insertItem(T item,
              int index,
              String label)

Inserts the supplied item into this list box at the specified position, using the specified label if given. If no label is given, #toLabel() is used to calculate it.

insertItem

public void insertItem(T item,
              int index)

Inserts the supplied item into this list box at the specified position.

removeItem

public boolean removeItem(T item)

Removes the supplied item from this list box, returning true if the item was found.

getSelectedItem

public T getSelectedItem()

Returns the currently selected item, or null if no item is selected.

setSelectedItem

public void setSelectedItem(T value)

Selects the specified item.