com.sencha.gxt.cell.core.client.form

Class ComboBoxCell<T>

java.lang.Object

com.google.gwt.cell.client.AbstractCell<C>

com.google.gwt.cell.client.AbstractEditableCell<C,V>

com.google.gwt.cell.client.AbstractInputCell<T,V>

com.sencha.gxt.cell.core.client.AbstractEventInputCell<T,FieldCell.FieldViewData>

com.sencha.gxt.cell.core.client.form.FieldCell<T>

com.sencha.gxt.cell.core.client.form.ValueBaseFieldCell<T>

com.sencha.gxt.cell.core.client.form.TriggerFieldCell<T>

com.sencha.gxt.cell.core.client.form.ComboBoxCell<T>

All Implemented Interfaces:

Cell<T>, ResizableCell, ParseErrorEvent.HasParseErrorHandlers

Direct Known Subclasses:

TimeFieldCell

public class ComboBoxCell<T>
extends TriggerFieldCell<T>

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ComboBoxCell.QueryMode
static class	ComboBoxCell.TriggerAction TriggerAction enum.

Nested classes/interfaces inherited from class com.sencha.gxt.cell.core.client.form.TriggerFieldCell

TriggerFieldCell.TriggerFieldAppearance

Nested classes/interfaces inherited from class com.sencha.gxt.cell.core.client.form.ValueBaseFieldCell

ValueBaseFieldCell.ValueBaseFieldAppearance

Nested classes/interfaces inherited from class com.sencha.gxt.cell.core.client.form.FieldCell

FieldCell.FieldAppearance, FieldCell.FieldAppearanceOptions, FieldCell.FieldViewData

Nested classes/interfaces inherited from interface com.google.gwt.cell.client.Cell

Cell.Context

Constructor Summary

Constructors

Constructor and Description
ComboBoxCell(ListStore<T> store, LabelProvider<T> labelProvider, LabelProvider<T> viewLabelProvider)
ComboBoxCell(ListStore<T> store, LabelProvider<T> labelProvider, ListView<T,?> view)

Method Summary

Methods

Modifier and Type	Method and Description
void	clear()
void	clearSelections(Cell.Context context, XElement parent, ValueUpdater<T> updater)
void	collapse(Cell.Context context, XElement parent)
void	doQuery(Cell.Context context, XElement parent, ValueUpdater<T> updater, T value, String query, boolean force)
void	expand(Cell.Context context, XElement parent, ValueUpdater<T> updater, T value)
String	getAllQuery() Returns the all query.
LabelProvider<T>	getLabelProvider() Returns the label provider.
ListView<T,?>	getListView() Returns the list view.
Loader<?,?>	getLoader()
int	getMinChars() Returns the min characters used for autocompete and typeahead.
int	getMinListWidth() Returns the dropdown list's min width.
ComboBoxCell.QueryMode	getMode()
int	getPageSize() Returns the page size.
PagingToolBar	getPagingToolBar() Returns the combo's paging tool bar.
ListStore<T>	getStore() Returns the combo's list store.
ComboBoxCell.TriggerAction	getTriggerAction() Returns the trigger action.
int	getTypeAheadDelay() Returns the type ahead delay in milliseconds.
boolean	isExpanded() Returns true if the dropdown is expanded.
boolean	isForceSelection() Returns true if the field's value is forced to one of the value in the list.
boolean	isTypeAhead() Returns true if type ahead is enabled.
void	onBrowserEvent(Cell.Context context, Element parent, T value, NativeEvent event, ValueUpdater<T> valueUpdater)
void	render(Cell.Context context, T value, SafeHtmlBuilder sb)
void	select(int index) Select an item in the dropdown list by its numeric index in the list.
void	select(T item) Select an item in the dropdown list.
void	setAllQuery(String allQuery) The text query to send to the server to return all records for the list with no filtering (defaults to '').
void	setForceSelection(boolean forceSelection) Sets whether the combo's value is restricted to one of the values in the list, false to allow the user to set arbitrary text into the field (defaults to false).
void	setLabelProvider(LabelProvider<T> labelProvider)
void	setLoader(Loader<?,?> loader) Sets the loader for use with remote queries.
void	setMinChars(int minChars) Sets the minimum number of characters the user must type before autocomplete and typeahead active (defaults to 4 if remote, or 0 if local).
void	setMinListWidth(int minListWidth) Sets the minimum width of the dropdown list in pixels (defaults to 70, will be ignored if listWidth has a higher value).
void	setPageSize(int pageSize) Sets the page size.
void	setStore(ListStore<T> store) Sets the combo's store.
void	setTriggerAction(ComboBoxCell.TriggerAction triggerAction)
void	setTypeAhead(boolean typeAhead)
void	setTypeAheadDelay(int typeAheadDelay)

Methods inherited from class com.sencha.gxt.cell.core.client.form.TriggerFieldCell

finishEditing, getAppearance, isEditable, isHideTrigger, isMonitorTab, setEditable, setHideTrigger, setMonitorTab

Methods inherited from class com.sencha.gxt.cell.core.client.form.ValueBaseFieldCell

addParseErrorHandler, getEmptyText, getInputElement, getName, getPropertyEditor, getText, isAllowBlank, isSelectOnFocus, onEmpty, select, selectAll, setAllowBlank, setEmptyText, setName, setPropertyEditor, setSelectOnFocus, setText

Methods inherited from class com.sencha.gxt.cell.core.client.form.FieldCell

