FComboBox (MyTISM API Documentation)

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - javax.swing.JComponent
    - - javax.swing.JPanel
      - de.ipcon.swing.IPanel
        
        de.ipcon.form.FPanel
        
        de.ipcon.form.FInputPanel
        
        de.ipcon.form.FComboBox

All Implemented Interfaces:

AsyncRefreshExecutorI, FormElementI, FormElementWithDisplayPropertyI, FormInputPanelMandatoryI, InitialFocusCandidateI, de.ipcon.swing.FocusVetoHandlerI, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible, javax.swing.Scrollable
```
public class FComboBox
extends FInputPanel
implements InitialFocusCandidateI, FormElementWithDisplayPropertyI, AsyncRefreshExecutorI
```
A graphical user interface (GUI) input element for both relation and scalar attributes. The FComboBox class provides a configurable combo box that can be populated from various data sources, including existing business object (BO) relations, database queries, or a custom Groovy script. It is designed to handle the complexities of both object-based (relation) and value-based (scalar) attributes.
Configuration Syntax
The behavior and data source of the combo box are defined by its XML configuration.
For Relation Attributes (where "TheAttribute" is a relation)
- Populating from an existing relation:
```
 <ComboBox property="TheAttribute" selectOutOf="SomeRelationAttributeOfTheCurrentBO" [format="Bezeichnung' blablabla '(Bemerkung)"] [sortBy="SomeAttribute"]/>
```
  All BOs from the "selectOutOf" relation are used as options. They are formatted according to the "format" string and sorted by "sortBy". When an item is selected, the "TheAttribute" property is set to the corresponding BO. The list is automatically updated if the source relation changes.
- Populating from a database query:
```
 <ComboBox property="TheAttribute" [selectEntity="SomeAssignableEntity"] whereClause="Name = 'bla' AND NOT Ldel" [format="Bezeichnung' blablabla '(Bemerkung)"] [sortBy="SomeAttribute"]/>
```
  The combo box options are populated by executing an Object Query Language (OQL) query on the specified "selectEntity", filtered by the "whereClause". The results are formatted and sorted as specified. The list is re-queried and updated on every refresh.
- Populating from a Groovy script:
```
 <ComboBox property="TheAttribute"><choiceScript>// A Groovy script which gets some values and adds them with model.addEntry(value)</choiceScript></ComboBox>
```
  A custom Groovy script is evaluated on each refresh to dynamically populate the combo box's options. This provides maximum flexibility for complex data sourcing.
For Scalar Attributes (where "TheAttribute" is a scalar)
- Populating from an existing relation:
```
 <ComboBox property="TheAttribute" selectOutOf="SomeRelationAttributeOfTheCurrentBO" [format="Bezeichnung' blablabla '(Bemerkung)"] [sortBy="SomeAttribute"]/>
```
  Similar to the relation syntax, but the value for "TheAttribute" is set using the string representation of the selected entry, which is then converted to the attribute's type using "TheAttribute.getType().stringToValue(...)".
- Populating from a database query:
```
 <ComboBox property="TheAttribute" [selectEntity="SomeEntity"] whereClause="Name = 'bla' AND NOT Ldel" [format="Bezeichnung' blablabla '(Bemerkung)"] [sortBy="SomeAttribute"]/>
```
  The options are populated from a database query. The selected entry's string value is converted to the scalar attribute's type.
- Populating from a Groovy script:
```
 <ComboBox property="TheAttribute"><choiceScript>// A Groovy script which gets some values and adds them with model.addEntry(value)</choiceScript></ComboBox>
```
  A custom Groovy script provides the values. The selected value is then converted to the scalar attribute's type.
Optional Attributes
- nullable: A boolean attribute. If true, a special null entry is automatically added to the combo box.
- nullChoiceTitle: A string attribute that sets the label for the null entry when "nullable" is true. An empty string is used if not provided.
- autoSelect: A string attribute. If "TheAttribute" is initially null, the entry with a value matching this string will be automatically selected. The value is a "TheAttribute.getType().stringToValue(...)" compatible representation.
Script Variables
The "choiceScript" has access to the following variables:
- fe: The FormElementI instance for this combo box.
- property: The name of the property as a String.
- bol: The BOLoaderI of the form's context.
- model: The AbstractModel instance used to populate the combo box. Use "model.addEntry(value)" to add options.
See Also:

