XdevComboBox (XDEV Application Framework 6.0.0 API)

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - javax.swing.JComponent
    - - javax.swing.JComboBox
      - xdev.ui.XdevComboBox

All Implemented Interfaces:

ActionListener, ImageObserver, ItemSelectable, MenuContainer, Serializable, EventListener, Accessible, ListDataListener, ExtendedList<XdevComboBox>, FormularComponent<XdevComboBox>, MasterDetailComponent<XdevComboBox>, VirtualTableOwner, XdevFocusCycleComponent

Direct Known Subclasses:

DetailEditor.DetailComboBox
```
@BeanSettings(useXdevCustomizer=true)
public class XdevComboBox
extends JComboBox
implements ExtendedList<XdevComboBox>, XdevFocusCycleComponent
```
The standard combobox in XDEV. Based on JComboBox.

Since:

2.0

Author:

XDEV Software

See Also:

JComboBox, FormularComponent, ItemListOwner, XdevFocusCycleComponent, MasterDetailComponent, Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class XdevComboBox.ItemListModelWrapper

protected class XdevComboBox.XdevComboBoxListCellRenderer
- Nested classes/interfaces inherited from class javax.swing.JComboBox
  JComboBox.AccessibleJComboBox, JComboBox.KeySelectionManager
- Nested classes/interfaces inherited from class javax.swing.JComponent
  JComponent.AccessibleJComponent
- Nested classes/interfaces inherited from class java.awt.Container
  Container.AccessibleAWTContainer
- Nested classes/interfaces inherited from class java.awt.Component
  Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
- Nested classes/interfaces inherited from interface xdev.ui.MasterDetailComponent
  MasterDetailComponent.DetailHandler
- Nested classes/interfaces inherited from interface xdev.ui.FormularComponent
  FormularComponent.ValueChangeListener

Nested Classes
Modifier and Type	Class and Description
`static class`	`XdevComboBox.ItemListModelWrapper`
`protected class`	`XdevComboBox.XdevComboBoxListCellRenderer`

Field Summary
- Fields inherited from class javax.swing.JComboBox
  actionCommand, dataModel, editor, isEditable, keySelectionManager, lightWeightPopupEnabled, maximumRowCount, renderer, selectedItemReminder
- Fields inherited from class javax.swing.JComponent
  listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
- Fields inherited from class java.awt.Component
  accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
- Fields inherited from interface xdev.ui.FormularComponent
  DATA_FIELD_SEPARATOR
- Fields inherited from interface xdev.ui.XdevFocusCycleComponent
  TAB_INDEX_PROPERTY
- Fields inherited from interface java.awt.image.ImageObserver
  ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors
