de.must.wuic

Class DataMultChoice

java.lang.Object

de.must.wuic.MultChoice

de.must.wuic.DataMultChoice

All Implemented Interfaces:

Exemptible, ModifiedInformer, ContextHelp, DataComponent

public class DataMultChoice
extends MultChoice
implements DataComponent, ContextHelp

A database connected component to assign multiple keys via checkbox list.

Field Summary

Fields inherited from class de.must.wuic.MultChoice

helpTarget, helpTopic, model, required, table

Constructor Summary

Constructors

Constructor and Description
DataMultChoice(DataObject root, DataObject key, AssoDataObject link, java.lang.String[] keyColumns, java.lang.String[] keyHeaders) Constructs a new database connected multiple choice component.

Method Summary

Modifier and Type	Method and Description
void	addComponentModificationListener(ComponentModificationListener l) Adds a component modification listener to this component.
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	isRequirementUnfulfilled() Indicates whether the component's value is mandatory but not filled.
boolean	isSelected(Identifier id)
boolean	isToSave() Indicates whether the component's value differs from its value at load time.
void	keyReleased(java.awt.event.KeyEvent e) Invoked when a key has been released.
void	loadValue() Loads the component's database stored value.
void	reload(java.lang.String whereCondition) Causes a reload, shortened by a where condition.
void	removeAll()
void	removeComponentModificationListener(ComponentModificationListener l) Removes a component modification listener to this component.
void	saveValue() Stores the component's value.
void	setCopyModeAndIdentifyTextField(MustTextField identifyTextField) Sets copy mode and the text field which will contain the identify value when it's time to save.
void	setCopyModeAndNewRootIdentifier(Identifier newRootIdentifier) Sets the copy mode and the new root identifier.
void	setIdentifyTextField(MustTextField identifyTextField) Sets the text field which will contain the identify value when it's time to save.
void	skipNextLoad() Causes that next loadValue() is skipped.

Methods inherited from class de.must.wuic.MultChoice

free, getHelpTarget, getHelpTopic, getTable, isModified, requestFocusInWindow, selectAll, setEditable, setHelpContext, setHelpContext, setPreferedColumnSize, setRequired, setToolTipText

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.must.wuic.DataComponent

requestFocusInWindow, selectAll, setEditable, setRequired, setToolTipText

Methods inherited from interface de.must.middle.ModifiedInformer

isModified

Methods inherited from interface de.must.middle.Exemptible

free

Methods inherited from interface de.must.wuic.ContextHelp

getHelpTarget, getHelpTopic, setHelpContext

Constructor Detail

DataMultChoice

public DataMultChoice(DataObject root,
                      DataObject key,
                      AssoDataObject link,
                      java.lang.String[] keyColumns,
                      java.lang.String[] keyHeaders)

Constructs a new database connected multiple choice component.

Parameters:

root - the main data object which is the entity that is to be assigned to one or more keys

key - the key containing data object, e.g. a group

link - the relational entity data object

keyColumns - the columns of the key table to be displayed

keyHeaders - the headers of the table which represents the keys

Method Detail

getAssignedDataObject

public DataObject getAssignedDataObject()

Returns the assigned data object.

Specified by:

getAssignedDataObject in interface DataComponent

Returns:

the assigned data object

reload

public void reload(java.lang.String whereCondition)

Causes a reload, shortened by a where condition.

Parameters:

whereCondition - the where condition to shorten the content

skipNextLoad

public void skipNextLoad()

Causes that next loadValue() is skipped. Useful if loading is costly and is to be repeated due to dependency on other loaded values.

loadValue

public void loadValue()

Loads the component's database stored value.

Specified by:

loadValue in interface DataComponent

setCopyModeAndNewRootIdentifier

public void setCopyModeAndNewRootIdentifier(Identifier newRootIdentifier)

Sets the copy mode and the new root identifier.

Parameters:

newRootIdentifier - the new root identifier

setCopyModeAndIdentifyTextField

public void setCopyModeAndIdentifyTextField(MustTextField identifyTextField)

Sets copy mode and the text field which will contain the identify value when it's time to save.

Parameters:

identifyTextField - the text field which will contain the identify value when it's time to save

setIdentifyTextField

public void setIdentifyTextField(MustTextField identifyTextField)

Sets the text field which will contain the identify value when it's time to save.

Parameters:

identifyTextField - the text field which will contain the identify value when it's time to save

keyReleased

public void keyReleased(java.awt.event.KeyEvent e)

Invoked when a key has been released. Used to fire a component modified event.

Parameters:

e - the key event

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

removeAll

public void removeAll()

isSelected

public boolean isSelected(Identifier id)

saveValue

public void saveValue()

Description copied from interface: DataComponent

Stores the component's value.

Specified by:

saveValue in interface DataComponent

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

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

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