Serialized Form

Nested Class Summary
- Nested classes/interfaces inherited from class javax.swing.JComponent
  javax.swing.JComponent.AccessibleJComponent
- Nested classes/interfaces inherited from class java.awt.Component
  java.awt.Component.BaselineResizeBehavior

Field Summary
- Fields inherited from class de.ipcon.form.FInputPanel
  myActions
- Fields inherited from class de.ipcon.form.FPanel
  XMLConfigureInfo
- Fields inherited from class de.ipcon.swing.IPanel
  inhibitFocusChange, SCROLLING_MODE_ANY, SCROLLING_MODE_HORIZONTAL_ONLY, SCROLLING_MODE_VERTICAL_ONLY, TEXTURE_CENTERED, TEXTURE_REPEAT
- Fields inherited from class javax.swing.JComponent
  TOOL_TIP_TEXT_KEY, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
- Fields inherited from class java.awt.Component
  BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
- Fields inherited from interface de.ipcon.form.FormElementI
  ALL_ACTIONS, AVAILABLE_ACTION_KIND, CONTEXTMENU_ACTION_KIND, LOCAL_ACTION_KIND, MENU_ACTION_KIND, NO_LOCAL_ACTION_KIND, NO_TOPMDI_ONLY_ACTION_KIND, NOT_AVAILABLE_ACTION_KIND, REFRESH_FROM_TRANSACTION, REFRESH_FROM_USER, SHORTCUT_ACTION_KIND, TOOLBAR_ACTION_KIND, TOPMDI_ONLY_ACTION_KIND
- Fields inherited from interface java.awt.image.ImageObserver
  ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors
Constructor and Description

FComboBox(FormContextI _ftx, electric.xml.Element _confroot)

Constructors
Constructor and Description
`FComboBox(FormContextI _ftx, electric.xml.Element _confroot)`

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`buildGUI()`
`java.lang.Object`	`calculateDisplayValue(AsyncRefreshRequestI r)` Calculates a display value for an asynchronous refresh request.
`boolean`	`calculationMightBeExpensive()`
`void`	`close()`
`void`	`disable()` Deprecated.
`void`	`enable()` Deprecated.
`java.util.HashMap`	`getAttributeMap()` Returns the map of attributes supported by this component.
`java.lang.String`	`getAutoSelect()`
`electric.xml.Element`	`getChoiceScriptEl()`
`java.lang.String`	`getDisplayProperty()`
`java.util.HashMap`	`getElementMap()` Returns the map of elements supported by this component.
`java.lang.String`	`getFormat()`
`javax.swing.JComponent`	`getInitialFocus()`
`javax.swing.JComponent`	`getJComponent()` Returns the "JComponent" associated with this form element.
`java.lang.String`	`getNullChoiceTitle()`
`java.awt.Dimension`	`getPreferredSize()`
`java.lang.String`	`getProperty()` A private, immutable container for passing the mandatory and enabled state of a component's display value between asynchronous operations.
`java.lang.String`	`getSelectEntity()`
`java.lang.String`	`getSelectOutOf()`
`java.lang.String`	`getSortBy()`
`java.lang.String`	`getWhereClause()`
`void`	`handleAutoSelectA(electric.xml.Attribute a)`
`void`	`handleChoiceScriptE(electric.xml.Element el)`
`void`	`handleChooseOnlyA(electric.xml.Attribute a)`
`void`	`handleDisplayFormatA(electric.xml.Attribute a)`
`void`	`handleDisplayPropertyA(electric.xml.Attribute a)`
`void`	`handleFormatA(electric.xml.Attribute a)`
`void`	`handleNullableA(electric.xml.Attribute a)`
`void`	`handleNullChoiceTitleA(electric.xml.Attribute a)`
`void`	`handlePropertyA(electric.xml.Attribute a)`
`void`	`handleRelationNameA(electric.xml.Attribute a)`
`void`	`handleSelectEntityA(electric.xml.Attribute a)`
`void`	`handleSelectOutOfA(electric.xml.Attribute a)`
`void`	`handleShowIdA(electric.xml.Attribute a)`
`void`	`handleSortByA(electric.xml.Attribute a)`
`void`	`handleSuppressDuplicatesInNonRelationModeA(electric.xml.Attribute a)`
`void`	`handleWhereClauseA(electric.xml.Attribute a)`
`boolean`	`isChooseOnly()`
`boolean`	`isShowId()`
`boolean`	`isSuppressDuplicatesInNonRelationMode()`
`void`	`lockDisplayValue()` Locks the UI component that displays the value to prevent concurrent inputs during async refresh operations.
`void`	`refresh(int from)`
`void`	`renderDisplayValue(AsyncRefreshRequestI r, java.lang.Object value)` Renders the calculated value on the UI.
`void`	`restoreLockstateOfDisplayValue()` Unlocks the UI component that displays the value again.
`void`	`setAutoSelect(java.lang.String $6)`
`void`	`setChoiceScriptEl(electric.xml.Element $11)`
`void`	`setChooseOnly(boolean $12)`
`boolean`	`setEditable(boolean b)`
`void`	`setEnabled()`
`void`	`setEnabled(boolean b)`
`void`	`setFormat(java.lang.String $4)`
`void`	`setNullChoiceTitle(java.lang.String $9)`
`void`	`setProperty(java.lang.String $3)`
`void`	`setSelectedItem(java.lang.Object _obj)`
`void`	`setSelectEntity(java.lang.String $10)`
`void`	`setSelectOutOf(java.lang.String $7)`
`void`	`setShowId(boolean $13)`
`void`	`setSortBy(java.lang.String $8)`
`void`	`setSuppressDuplicatesInNonRelationMode(boolean $14)`
`void`	`setWhereClause(java.lang.String $5)`
`void`	`syncImpl()`