Constructor and Description
`XdevComboBox()` Constructs a new `XdevComboBox`.
`XdevComboBox(ComboBoxModel model)` Constructs a `XdevComboBox` that is initialized with `ComboBoxModel` as the data model.
`XdevComboBox(ItemList il)` Constructs a `XdevComboBox` that is initialized with `ItemList` as the data model.

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addValidator(Validator validator)` Adds a validator to this component
`void`	`addValueChangeListener(FormularComponent.ValueChangeListener l)` Registers a `FormularComponent.ValueChangeListener`.
`void`	`clearModel()` Clears the underlying data model, mostly a `VirtualTable`, and the view.
`protected ListCellRenderer`	`createListCellRenderer()`
`void`	`doLayout()`
`String`	`getDataField()` Returns the name of the bound data field of this formular component.
`Color`	`getEvenBackground()` Returns the background `Color` of even rows.
`Operator`	`getFilterOperator()` Returns the operator used in `Formular.createCondition(String)`
`String`	`getFormularName()` Returns the name of the component in the formular context.
`Object`	`getFormularValue()` Returns the value of the component.
`ItemList`	`getItemList()` Returns the `ItemList`, that include the `item` and `data`.
`Color`	`getOddBackground()` Returns the background `Color` of odd rows.
`Dimension`	`getPreferredSize()`
`String`	`getPreSelectionValue()` Returns the string which is displayed before the user selects a value.
`Object`	`getSelectedData()` Returns the selected data.
`ItemList.Entry`	`getSelectedEntry()` Returns the selected `ItemList`-`ItemList.Entry`.
`int`	`getSelectedModelIndex()` Returns the modelindex of the selected item.
`VirtualTable.VirtualTableRow`	`getSelectedVirtualTableRow()` Returns the selected `VirtualTable.VirtualTableRow` of this component, or `null` if nothing is selected.
`Dimension`	`getSize()`
`int`	`getTabIndex()` Returns the tabindex assigned to this component.
`Validator[]`	`getValidators()` Returns all validators of this component.
`VirtualTable`	`getVirtualTable()` Returns the associated `VirtualTable` of this object.
`boolean`	`hasStateChanged()` Checks if the component's state since the last call of `FormularComponent.saveState()` has changed.
`protected boolean`	`isElementSelectable(Object item)`
`boolean`	`isMultiSelect()` Returns whether the component supports multi selection or not.
`boolean`	`isReadOnly()` Determines whether this component is only used to display values.
`boolean`	`isSomethingSelected()` Verify if a item is selected.
`ItemList`	`modelToItemList(ComboBoxModel model)` Create a new `ItemList` based on the provided `ComboBoxModel` .
`void`	`refresh()` Reloads the data from the underlying data source with the last executed resp.
`void`	`removeValidator(Validator validator)` Removes a validator from this component
`void`	`restoreState()` Restores the internally saved state of the component.
`void`	`saveState()` Saves the state of the component internally.
`void`	`setDataField(String dataField)` Sets the name of the bound data field of this formular component.
`void`	`setDetailHandler(MasterDetailComponent.DetailHandler detailHandler)` Sets the handler which controls the corporation of two `MasterDetailComponent`s.
`void`	`setEvenBackground(Color evenBackground)` Sets the background `Color` of even rows.
`void`	`setFilterOperator(Operator filterOperator)` Sets the filter operator used in `Formular.createCondition(String)`
`void`	`setFormularValue(VirtualTable vt, int col, Object value)` Deprecated.
`void`	`setFormularValue(VirtualTable vt, Map<String,Object> record)` Sets the value of the component, taking the value(s) of the record according to `FormularComponent.getDataField()`.
`void`	`setItemList(ItemList itemList)` Sets the `ItemList` that represents the contents or "value" of the `ExtendedList` and then clears the list's selection.
`void`	`setMasterValue(VirtualTable vt, Map<String,Object> record)` Sets the value of this component (master), taking the value(s) of the record.
`void`	`setModel(VirtualTable vt, String itemCol, String dataCol)` Updates the underlying model with data from the `VirtualTable` vt.
`void`	`setModel(VirtualTable vt, String itemCol, String dataCol, boolean queryData)` Updates the underlying model with data from the `VirtualTable` vt.
`void`	`setModel(VirtualTable vt, String itemCol, String dataCol, boolean queryData, boolean selectiveQuery)` Updates the underlying model with data from the `VirtualTable` vt.
`void`	`setOddBackground(Color oddBackground)` Sets the background `Color` of odd rows.
`void`	`setPreSelectionValue(String s)` Sets the value which is displayed before the user selects a value, e.g.
`void`	`setReadOnly(boolean readOnly)` Sets if this form component is only used to display values.
`void`	`setSelectedData(Object o)` Select the index of the first occurrence of the specified `o` in this list.
`void`	`setSelectedItem(Object anObject)`
`void`	`setSelectedModelIndex(int anIndex)` Selects the item at modelindex `anIndex`.
`void`	`setSelectedVirtualTableRow(VirtualTable.VirtualTableRow row)` Selects the row in the combo box if present.
`void`	`setTabIndex(int tabIndex)` Sets the tabindex of this component.
`void`	`setVirtualTable(VirtualTable vt)` Sets the `VirtualTable` containing the valid values for this component.
`String`	`toString()`
`void`	`updateModel(Condition condition, Object... params)` Reloads the data form the underlying data source.
`void`	`validateState()` Calls `Validator.validate(Object)` of all registered `Validator`s.
`void`	`validateState(Validation validation)` Calls `Validator.validate(Object)` of all registered `Validator`s.
`boolean`	`verify()` Returns whether the component's value adheres all set constraints.

Methods inherited from class javax.swing.JComboBox
actionPerformed, actionPropertyChanged, addActionListener, addItem, addItemListener, addPopupMenuListener, configureEditor, configurePropertiesFromAction, contentsChanged, createActionPropertyChangeListener, createDefaultKeySelectionManager, fireActionEvent, fireItemStateChanged, firePopupMenuCanceled, firePopupMenuWillBecomeInvisible, firePopupMenuWillBecomeVisible, getAccessibleContext, getAction, getActionCommand, getActionListeners, getEditor, getItemAt, getItemCount, getItemListeners, getKeySelectionManager, getMaximumRowCount, getModel, getPopupMenuListeners, getPrototypeDisplayValue, getRenderer, getSelectedIndex, getSelectedItem, getSelectedObjects, getUI, getUIClassID, hidePopup, insertItemAt, installAncestorListener, intervalAdded, intervalRemoved, isEditable, isLightWeightPopupEnabled, isPopupVisible, paramString, processKeyBinding, processKeyEvent, removeActionListener, removeAllItems, removeItem, removeItemAt, removeItemListener, removePopupMenuListener, selectedItemChanged, selectWithKeyChar, setAction, setActionCommand, setEditable, setEditor, setEnabled, setKeySelectionManager, setLightWeightPopupEnabled, setMaximumRowCount, setModel, setPopupVisible, setPrototypeDisplayValue, setRenderer, setSelectedIndex, setUI, showPopup, updateUI

Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface xdev.ui.FormularComponent
getClientProperty, isEnabled, isVisible, putClientProperty

- Constructor Detail
  - XdevComboBox
```
public XdevComboBox()
```
    Constructs a new XdevComboBox.
    
    See Also:
    
    XdevComboBox(ItemList)
  - XdevComboBox
```
public XdevComboBox(ItemList il)
```
    Constructs a XdevComboBox that is initialized with ItemList as the data model.
    
    Parameters:
    
    il - the ItemList that provides the displayed and data items
    
    See Also:
    
    setItemList(ItemList), JComboBox.setRenderer(javax.swing.ListCellRenderer)
  - XdevComboBox
```
public XdevComboBox(ComboBoxModel model)
```
    Constructs a XdevComboBox that is initialized with ComboBoxModel as the data model.
    
    Parameters:
    
    model - the ComboBoxModel with data
    
    See Also:
    
    JComboBox.setModel(ComboBoxModel), JComboBox.setRenderer(javax.swing.ListCellRenderer)
- Method Detail
  - isElementSelectable
```
protected boolean isElementSelectable(Object item)
```
  - createListCellRenderer
```
protected ListCellRenderer createListCellRenderer()
```
  - getItemList
```
public ItemList getItemList()
```
    Returns the ItemList, that include the item and data.
    
    Specified by:
    
    getItemList in interface ExtendedList<XdevComboBox>
    
    Returns:
    
    the ItemList of this ExtendedList
  - setItemList
```
public void setItemList(ItemList itemList)
```
    Sets the ItemList that represents the contents or "value" of the ExtendedList and then clears the list's selection.
    
    Specified by:
    
    setItemList in interface ExtendedList<XdevComboBox>
    
    Parameters:
    
    itemList - ItemList include the item and data
  - modelToItemList
```
public ItemList modelToItemList(ComboBoxModel model)
```
    Create a new ItemList based on the provided ComboBoxModel .
    
    Parameters:
    
    model - The data model
    
    Returns:
    
    a ItemList, the data are the model's values and the item's are the model's values as String.
  - setModel
```
public void setModel(VirtualTable vt,
                     String itemCol,
                     String dataCol)
