net.sf.jzeno.echo.databinding
Class DynaSelectField

java.lang.Object
  nextapp.echo.AbstractComponent
      net.sf.jzeno.echo.components.CustomComponent
          net.sf.jzeno.echo.databinding.DynaListBox
              net.sf.jzeno.echo.databinding.DynaSelectField

All Implemented Interfaces:

java.io.Serializable, java.util.EventListener, BindingTarget, ListBoxInterface, PropertyComponent, RebindableComponent, EventSink, EventSource, Precreation, CollectionChangeListener, Component, ActionListener, ListDataListener, ListSelectionListener, FastComponent, FastComponentContainer

public final class DynaSelectField
extends DynaListBox
implements FastComponent

Allows the user to select one or more items from a list of possible items. This list is visualized as a dropdown box. The items being diaplayed are a list of java beans (DynaListBox.setList(List)). Of those java beans you can specify a property that is shown to the user on the screen DynaListBox.setLabelProperty(String)). When the users has selected one or more from the possible options, the java beans from the original list that were selected will be written to the data binding target of this component.

You can configure this component to allow only a single selection, or to allow multiple selections (DynaListBox.setMultiSelect(boolean)- by default false ).

If you allow only one item to be selected, you should bind this component to a property of the type corresponding to the type of the java beans in the list of all possible items.

If on the other hand you do allow multiple selection, than this component should be bound to a property of type java.util.Collection .

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class net.sf.jzeno.echo.databinding.DynaListBox

DynaListBox.DefaultValidator

Field Summary

static long

serialVersionUID

Fields inherited from class net.sf.jzeno.echo.databinding.DynaListBox

cssClass, PERCENT_UNITS, PIXEL_UNITS

Fields inherited from interface nextapp.echo.Component

BACKGROUND_CHANGED_PROPERTY, CHILDREN_CHANGED_PROPERTY, ENABLED_CHANGED_PROPERTY, FONT_CHANGED_PROPERTY, FOREGROUND_CHANGED_PROPERTY, IDENTIFIER_CHANGED_PROPERTY, LOCALE_CHANGED_PROPERTY, MODEL_CHANGED_PROPERTY, SELECTABLE_CHANGED_PROPERTY, STYLE_BACKGROUND, STYLE_FONT, STYLE_FOREGROUND, UPDATE_PROPERTY, VISIBLE_CHANGED_PROPERTY

Constructor Summary

DynaSelectField()
Creates an unbound component.

DynaSelectField(java.lang.Class beanClass, java.lang.String property, java.lang.String constructionHints)
Creates a databound listbox.

Method Summary

Methods inherited from class net.sf.jzeno.echo.databinding.DynaListBox

actionPerformed, applyContext, changed, clearSelection, contentsChanged, getActionCommand, getBackground, getComparator, getCssClass, getDecorator, getFont, getForeground, getInvalidMessage, getInvalidMessageKey, getLabelProperty, getList, getModel, getNullLabel, getSelectedIndex, getSelectedItem, getSelectedLabels, getSelectedValue, getToolTipProperty, getToolTipText, getVisibleRowCount, getWidth, getWidthUnits, intervalAdded, intervalRemoved, isAsync, isDoubleClickActionCommand, isMultiSelect, isReadOnly, rebind, setActionCommand, setAsync, setBackground, setComparator, setCssClass, setDecorator, setDoubleClickActionCommand, setFocused, setFont, setForeground, setInvalidMessage, setInvalidMessageKey, setLabelProperty, setList, setMultiSelect, setNullLabel, setReadOnly, setRequired, setSelectedIndex, setSelectedLabels, setToolTipProperty, setToolTipText, setVisibleRowCount, setWidth, setWidthUnits, valueChanged

Methods inherited from class net.sf.jzeno.echo.components.CustomComponent

addValidator, fireActionEvent, fireActionEvent, fireActionEvent, getBean, getBeanClass, getNullObject, getProperty, getValidationErrors, getValidators, getValue, isBound, isMarkedInvalid, isRequired, isValid, markInvalid, markValid, preRender, removeValidator, setBean, setBeanClass, setNullObject, setProperty, setValue, traceValue, validate

Methods inherited from class nextapp.echo.AbstractComponent

add, add, addHierarchyListener, addPropertyChangeListener, applyStyle, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getClientId, getComponent, getComponentCount, getComponents, getEchoInstance, getIdentifier, getListenerList, getLocale, getParent, indexOf, init, isAncestorOf, isDifferent, isEnabled, isFocused, isRecursivelyVisible, isRegistered, isSelectableForScriptRecorder, isShowing, isVisible, processHierarchyEvent, remove, remove, removeAll, removeHierarchyListener, removePropertyChangeListener, setClientId, setEnabled, setIdentifier, setLocale, setParent, setRegistered, setSelectableForScriptRecorder, setVisible, update

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.sf.jzeno.echo.databinding.PropertyComponent

addValidator, getBean, getBeanClass, getProperty, getValidationErrors, getValidators, getValue, isMarkedInvalid, isRequired, isValid, markInvalid, markValid, preRender, removeValidator, setBean, setBeanClass, setProperty, setValue

Field Detail

serialVersionUID

public static final long serialVersionUID

See Also:

Constant Field Values

Constructor Detail

DynaSelectField

public DynaSelectField()

Creates an unbound component.

DynaSelectField

public DynaSelectField(java.lang.Class beanClass,
                       java.lang.String property,
                       java.lang.String constructionHints)

Creates a databound listbox. For the type of property you should bind to see the class documentation above. (DynaSelectField)