Methods inherited from class de.ipcon.form.FInputPanel
calculateMandatory, getAlsoMandatoryIf, getBaseline, getDefaultActionMap, handleAlsoMandatoryIfE

Methods inherited from class de.ipcon.form.FPanel
_refreshActions, action_editForm_available, action_editForm_enabled, action_editForm, action_refreshView_available, action_refreshView, action_reopenView_available, action_reopenView_enabled, action_reopenView, addBeanA, addFormElementListener, addHandleA, addHandleE, afterSave, afterSetValue, assureTransferHandler, beforeSave, beforeSetValue, callLog, cancelPendingRefreshRequests, checkEditable, checkVisible, evalScript, evalScript, evalScript, evalScript, evalScript, fhide, focusNextComponent, focusPreviousComponent, fshow, getActions, getActionsOfKind, getActionsOfKind, getBO, getConfRoot, getCtx, getDebugName, getFormActions, getFtx, getInstrumentedSchema, getLastRefreshRequest, getMaximumSize, getMinimumSize, getMissingPropertiesPolicy, getRefreshRequestsPending, getSchema, handleActionE, handleAttributes, handleDropAllowedIfE, handleEditableA, handleEditableIfE, handleElement, handleElements, handleElements, handleElements, handleImpliedA, handleMaximumSizeA, handleMaxSizeA, handleMinimumSizeA, handleMinSizeA, handleMissingPropertiesPolicyA, handleNameA, handleNewElement, handleNewElement, handleNewElement, handleOnAfterSaveE, handleOnAfterSetValueE, handleOnBeforeSaveE, handleOnBeforeSetValueE, handleOnConstructionE, handleOnDropE, handleOnFocusGainedE, handleOnFocusLostE, handleOnMDIActivateE, handleOnMDICloseE, handleOnMDIDeactivateE, handleOnMDIOpenE, handleOnRefreshE, handleOnSyncE, handlePreferredSizeA, handlePrefSizeA, handleScriptE, handleVirtualPropertyE, handleVisibleIfE, hasPreferredSizeOverride, invokeAction, invokeAction, isClosed, isDebug, isDefinedEditable, isEditable, isExplicitEditable, isGUIBuilt, isImpliedElement, isInputPossible, isShown, mdiActivate, mdiClose, mdiDeactivate, mdiOpen, postConstructor, postInit, postRefresh, postRefresh, postRefresh, processFocusVeto, processFocusVeto, queueDelayedRefresh, queueDelayedRefresh, reallyHandleVirtualPropertyE, refresh, refreshActions, refreshActions, registerActionImpl, registerFormAction, removeFormElementListener, requestFocus, requestFocusInWindow, requestFocusInWindow, runAndDeclare, runAndDeclare, setConfRoot, setDebug, setFtx, setGUIBuilt, setMissingPropertiesPolicy, setShown, shouldShow, sync, waitForAsyncRefreshes, willCareForChildActions, willCareForChildRefresh