```
    Updates the underlying model with data from the VirtualTable vt.
    This is a shortcut for setModel(vt,itemCol,dataCol,false)
    
    Specified by:
    
    setModel in interface ExtendedList<XdevComboBox>
    
    Parameters:
    
    vt - the VirtualTable containing the data for the model
    
    itemCol - columnname to fill item from or string with variables like "{%SURNAME} {%NAME} - {%AGE}"
    
    dataCol - column name to fill data from, or multiple columns names, comma-separated
    
    See Also:
    
    ItemList.setModel(VirtualTable, String, String), StringUtils.format(String, xdev.util.StringUtils.ParameterProvider)
  - setModel
```
public void setModel(VirtualTable vt,
                     String itemCol,
                     String dataCol,
                     boolean queryData)
```
    Updates the underlying model with data from the VirtualTable vt.
    
    Specified by:
    
    setModel in interface ExtendedList<XdevComboBox>
    
    Parameters:
    
    vt - the VirtualTable containing the data for the model
    
    itemCol - columnname to fill item from or string with variables like "{%SURNAME} {%NAME} - {%AGE}"
    
    dataCol - column name to fill data from, or multiple columns names, comma-separated
    
    queryData - if true, the best fitting select for this vt is used
    
    See Also:
    
    ItemList.setModel(VirtualTable, String, String, boolean), StringUtils.format(String, xdev.util.StringUtils.ParameterProvider)
  - setModel
```
public void setModel(VirtualTable vt,
                     String itemCol,
                     String dataCol,
                     boolean queryData,
                     boolean selectiveQuery)
