com.extjs.gxt.ui.client.widget.form
Class ListField<D extends ModelData>

java.lang.Object
  com.google.gwt.user.client.ui.UIObject
      com.google.gwt.user.client.ui.Widget
          com.extjs.gxt.ui.client.widget.Component
              com.extjs.gxt.ui.client.widget.BoxComponent
                  com.extjs.gxt.ui.client.widget.form.Field<D>
                      com.extjs.gxt.ui.client.widget.form.ListField<D>

Type Parameters:

D - the model type

All Implemented Interfaces:

Observable, SelectionProvider<D>, com.google.gwt.event.shared.HasHandlers, com.google.gwt.user.client.EventListener

public class ListField<D extends ModelData>
extends Field<D>
implements SelectionProvider<D>

A multi-select list field.

Inherited Events:

Field Focus

Field Blur

Field Change

Field Invalid

Field Valid

Field KeyPress

Field SpecialKey

BoxComponent Move

BoxComponent Resize

Component Enable

Component Disable

Component BeforeHide

Component Hide

Component BeforeShow

Component Show

Component Attach

Component Detach

Component BeforeRender

Component Render

Component BrowserEvent

Component BeforeStateRestore

Component StateRestore

Component BeforeStateSave

Component SaveState

Nested Class Summary

Nested classes/interfaces inherited from class com.extjs.gxt.ui.client.widget.form.Field

Field.FieldImages, Field.FieldMessages

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

com.google.gwt.user.client.ui.UIObject.DebugIdImpl, com.google.gwt.user.client.ui.UIObject.DebugIdImplEnabled

Field Summary

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

DEBUG_ID_PREFIX

Constructor Summary

ListField()

Method Summary

void	addSelectionChangedListener(SelectionChangedListener<D> listener) Add a selection changed listener.
void	disable() Disable this component.
void	enable() Enable this component.
java.lang.String	getDisplayField() Returns the display field.
java.lang.String	getItemSelector() Returns the item selector.
ListView<D>	getListView() Returns the field's list view.
ListModelPropertyEditor<D>	getPropertyEditor() Returns the field's property editor.
java.lang.String	getRawValue() Returns the raw data value which may or may not be a valid, defined value.
java.util.List<D>	getSelection() Returns the current selection.
ListStore<D>	getStore() Returns the field's store.
XTemplate	getTemplate() Returns the custom template.
D	getValue() Returns the typed value of the field.
java.lang.String	getValueField()
void	removeSelectionListener(SelectionChangedListener<D> listener) Removes a selection changed listener.
void	setDisplayField(java.lang.String displayField) Sets the display field.
void	setItemSelector(java.lang.String itemSelector) This setting is required if a custom XTemplate has been specified.
void	setPropertyEditor(PropertyEditor<D> propertyEditor) Sets the field's property editor which is used to translate typed values to string, and string values back to typed values.
void	setSelection(java.util.List<D> selection) Sets the current selection for this selection provider.
void	setStore(ListStore<D> store) Sets the list field's list store.
void	setTemplate(java.lang.String html) Sets the field's template used to render the list.
void	setTemplate(XTemplate template) Sets the field's template used to render the list.
void	setValueField(java.lang.String valueField) Sets the field's value field.

Methods inherited from class com.extjs.gxt.ui.client.widget.form.Field

addInputStyleName, addKeyListener, clearInvalid, focus, forceInvalid, getAutoValidate, getEmptyText, getErrorMessage, getFieldLabel, getImages, getLabelSeparator, getLabelStyle, getMessages, getMessageTarget, getName, getOriginalValue, getValidateOnBlur, getValidationDelay, isDirty, isFireChangeEventOnSetValue, isHideLabel, isInEditor, isReadOnly, isValid, isValid, markInvalid, onComponentEvent, removeInputStyleName, removeKeyListener, reset, setAutoValidate, setEmptyText, setFieldLabel, setFireChangeEventOnSetValue, setHideLabel, setImages, setInEditor, setLabelSeparator, setLabelStyle, setMessages, setMessageTarget, setName, setOriginalValue, setRawValue, setReadOnly, setTabIndex, setValidateOnBlur, setValidationDelay, setValue, updateOriginalValue, validate, validate

Methods inherited from class com.extjs.gxt.ui.client.widget.BoxComponent

getBounds, getHeight, getHeight, getPosition, getShadow, getShadowOffset, getShadowPosition, getSize, getWidth, getWidth, isAutoHeight, isAutoWidth, isDeferHeight, isShim, setAutoHeight, setAutoWidth, setBounds, setBounds, setDeferHeight, setHeight, setHeight, setPagePosition, setPagePosition, setPixelSize, setPosition, setShadow, setShadowOffset, setShadowPosition, setShim, setSize, setSize, setWidth, setWidth, sync, syncSize

Methods inherited from class com.extjs.gxt.ui.client.widget.Component

