de.must.wuic

Class DataVariableChoice

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JComboBox<java.lang.Object>

de.must.wuic.MustComboBox

de.must.wuic.VariableChoice

de.must.wuic.DataVariableChoice

All Implemented Interfaces:

Exemptible, ModifiedInformer, ContextHelp, DataComponent, java.awt.event.ActionListener, java.awt.image.ImageObserver, java.awt.ItemSelectable, java.awt.MenuContainer, java.io.Serializable, java.util.EventListener, javax.accessibility.Accessible, javax.swing.event.ListDataListener

public class DataVariableChoice
extends VariableChoice
implements DataComponent

See Also:

Serialized Form

Nested Class Summary

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

javax.swing.JComboBox.AccessibleJComboBox, javax.swing.JComboBox.KeySelectionManager

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

javax.swing.JComponent.AccessibleJComponent

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

java.awt.Container.AccessibleAWTContainer

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

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

Fields inherited from class de.must.wuic.VariableChoice

editBeginValue

Fields inherited from class de.must.wuic.MustComboBox

programmaticChange

Fields inherited from class javax.swing.JComboBox

actionCommand, dataModel, 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 java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor and Description
DataVariableChoice(KeyValuePair[] Content, DataObject dO, java.lang.String columnName) Constructs a new DataVariableChoice.
DataVariableChoice(java.lang.String[][] content, DataObject dO, java.lang.String columnName) Constructs a new DataVariableChoice.
DataVariableChoice(java.lang.String[][] content, DataObject dO, java.lang.String columnName, boolean noChoicePossible) Constructs a new DataVariableChoice.
DataVariableChoice(java.lang.String[][] content, DataObject dO, java.lang.String columnName, boolean noChoicePossible, boolean suppressKey) Constructs a new DataVariableChoice.

Method Summary

Modifier and Type	Method and Description
void	addComponentModificationListener(ComponentModificationListener l) Adds a component modification listener to this component.
void	free() Releases external resources.
DataObject	getAssignedDataObject() Returns the assigned data object.
boolean	isContentValid() Indicates whether the component's value is valid.
boolean	isFilled() Indicates whether the component has a value.
boolean	isModified() Indicates whether the component's value differs from its initial value.
boolean	isRequirementUnfulfilled() Indicates whether the component's value is mandatory but not filled.
boolean	isToSave() Indicates whether the component's value differs from its value at load time.
void	loadValue() Loads the component's database stored value.
void	removeComponentModificationListener(ComponentModificationListener l) Removes a component modification listener to this component.
void	saveValue() Stores the component's value.
void	selectAll() Selects all input of the component, if it is supported - e.g. in JTextField.
void	setDefaultValue(java.lang.String newDefaultValue)
void	setEditable(boolean editable) Sets the flag that determines whether or not this component is editable.
void	setEditBeginValue(java.lang.String specialeditBeginValue) Sets the default value (if no date could be loaded from database).
void	setRequired(boolean required) Determines whether input is required (mandatory).
void	setSelectedIndexAsEditBeginValue(int anIndex) Selects the item by index as edit begin value which causes isModified to return false as long as user select another item.
void	setSelectedItemKeyAsEditBeginValue(java.lang.String key) Selects the item by key as edit begin value which causes isModified to return false as long as user select another item.

Methods inherited from class de.must.wuic.VariableChoice

getSelectedItemKey, getSelectedItemKeyAsInt, getTranslation, isSpecialChoice, setNoSpecialChoice, setSelectedItemKey, setSelectedItemKeyAsBeginValue

Methods inherited from class de.must.wuic.MustComboBox

getBackground, getHelpTarget, getHelpTopic, getIndexIfUnique, resetEditBeginValue, setEditableForUserTyping, setEditableForUserTyping, setEditableForUserTyping, setHelpContext, setHelpContext, setSelectedIndex, setSelectedItem, setSelectedItemAsEditBeginValue

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, setEditor, setEnabled, setKeySelectionManager, setLightWeightPopupEnabled, setMaximumRowCount, setModel, setPopupVisible, setPrototypeDisplayValue, setRenderer, 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, getPreferredSize, 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, 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, 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, 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, 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, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.must.wuic.DataComponent

requestFocusInWindow, setToolTipText

Constructor Detail

DataVariableChoice

public DataVariableChoice(java.lang.String[][] content,
                          DataObject dO,
                          java.lang.String columnName)

Constructs a new DataVariableChoice.

Parameters:

content - the content to assign to

dO - the data object to assign to

columnName - the name of the column the text field is to assign to

DataVariableChoice

public DataVariableChoice(java.lang.String[][] content,
                          DataObject dO,
                          java.lang.String columnName,
                          boolean noChoicePossible)

Constructs a new DataVariableChoice.

Parameters:

content - the content to assign to

dO - the data object to assign to

columnName - the name of the column the text field is to assign to

noChoicePossible - if true, an item is offered which represents the "no choice"

DataVariableChoice