```
    Updates the underlying model with data from the VirtualTable vt.
    
    Specified by:
    
    setModel in interface ExtendedList<XdevComboBox>
    
    Parameters:
    
    vt - the VirtualTable containing the data for the model
    
    itemCol - columnname to fill item from or string with variables like "{%SURNAME} {%NAME} - {%AGE}"
    
    dataCol - column name to fill data from, or multiple columns names, comma-separated
    
    queryData - if true, the best fitting select for this vt is used
    
    selectiveQuery - if true, only the used columns are queried
    
    See Also:
    
    ItemList.setModel(VirtualTable, String, String, boolean, boolean), StringUtils.format(String, xdev.util.StringUtils.ParameterProvider)
  - refresh
```
public void refresh()
```
    Reloads the data from the underlying data source with the last executed resp. default query.
    
    Specified by:
    
    refresh in interface MasterDetailComponent<XdevComboBox>
  - updateModel
```
public void updateModel(Condition condition,
                        Object... params)
```
    Reloads the data form the underlying data source.
    The last executed query is extended with condition.
    
    Specified by:
    
    updateModel in interface VirtualTableOwner
    
    Parameters:
    
    condition - The additional filter for the query
    
    params - param objects used in condition
  - clearModel
```
public void clearModel()
```
    Clears the underlying data model, mostly a VirtualTable, and the view.
    
    Specified by:
    
    clearModel in interface MasterDetailComponent<XdevComboBox>
  - setPreSelectionValue
```
public void setPreSelectionValue(String s)
```
    Sets the value which is displayed before the user selects a value, e.g. "- Select your country -".
    
    Parameters:
    
    s - the String to display in this XdevComboBox
  - getPreSelectionValue
```
public String getPreSelectionValue()
```
    Returns the string which is displayed before the user selects a value.
    
    Returns:
    
    the string which is displayed before the user selects a value.
  - setEvenBackground
```
public void setEvenBackground(Color evenBackground)
```
    Sets the background Color of even rows.
    
    Parameters:
    
    evenBackground - the background of even rows as Color.
  - getEvenBackground
```
public Color getEvenBackground()
```
    Returns the background Color of even rows.
    
    Returns:
    
    the background of even rows as Color.
  - setOddBackground
```
public void setOddBackground(Color oddBackground)
```
    Sets the background Color of odd rows.
    
    Parameters:
    
    oddBackground - the background of odd rows as Color.
  - getOddBackground
```
public Color getOddBackground()
```
    Returns the background Color of odd rows.
    
    Returns:
    
    the background of odd rows as Color.
  - isSomethingSelected
```
public boolean isSomethingSelected()
```
    Verify if a item is selected.
    
    Returns:
    
    true if a item is selected, otherwise false.
  - getSelectedData
```
public Object getSelectedData()
```
    Returns the selected data.
    
    Returns:
    
    the selected data, if no data is selected null
  - getSelectedModelIndex
```
public int getSelectedModelIndex()
```
    Returns the modelindex of the selected item.
    For example the index of the selected item in it is VirtualTable.
    
    Returns:
    
    an integer specifying the currently selected list item, where 0 specifies the first item in the list; or -1 if no item is selected or if the currently selected item is not in the list
  - setSelectedData
```
public void setSelectedData(Object o)
```
    Select the index of the first occurrence of the specified o in this list. If the ItemList of this XdevComboBox does not contain the o, the selection is canceled.
    
    Parameters:
    
    o - the Object to select
  - setSelectedItem
```
public void setSelectedItem(Object anObject)
```
    Overrides:
    
    setSelectedItem in class JComboBox
  - setSelectedModelIndex
```
public void setSelectedModelIndex(int anIndex)
```
    Selects the item at modelindex anIndex.
    For example the given index of an item in it is model VirtualTable .
    
    Parameters:
    
    anIndex - an integer specifying the list item to select, where 0 specifies the first item in the list and -1 indicates no selection
  - getSelectedEntry
```
public ItemList.Entry getSelectedEntry()
```
    Returns the selected ItemList-ItemList.Entry.
    
    Returns:
    
    the selected ItemList-ItemList.Entry
  - getFormularName
```
public String getFormularName()
```
    Returns the name of the component in the formular context.
    
    Specified by:
    
    getFormularName in interface FormularComponent<XdevComboBox>
    
    Returns:
    
    the name of the component in the formular context.
  - setDataField
```
public void setDataField(String dataField)
```
    Sets the name of the bound data field of this formular component.
    
    Specified by:
    
    setDataField in interface FormularComponent<XdevComboBox>
    
    Parameters:
    
    dataField - the new bound data field
    
    Since:
    
    3.1
  - getDataField
```
public String getDataField()
```
    Returns the name of the bound data field of this formular component.
    
    Specified by:
    
    getDataField in interface FormularComponent<XdevComboBox>
    
    Returns:
    
    the name of the bound data field
    
    Since:
    
    3.1
  - setFormularValue
```
@Deprecated
public void setFormularValue(VirtualTable vt,
                                         int col,
                                         Object value)