Methods inherited from class de.ipcon.swing.IPanel
getPreferredScrollableViewportSize, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getScrollableUnitIncrement, getScrollingMode, grabFocus, init, init, init, paintComponent, setScrollingMode, setTexture

Methods inherited from class javax.swing.JPanel
getAccessibleContext, getUI, getUIClassID, setUI, updateUI

Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, firePropertyChange, firePropertyChange, firePropertyChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintImmediately, paintImmediately, print, printAll, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, 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, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, 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, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate

Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, contains, createImage, createImage, createVolatileImage, createVolatileImage, dispatchEvent, enable, enableInputMethods, 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, getSize, 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, 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, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

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

Methods inherited from interface de.ipcon.form.FormElementI
addFormElementListener, afterSave, afterSetValue, beforeSave, beforeSetValue, getActions, getActionsOfKind, getConfRoot, getCtx, getDebugName, getFtx, getName, getSchema, handleAttributes, handleElement, handleElements, handleNewElement, isClosed, isDebug, isEditable, isGUIBuilt, isInputPossible, isShown, mdiActivate, mdiClose, mdiDeactivate, mdiOpen, postInit, postRefresh, refresh, removeFormElementListener, requestFocus, sync, toDebugName, willCareForChildActions, willCareForChildRefresh

- Constructor Detail
  - FComboBox
```
public FComboBox(FormContextI _ftx,
                 electric.xml.Element _confroot)
```
- Method Detail
  - close
```
public void close()
```
    Specified by:
    
    close in interface FormElementI
    
    Overrides:
    
    close in class FPanel
  - buildGUI
```
public void buildGUI()
```
  - handleRelationNameA
```
public void handleRelationNameA(electric.xml.Attribute a)
```
  - handlePropertyA
```
public void handlePropertyA(electric.xml.Attribute a)
```
  - handleDisplayPropertyA
```
public void handleDisplayPropertyA(electric.xml.Attribute a)
```
  - handleDisplayFormatA
```
public void handleDisplayFormatA(electric.xml.Attribute a)
```
  - handleFormatA
```
public void handleFormatA(electric.xml.Attribute a)
```
  - handleWhereClauseA
```
public void handleWhereClauseA(electric.xml.Attribute a)
```
  - handleAutoSelectA
```
public void handleAutoSelectA(electric.xml.Attribute a)
```
  - handleSelectOutOfA
```
public void handleSelectOutOfA(electric.xml.Attribute a)
```
  - handleNullableA
```
public void handleNullableA(electric.xml.Attribute a)
```
  - handleSortByA
```
public void handleSortByA(electric.xml.Attribute a)
```
  - handleChooseOnlyA
```
public void handleChooseOnlyA(electric.xml.Attribute a)
```
  - handleShowIdA
```
public void handleShowIdA(electric.xml.Attribute a)
```
  - handleSuppressDuplicatesInNonRelationModeA
```
public void handleSuppressDuplicatesInNonRelationModeA(electric.xml.Attribute a)
```
  - handleNullChoiceTitleA
```
public void handleNullChoiceTitleA(electric.xml.Attribute a)
```
  - handleSelectEntityA
```
public void handleSelectEntityA(electric.xml.Attribute a)
```
  - handleChoiceScriptE
```
public void handleChoiceScriptE(electric.xml.Element el)
```
  - getAttributeMap
```
public java.util.HashMap getAttributeMap()
```
    Description copied from class: FInputPanel
    
    Returns the map of attributes supported by this component.
    
    Specified by:
    
    getAttributeMap in interface FormElementI
    
    Overrides:
    
    getAttributeMap in class FInputPanel
    
    Returns:
    
    The attribute map.
  - getElementMap
```
public java.util.HashMap getElementMap()
```
    Description copied from class: FInputPanel
    
    Returns the map of elements supported by this component.
    
    Specified by:
    
    getElementMap in interface FormElementI
    
    Overrides:
    
    getElementMap in class FInputPanel
    
    Returns:
    
    The element map.
  - calculationMightBeExpensive