addListener, addPlugin, addStyleName, addWidgetListener, clearState, disableEvents, disableTextSelection, el, enableEvents, fireEvent, fireEvent, fireEvent, fly, getBaseStyle, getBorders, getContextMenu, getData, getElement, getHideMode, getId, getItemId, getListeners, getModel, getState, getStateId, getToolTip, hasListeners, hasListeners, hide, hideToolTip, isDisabledEvents, isEnabled, isRendered, isStateful, isVisible, mask, mask, mask, onBrowserEvent, recalculate, removeAllListeners, removeFromParent, removeListener, removeStyleName, removeSwallow, removeToolTip, removeWidgetListener, render, render, repaint, saveState, setBorders, setContextMenu, setData, setElement, setEnabled, setHideMode, setId, setIntStyleAttribute, setItemId, setStateful, setStateId, setStyleAttribute, setStyleName, setTitle, setToolTip, setToolTip, setVisible, setZIndex, show, sinkEvents, swallowEvent, swallowEvent, toString, unmask

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

fireEvent, getParent, isAttached

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

addStyleDependentName, ensureDebugId, ensureDebugId, getAbsoluteLeft, getAbsoluteTop, getOffsetHeight, getOffsetWidth, getStyleName, getStylePrimaryName, getTitle, isVisible, removeStyleDependentName, setStylePrimaryName, setVisible, unsinkEvents

Methods inherited from class java.lang.Object

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

Constructor Detail

ListField

public ListField()

Method Detail

addSelectionChangedListener

public void addSelectionChangedListener(SelectionChangedListener<D> listener)

Description copied from interface: SelectionProvider

Add a selection changed listener.

Specified by:

addSelectionChangedListener in interface SelectionProvider<D extends ModelData>

Parameters:

listener - a selection changed listener

disable

public void disable()

Description copied from class: Component

Disable this component. Fires the Disable event.

Overrides:

disable in class Component

enable

public void enable()

Description copied from class: Component

Enable this component. Fires the Enable event.

Overrides:

enable in class Component

getDisplayField

public java.lang.String getDisplayField()

Returns the display field.

Returns:

the display field

getItemSelector

public java.lang.String getItemSelector()

Returns the item selector.

Returns:

the item selector

getListView

public ListView<D> getListView()

Returns the field's list view.

Returns:

the list view

getPropertyEditor

public ListModelPropertyEditor<D> getPropertyEditor()

Description copied from class: Field

Returns the field's property editor.

Overrides:

getPropertyEditor in class Field<D extends ModelData>

Returns:

the property editor

getRawValue

public java.lang.String getRawValue()

Description copied from class: Field

Returns the raw data value which may or may not be a valid, defined value. To return a normalized value see Field.getValue().

Overrides:

getRawValue in class Field<D extends ModelData>

Returns:

the raw value

getSelection

public java.util.List<D> getSelection()

Description copied from interface: SelectionProvider

Returns the current selection.

Specified by:

getSelection in interface SelectionProvider<D extends ModelData>

Returns:

the current selection

getStore

public ListStore<D> getStore()

Returns the field's store.

Returns:

the store

getTemplate

public XTemplate getTemplate()

Returns the custom template.

Returns:

the template

getValue

public D getValue()

Description copied from class: Field

Returns the typed value of the field.

Overrides:

getValue in class Field<D extends ModelData>

Returns:

the fields value

getValueField

public java.lang.String getValueField()

removeSelectionListener

public void removeSelectionListener(SelectionChangedListener<D> listener)

Description copied from interface: SelectionProvider

Removes a selection changed listener.

Specified by:

removeSelectionListener in interface SelectionProvider<D extends ModelData>

Parameters:

listener - a selection changed listener

setDisplayField

public void setDisplayField(java.lang.String displayField)

Sets the display field.

Parameters:

displayField - the display field

setItemSelector

public void setItemSelector(java.lang.String itemSelector)

This setting is required if a custom XTemplate has been specified.

Parameters:

itemSelector - the item selector

setPropertyEditor

public void setPropertyEditor(PropertyEditor<D> propertyEditor)

Description copied from class: Field

Sets the field's property editor which is used to translate typed values to string, and string values back to typed values.

Overrides:

setPropertyEditor in class Field<D extends ModelData>

Parameters:

propertyEditor - the property editor

setSelection

public void setSelection(java.util.List<D> selection)

Description copied from interface: SelectionProvider

Sets the current selection for this selection provider.

Specified by:

setSelection in interface SelectionProvider<D extends ModelData>

Parameters:

selection - the new selection

setStore

public void setStore(ListStore<D> store)

Sets the list field's list store.

Parameters:

store - the store

setTemplate

public void setTemplate(java.lang.String html)

Sets the field's template used to render the list.

Parameters:

html - the html frament

setTemplate

public void setTemplate(XTemplate template)

Sets the field's template used to render the list.

Parameters:

template -

setValueField

public void setValueField(java.lang.String valueField)

Sets the field's value field.

Parameters:

valueField - the value field