```
    Deprecated.
    
    Sets the value of the component according to the provided value value. The value is formatted using the column format of the provided VirtualTable and columnIndex.
    
    Specified by:
    
    setFormularValue in interface FormularComponent<XdevComboBox>
    
    Parameters:
    
    vt - VirtualTable to use the format from
    
    col - of the column to use the format from
    
    value - value to set
  - setFormularValue
```
public void setFormularValue(VirtualTable vt,
                             Map<String,Object> record)
```
    Sets the value of the component, taking the value(s) of the record according to FormularComponent.getDataField().
    
    Specified by:
    
    setFormularValue in interface FormularComponent<XdevComboBox>
    
    Parameters:
    
    vt - the underlying virtual table
    
    record - the data <column,value>
    
    Since:
    
    3.2
  - setMasterValue
```
public void setMasterValue(VirtualTable vt,
                           Map<String,Object> record)
```
    Sets the value of this component (master), taking the value(s) of the record.
    Called by the MasterDetailHandler if the client's value has changed.
    
    Specified by:
    
    setMasterValue in interface MasterDetailComponent<XdevComboBox>
    
    Parameters:
    
    vt - the underlying virtual table
    
    record - the data <column,value>
    
    Since:
    
    3.2
  - getFormularValue
```
public Object getFormularValue()
```
    Returns the value of the component.
    
    Specified by:
    
    getFormularValue in interface FormularComponent<XdevComboBox>
    
    Returns:
    
    the value of the component.
  - saveState
```
public void saveState()
```
    Saves the state of the component internally.
    A saved state can be restored using FormularComponent.restoreState().
    
    Specified by:
    
    saveState in interface FormularComponent<XdevComboBox>
  - restoreState
```
public void restoreState()
                  throws IllegalArgumentException