```
public boolean calculationMightBeExpensive()
```
    Overrides:
    
    calculationMightBeExpensive in class FPanel
  - refresh
```
public void refresh(int from)
```
    Specified by:
    
    refresh in interface FormElementI
    
    Overrides:
    
    refresh in class FPanel
  - calculateDisplayValue
```
public java.lang.Object calculateDisplayValue(AsyncRefreshRequestI r)
```
    Description copied from interface: AsyncRefreshExecutorI
    
    Calculates a display value for an asynchronous refresh request. Possibly also calculates some internal settings for the component. This method is intended to be executed on a background thread to perform a potentially long-running or resource-intensive calculation without blocking the UI. Therefore it must not run on the EDT thread and must not directly modify the GUI. The returned object is the raw, non-rendered value that will be passed to the renderDisplayValue method.
    
    Specified by:
    
    calculateDisplayValue in interface AsyncRefreshExecutorI
    
    Parameters:
    
    r - The refresh request containing all necessary context and data for the calculation.
    
    Returns:
    
    The calculated value, which can be any Object.
  renderDisplayValue
  
  public void renderDisplayValue(AsyncRefreshRequestI r, java.lang.Object value)
  
  Description copied from interface: AsyncRefreshExecutorI
  
  Renders the calculated value on the UI. This method is executed on the EDT thread (the Event Dispatch Thread in Swing) and is responsible for safely updating the visual component with the provided value. This ensures that UI modifications happen in a thread-safe manner.
  
  Specified by:
  
  renderDisplayValue in interface AsyncRefreshExecutorI
  
  Parameters:
  
  r - The original refresh request.
  
  value - The raw Object value returned by the calculateDisplayValue method, or a caught Exception.
  
  lockDisplayValue
  
  public void lockDisplayValue()
  
  Description copied from interface: AsyncRefreshExecutorI
  
  Locks the UI component that displays the value to prevent concurrent inputs during async refresh operations. This method is called before the background calculation begins. It should lock or disable the relevant UI component to prevent the user from interacting with it while it is being updated, thereby avoiding inconsistent state or unexpected behavior.
  
  Specified by:
  
  lockDisplayValue in interface AsyncRefreshExecutorI
  
  restoreLockstateOfDisplayValue
  
  public void restoreLockstateOfDisplayValue()
  
  Description copied from interface: AsyncRefreshExecutorI
  
  Unlocks the UI component that displays the value again. This method is called after the value has been rendered. It is responsible for restoring the UI component's state to its original, unlocked state.
  
  Specified by:
  
  restoreLockstateOfDisplayValue in interface AsyncRefreshExecutorI
  
  getDisplayProperty
  
  public java.lang.String getDisplayProperty()
  
  Specified by:
  
  getDisplayProperty in interface FormElementWithDisplayPropertyI
  
  getPreferredSize
  
  public java.awt.Dimension getPreferredSize()
  
  Overrides:
  
  getPreferredSize in class FPanel
  
  setEditable
  
  public boolean setEditable(boolean b)
  
  Specified by:
  
  setEditable in interface FormElementI
  
  Overrides:
  
  setEditable in class FPanel
  
  setEnabled
  
  public void setEnabled()
  
  setEnabled
  
  public void setEnabled(boolean b)
  
  Overrides:
  
  setEnabled in class javax.swing.JComponent
  
  disable
  
  @Deprecated public void disable()
  
  Deprecated.
  
  Overrides:
  
  disable in class javax.swing.JComponent
  
  enable
  
  @Deprecated public void enable()
  
  Deprecated.
  
  Overrides:
  
  enable in class javax.swing.JComponent
  
  getInitialFocus
  
  public javax.swing.JComponent getInitialFocus()
  
  Specified by:
  
  getInitialFocus in interface InitialFocusCandidateI
  
  getJComponent
  
  public javax.swing.JComponent getJComponent()
  
  Description copied from class: FInputPanel
  
  Returns the "JComponent" associated with this form element.
  
  Specified by:
  
  getJComponent in class FInputPanel
  
  Returns:
  
  The "JComponent" of this form element.
  
  syncImpl
  
  public void syncImpl()
  
  Overrides:
  
  syncImpl in class FPanel
  
  setSelectedItem
  
  public void setSelectedItem(java.lang.Object _obj)
  
  getProperty
  
  public java.lang.String getProperty()
  
  A private, immutable container for passing the mandatory and enabled state of a component's display value between asynchronous operations. This wrapper is designed to safely transfer state information from a background thread (e.g. in a #calculateDisplayValue method) to the UI thread (in a #renderDisplayValue method). By wrapping the "mandatory" and "enabled" booleans, it prevents race conditions and ensures that the UI component is updated with the correct state after its value has been calculated.
  
  setProperty
  
  public void setProperty(java.lang.String $3)
  
  getFormat
  
  public java.lang.String getFormat()
  
  setFormat
  
  public void setFormat(java.lang.String $4)
  
  getWhereClause
  
  public java.lang.String getWhereClause()
  
  setWhereClause
  
  public void setWhereClause(java.lang.String $5)
  
  getAutoSelect
  
  public java.lang.String getAutoSelect()
  
  setAutoSelect
  
  public void setAutoSelect(java.lang.String $6)
  
  getSelectOutOf
  
  public java.lang.String getSelectOutOf()
  
  setSelectOutOf
  
  public void setSelectOutOf(java.lang.String $7)
  
  getSortBy
  
  public java.lang.String getSortBy()
  
  setSortBy
  
  public void setSortBy(java.lang.String $8)
  
  getNullChoiceTitle
  
  public java.lang.String getNullChoiceTitle()
  
  setNullChoiceTitle
  
  public void setNullChoiceTitle(java.lang.String $9)
  
  getSelectEntity
  
  public java.lang.String getSelectEntity()
  
  setSelectEntity
  
  public void setSelectEntity(java.lang.String $10)
  
  getChoiceScriptEl
  
  public electric.xml.Element getChoiceScriptEl()
  
  setChoiceScriptEl
  
  public void setChoiceScriptEl(electric.xml.Element $11)
  
  isChooseOnly
  
  public boolean isChooseOnly()
  
  setChooseOnly
  
  public void setChooseOnly(boolean $12)
  
  isShowId
  
  public boolean isShowId()
  
  setShowId
  
  public void setShowId(boolean $13)
  
  isSuppressDuplicatesInNonRelationMode
  
  public boolean isSuppressDuplicatesInNonRelationMode()
  
  setSuppressDuplicatesInNonRelationMode
  
  public void setSuppressDuplicatesInNonRelationMode(boolean $14)