getHeight, getWidth, isReadOnly, onValid, setHeight, setReadOnly, setSize, setWidth

Methods inherited from class com.sencha.gxt.cell.core.client.AbstractEventInputCell

addHandler, fireEvent, isDisableEvents, setDisableEvents

Methods inherited from class com.google.gwt.cell.client.AbstractInputCell

isEditing, resetFocus

Methods inherited from class com.google.gwt.cell.client.AbstractEditableCell

clearViewData, getViewData, setViewData

Methods inherited from class com.google.gwt.cell.client.AbstractCell

dependsOnSelection, getConsumedEvents, handlesSelection, setValue

Methods inherited from class java.lang.Object

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

Constructor Detail

ComboBoxCell

public ComboBoxCell(ListStore<T> store,
            LabelProvider<T> labelProvider,
            LabelProvider<T> viewLabelProvider)

ComboBoxCell

public ComboBoxCell(ListStore<T> store,
            LabelProvider<T> labelProvider,
            ListView<T,?> view)

Method Detail

clear

public void clear()

clearSelections

public void clearSelections(Cell.Context context,
                   XElement parent,
                   ValueUpdater<T> updater)

collapse

public void collapse(Cell.Context context,
            XElement parent)

doQuery

public void doQuery(Cell.Context context,
           XElement parent,
           ValueUpdater<T> updater,
           T value,
           String query,
           boolean force)

expand

public void expand(Cell.Context context,
          XElement parent,
          ValueUpdater<T> updater,
          T value)

getAllQuery

public String getAllQuery()

Returns the all query.

Returns:

the all query

getLabelProvider

public LabelProvider<T> getLabelProvider()

Returns the label provider.

Returns:

the label provider

getListView

public ListView<T,?> getListView()

Returns the list view.

Returns:

the list view

getLoader

public Loader<?,?> getLoader()

getMinChars

public int getMinChars()

Returns the min characters used for autocompete and typeahead.

Returns:

the minimum number of characters

getMinListWidth

public int getMinListWidth()

Returns the dropdown list's min width.

Returns:

the min width

getMode

public ComboBoxCell.QueryMode getMode()

getPageSize

public int getPageSize()

Returns the page size.

Returns:

the page size

getPagingToolBar

public PagingToolBar getPagingToolBar()

Returns the combo's paging tool bar.

Returns:

the tool bar

getStore

public ListStore<T> getStore()

Returns the combo's list store.

Returns:

the store

getTriggerAction

public ComboBoxCell.TriggerAction getTriggerAction()

Returns the trigger action.

Returns:

the trigger action

getTypeAheadDelay

public int getTypeAheadDelay()

Returns the type ahead delay in milliseconds.

Returns:

the type ahead delay

isExpanded

public boolean isExpanded()

Returns true if the dropdown is expanded.

Returns:

the expand state

isForceSelection

public boolean isForceSelection()

Returns true if the field's value is forced to one of the value in the list.

Returns:

the force selection state

isTypeAhead

public boolean isTypeAhead()

Returns true if type ahead is enabled.

Returns:

the type ahead state

onBrowserEvent

public void onBrowserEvent(Cell.Context context,
                  Element parent,
                  T value,
                  NativeEvent event,
                  ValueUpdater<T> valueUpdater)

Specified by:

onBrowserEvent in interface Cell<T>

Overrides:

onBrowserEvent in class TriggerFieldCell<T>

render

public void render(Cell.Context context,
          T value,
          SafeHtmlBuilder sb)

Specified by:

render in interface Cell<T>

Overrides:

render in class TriggerFieldCell<T>

select

public void select(int index)

Select an item in the dropdown list by its numeric index in the list. This function does NOT cause the select event to fire. The list must expanded for this function to work, otherwise use #setValue.

Parameters:

index - the index of the item to select

select

public void select(T item)

Select an item in the dropdown list. This function does NOT cause the select event to fire. The list must expanded for this function to work, otherwise use #setValue.

Parameters:

item - the item to select

setAllQuery

public void setAllQuery(String allQuery)

The text query to send to the server to return all records for the list with no filtering (defaults to '').

Parameters:

allQuery - the all query

setForceSelection

public void setForceSelection(boolean forceSelection)

Sets whether the combo's value is restricted to one of the values in the list, false to allow the user to set arbitrary text into the field (defaults to false).

Parameters:

forceSelection - true to force selection

setLabelProvider

public void setLabelProvider(LabelProvider<T> labelProvider)

setLoader

public void setLoader(Loader<?,?> loader)

Sets the loader for use with remote queries.

Parameters:

loader - the loader

setMinChars

public void setMinChars(int minChars)

Sets the minimum number of characters the user must type before autocomplete and typeahead active (defaults to 4 if remote, or 0 if local).

Parameters:

minChars - minimum number of characters before activating autocomplete and typeahead

setMinListWidth

public void setMinListWidth(int minListWidth)

Sets the minimum width of the dropdown list in pixels (defaults to 70, will be ignored if listWidth has a higher value).

Parameters:

minListWidth - the min width

setPageSize

public void setPageSize(int pageSize)

Sets the page size. Only applies when using a paging toolbar.

Parameters:

pageSize - the page size

setStore

public void setStore(ListStore<T> store)

Sets the combo's store.

Parameters:

store - the store

setTriggerAction

public void setTriggerAction(ComboBoxCell.TriggerAction triggerAction)

setTypeAhead

public void setTypeAhead(boolean typeAhead)

setTypeAheadDelay

public void setTypeAheadDelay(int typeAheadDelay)