```
    Restores the internally saved state of the component.
    The state of the component can be saved using FormularComponent.saveState().
    
    Specified by:
    
    restoreState in interface FormularComponent<XdevComboBox>
    
    Throws:
    
    IllegalArgumentException
  - hasStateChanged
```
public boolean hasStateChanged()
```
    Checks if the component's state since the last call of FormularComponent.saveState() has changed.
    
    Specified by:
    
    hasStateChanged in interface FormularComponent<XdevComboBox>
    
    Returns:
    
    true if the component's state has changed, false otherwise
    
    Since:
    
    3.1
  - isMultiSelect
```
public boolean isMultiSelect()
```
    Returns whether the component supports multi selection or not.
    A component that supports multi selection can have more than one selected item / value.
    
    Specified by:
    
    isMultiSelect in interface FormularComponent<XdevComboBox>
    
    Returns:
    
    true if the component supports multi selection, false otherwise.
  - verify
```
public boolean verify()
```
    Returns whether the component's value adheres all set constraints.
    This is a alternative method for FormularComponent.validateState(), but this method returns a boolean depending on the validation's result and doesn't throw an ValidationException.
    
    Specified by:
    
    verify in interface FormularComponent<XdevComboBox>
    
    Returns:
    
    true if the value of the component adheres all set constraints; otherwise false.
  - addValidator
```
public void addValidator(Validator validator)
```
    Adds a validator to this component
    
    Specified by:
    
    addValidator in interface FormularComponent<XdevComboBox>
    
    Parameters:
    
    validator - the validator to add
    
    Since:
    
    3.1
    
    See Also:
    
    FormularComponent.validateState()
  - removeValidator
```
public void removeValidator(Validator validator)
```
    Removes a validator from this component
    
    Specified by:
    
    removeValidator in interface FormularComponent<XdevComboBox>
    
    Parameters:
    
    validator - the validator to remove
    
    Since:
    
    3.1
    
    See Also:
    
    FormularComponent.validateState()
  - getValidators
```
public Validator[] getValidators()
```
    Returns all validators of this component.
    If no validator is present an empty array is returned.
    
    Specified by:
    
    getValidators in interface FormularComponent<XdevComboBox>
    
    Returns:
    
    all validators of this component
    
    Since:
    
    3.1
  - validateState
```
public void validateState()
                   throws ValidationException
```
    Calls Validator.validate(Object) of all registered Validators.
    
    Specified by:
    
    validateState in interface FormularComponent<XdevComboBox>
    
    Throws:
    
    ValidationException
    
    Since:
    
    3.1
    
    See Also:
    
    FormularComponent.verify()
  - validateState
```
public void validateState(Validation validation)
                   throws ValidationException