Class FComboBox

Configuration Syntax

For Relation Attributes (where "TheAttribute" is a relation)

For Scalar Attributes (where "TheAttribute" is a scalar)

Optional Attributes

Script Variables

Nested Class Summary

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

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

Field Summary

Fields inherited from class de.ipcon.form.FInputPanel

Fields inherited from class de.ipcon.form.FPanel

Fields inherited from class de.ipcon.swing.IPanel

Fields inherited from class javax.swing.JComponent

Fields inherited from class java.awt.Component

Fields inherited from interface de.ipcon.form.FormElementI

Fields inherited from interface java.awt.image.ImageObserver

Constructor Summary

Method Summary

Methods inherited from class de.ipcon.form.FInputPanel

Methods inherited from class de.ipcon.form.FPanel

Methods inherited from class de.ipcon.swing.IPanel

Methods inherited from class javax.swing.JPanel

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 de.ipcon.form.FormElementI

Constructor Detail

FComboBox

Method Detail

close

buildGUI

handleRelationNameA

handlePropertyA

handleDisplayPropertyA

handleDisplayFormatA

handleFormatA

handleWhereClauseA

handleAutoSelectA

handleSelectOutOfA

handleNullableA

handleSortByA

handleChooseOnlyA

handleShowIdA

handleSuppressDuplicatesInNonRelationModeA

handleNullChoiceTitleA

handleSelectEntityA

handleChoiceScriptE

getAttributeMap

getElementMap

calculationMightBeExpensive

refresh

calculateDisplayValue

renderDisplayValue

lockDisplayValue

restoreLockstateOfDisplayValue

getDisplayProperty

getPreferredSize

setEditable

setEnabled

setEnabled

disable

enable

getInitialFocus

getJComponent

syncImpl

setSelectedItem

getProperty

setProperty

getFormat

setFormat

getWhereClause

setWhereClause

getAutoSelect

setAutoSelect

getSelectOutOf

setSelectOutOf

getSortBy

setSortBy