public DataVariableChoice(java.lang.String[][] content,
                          DataObject dO,
                          java.lang.String columnName,
                          boolean noChoicePossible,
                          boolean suppressKey)

Constructs a new DataVariableChoice.

Parameters:

content - the content to assign to

dO - the data object to assign to

columnName - the name of the column the text field is to assign to

noChoicePossible - if true, an item is offered which represents the "no choice"

suppressKey - whether or not keys should be suppressed in ComboBox

DataVariableChoice

public DataVariableChoice(KeyValuePair[] Content,
                          DataObject dO,
                          java.lang.String columnName)

Constructs a new DataVariableChoice.

Parameters:

content - the content to assign to

dO - the data object to assign to

columnName - the name of the column the text field is to assign to

Method Detail

getAssignedDataObject

public DataObject getAssignedDataObject()

Returns the assigned data object.

Specified by:

getAssignedDataObject in interface DataComponent

Returns:

the assigned data object

setDefaultValue

public void setDefaultValue(java.lang.String newDefaultValue)

Parameters:

newDefaultValue - sets the default value.

setEditable

public void setEditable(boolean editable)

Sets the flag that determines whether or not this component is editable. This means: value may be changed by user. It does not mean, that user may type in characters. To allow this, use setEditableForUserTyping. If the flag is set to true, this component becomes user editable. If the flag is set to false, the cannot change the text of this text component.

Specified by:

setEditable in interface DataComponent

Overrides:

setEditable in class MustComboBox

Parameters:

editable - a flag indicating whether this component should be user editable

See Also:

MustComboBox.setEditableForUserTyping(boolean)

setRequired

public void setRequired(boolean required)

Description copied from interface: DataComponent

Determines whether input is required (mandatory).

Specified by:

setRequired in interface DataComponent

Parameters:

required - if true, input is mandatory; otherwise, input is not mandatory

isContentValid

public boolean isContentValid()

Description copied from interface: DataComponent

Indicates whether the component's value is valid.

Specified by:

isContentValid in interface DataComponent

Returns:

true if the component's value is valid

isRequirementUnfulfilled

public boolean isRequirementUnfulfilled()

Description copied from interface: DataComponent

Indicates whether the component's value is mandatory but not filled.

Specified by:

isRequirementUnfulfilled in interface DataComponent

Returns:

if mandatory input is unfulfilled

selectAll

public void selectAll()

Description copied from interface: DataComponent

Selects all input of the component, if it is supported - e.g. in JTextField. Allows easy new input, because the previous value is reset when the first key stroke occurs.

Specified by:

selectAll in interface DataComponent

setSelectedIndexAsEditBeginValue

public void setSelectedIndexAsEditBeginValue(int anIndex)

Selects the item by index as edit begin value which causes isModified to return false as long as user select another item.

Overrides:

setSelectedIndexAsEditBeginValue in class MustComboBox

Parameters:

anIndex - the index of the item to select

setSelectedItemKeyAsEditBeginValue

public void setSelectedItemKeyAsEditBeginValue(java.lang.String key)

Selects the item by key as edit begin value which causes isModified to return false as long as user select another item.

Parameters:

key - the key of the item to select

loadValue

public void loadValue()

Loads the component's database stored value.

Specified by:

loadValue in interface DataComponent

isFilled

public boolean isFilled()

Description copied from interface: DataComponent

Indicates whether the component has a value.

Specified by:

isFilled in interface DataComponent

Returns:

true if the component has a value

setEditBeginValue

public void setEditBeginValue(java.lang.String specialeditBeginValue)

Sets the default value (if no date could be loaded from database).

Parameters:

specialEditBeginValue - the new initial value of the date field

isModified

public boolean isModified()

Description copied from interface: ModifiedInformer

Indicates whether the component's value differs from its initial value.

Specified by:

isModified in interface ModifiedInformer

Overrides:

isModified in class VariableChoice

Returns:

true if the component's value differs from its initial value

isToSave

public boolean isToSave()

Description copied from interface: DataComponent

Indicates whether the component's value differs from its value at load time.

Specified by:

isToSave in interface DataComponent

Returns:

true if the component's value differs from its value at load time

addComponentModificationListener

public void addComponentModificationListener(ComponentModificationListener l)

Description copied from interface: DataComponent

Adds a component modification listener to this component. Needed e.g. for data components depending from a sublist.

Specified by:

addComponentModificationListener in interface DataComponent

Parameters:

l - component modification listener to add

removeComponentModificationListener

public void removeComponentModificationListener(ComponentModificationListener l)

Description copied from interface: DataComponent

Removes a component modification listener to this component. Needed e.g. for data components depending from a sublist.

Specified by:

removeComponentModificationListener in interface DataComponent

Parameters:

l - component modification listener to add

See Also:

DataList

saveValue

public void saveValue()

Description copied from interface: DataComponent

Stores the component's value.

Specified by:

saveValue in interface DataComponent

free

public void free()

Description copied from interface: Exemptible

Releases external resources. May be called manually without waiting for garbage collection to occur.

Specified by:

free in interface Exemptible