```
    Calls Validator.validate(Object) of all registered Validators.
    Every ValidationException is recorded in the validation object, and if Validation.continueValidation(ValidationException) returns false this exception is re-thrown by this method.
    
    Specified by:
    
    validateState in interface FormularComponent<XdevComboBox>
    
    Parameters:
    
    validation - the validation process object
    
    Throws:
    
    ValidationException
    
    Since:
    
    3.1
    
    See Also:
    
    FormularComponent.verify()
  - setFilterOperator
```
public void setFilterOperator(Operator filterOperator)
```
    Sets the filter operator used in Formular.createCondition(String)
    
    Specified by:
    
    setFilterOperator in interface FormularComponent<XdevComboBox>
    
    Parameters:
    
    filterOperator - the new filter operator
    
    Since:
    
    3.1
  - getFilterOperator
```
public Operator getFilterOperator()
```
    Returns the operator used in Formular.createCondition(String)
    
    Specified by:
    
    getFilterOperator in interface FormularComponent<XdevComboBox>
    
    Returns:
    
    the component's filter operator
    
    Since:
    
    3.1
  - setReadOnly
```
public void setReadOnly(boolean readOnly)
```
    Sets if this form component is only used to display values.
    
    Specified by:
    
    setReadOnly in interface FormularComponent<XdevComboBox>
    
    Parameters:
    
    readOnly - true to only display values
    
    Since:
    
    3.2
  - isReadOnly
```
public boolean isReadOnly()
```
    Determines whether this component is only used to display values.
    
    Specified by:
    
    isReadOnly in interface FormularComponent<XdevComboBox>
    
    Returns:
    
    true if this component is only used to display values.
    
    Since:
    
    3.2
  - setVirtualTable
```
public void setVirtualTable(VirtualTable vt)
```
    Sets the VirtualTable containing the valid values for this component.
    
    Specified by:
    
    setVirtualTable in interface VirtualTableOwner
    
    Since:
    
    4.0
  - getVirtualTable
```
public VirtualTable getVirtualTable()
```
    Returns the associated VirtualTable of this object.
    
    Specified by:
    
    getVirtualTable in interface VirtualTableOwner
    
    Returns:
    
    The associated VirtualTable of this object.
  - getSelectedVirtualTableRow
```
public VirtualTable.VirtualTableRow getSelectedVirtualTableRow()
```
    Returns the selected VirtualTable.VirtualTableRow of this component, or null if nothing is selected.
    
    Specified by:
    
    getSelectedVirtualTableRow in interface MasterDetailComponent<XdevComboBox>
    
    Returns:
    
    the selected VirtualTable.VirtualTableRow of this component
  - setSelectedVirtualTableRow
```
public void setSelectedVirtualTableRow(VirtualTable.VirtualTableRow row)
```
    Selects the row in the combo box if present.
    
    Parameters:
    
    row - the row to select
    
    Since:
    
    3.2
  - addValueChangeListener
```
public void addValueChangeListener(FormularComponent.ValueChangeListener l)
```
    Registers a FormularComponent.ValueChangeListener.
    
    Specified by:
    
    addValueChangeListener in interface FormularComponent<XdevComboBox>
    
    Parameters:
    
    l - the listener to register
  - setDetailHandler
```
public void setDetailHandler(MasterDetailComponent.DetailHandler detailHandler)
```
    Sets the handler which controls the corporation of two MasterDetailComponents.
    
    Specified by:
    
    setDetailHandler in interface MasterDetailComponent<XdevComboBox>
    
    Parameters:
    
    detailHandler - the new MasterDetailComponent.DetailHandler
  - getPreferredSize
```
public Dimension getPreferredSize()
```
    Overrides:
    
    getPreferredSize in class JComponent
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Component
  - getTabIndex
```
public int getTabIndex()
```
    Returns the tabindex assigned to this component. The tabindex defines the position of the component in the focus cycle.
    
    Specified by:
    
    getTabIndex in interface XdevFocusCycleComponent
    
    Returns:
    
    tabindex of this component
  - setTabIndex
```
public void setTabIndex(int tabIndex)
```
    Sets the tabindex of this component. The tabindex defines the position of the component in the focus cycle.
    To exclude this component from the focus cycle set tabindex to -1.
    
    Specified by:
    
    setTabIndex in interface XdevFocusCycleComponent
    
    Parameters:
    
    tabIndex - to be set
  - doLayout
```
public void doLayout()
```
    Overrides:
    
    doLayout in class Container
  - getSize
```
public Dimension getSize()
```
    Overrides:
    
    getSize in class Component

Class XdevComboBox

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JComboBox

Nested classes/interfaces inherited from class javax.swing.JComponent

Nested classes/interfaces inherited from class java.awt.Container

Nested classes/interfaces inherited from class java.awt.Component

Nested classes/interfaces inherited from interface xdev.ui.MasterDetailComponent

Nested classes/interfaces inherited from interface xdev.ui.FormularComponent

Field Summary

Fields inherited from class javax.swing.JComboBox

Fields inherited from class javax.swing.JComponent

Fields inherited from class java.awt.Component

Fields inherited from interface xdev.ui.FormularComponent

Fields inherited from interface xdev.ui.XdevFocusCycleComponent

Fields inherited from interface java.awt.image.ImageObserver

Constructor Summary

Method Summary

Methods inherited from class javax.swing.JComboBox

Methods inherited from class javax.swing.JComponent

Methods inherited from class java.awt.Container

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

Methods inherited from interface xdev.ui.FormularComponent

Constructor Detail

XdevComboBox

XdevComboBox

XdevComboBox

Method Detail

isElementSelectable

createListCellRenderer

getItemList

setItemList

modelToItemList

setModel

setModel

setModel

refresh

updateModel

clearModel

setPreSelectionValue

getPreSelectionValue

setEvenBackground

getEvenBackground

setOddBackground

getOddBackground

isSomethingSelected

getSelectedData

getSelectedModelIndex

setSelectedData

setSelectedItem

setSelectedModelIndex

getSelectedEntry

getFormularName

setDataField

getDataField

setFormularValue

setFormularValue

setMasterValue

getFormularValue

saveState

restoreState

hasStateChanged

isMultiSelect

verify

addValidator

removeValidator

getValidators

validateState

validateState

setFilterOperator

getFilterOperator

setReadOnly

isReadOnly

setVirtualTable

getVirtualTable

getSelectedVirtualTableRow

setSelectedVirtualTableRow

addValueChangeListener

setDetailHandler

getPreferredSize