de.guibuilder.framework
Class GuiSelect

java.lang.Object
  de.guibuilder.framework.GuiMember
      de.guibuilder.framework.GuiElement
          de.guibuilder.framework.GuiComponent
              de.guibuilder.framework.GuiSelect

All Implemented Interfaces:

IDatasetComponent, IDatasetMember, MemberAble, MemberPopupAble

Direct Known Subclasses:

GuiCombo, GuiList

public abstract class GuiSelect
extends GuiComponent

Abstrakte Basisklasse für die Vereinheitlichung des Verhaltens von Combo- und ListBox.

Field Summary

Fields inherited from class de.guibuilder.framework.GuiComponent

BOOLEAN, DATA_TYPE_NAMES, DATE, ENUM, INTEGER, MULTILINE, NUMBER, STRING, TABLE, TIME, TREE

Fields inherited from class de.guibuilder.framework.GuiMember

GUI_ACTION, GUI_COMPONENT, GUI_CONTAINER, GUI_TABLE, GUI_TREE, GUI_TYPE_NAMES, OID

Constructor Summary

GuiSelect()

Method Summary

abstract void	addItem(java.lang.Object item) Fügt einen Eintrag - am Ende - der Box hinzu.
abstract void	addItem(java.lang.Object item, int index) Fügt einen Eintrag - an dem angegebenen Index - ein.
abstract void	addItems(java.lang.Object[] items)
java.lang.String	getDatasetName()
java.lang.String	getDisplayMember()
java.lang.Object	getDisplayMemberValue(java.lang.Object mapValue) Liefert die "Übersetzung" ValueMember --> DisplayMember.
abstract java.util.Vector<java.lang.Object>	getItems() Liefert die Menge der Einträge.
java.util.Vector<java.lang.Object>	getMap() Liefert die Menge der Value-Werte.
abstract int	getSelectedIndex() Liefert den vom Benutzer ausgewählten Index (0-relativ) oder -1 wenn kein Eintrag gewählt wurde.
abstract java.lang.Object	getSelectedItem() Liefert im Unterschied zu getValue "wirklich" ein Object.
abstract java.lang.Object[]	getSelectedItems()
java.lang.String	getValueMember()
java.lang.Object	getValueMemberValue(java.lang.Object disValue) Liefert die "Übersetzung" DisplayMember --> ValueMember.
abstract void	removeAllItems() Löscht alle Einträge
abstract void	removeItem(java.lang.Object item) Löscht den angegebenen Eintrag aus der Box.
void	setDatasetName(java.lang.String datasetName)
void	setDisplayMember(java.lang.String displayMember)
void	setItems(JDataSet ds) Füllt die ComboBox mit den Werten aus einem DataSet.
void	setItems(JDataSet ds, java.lang.String rowPath) Füllt die ComboBox mit den Werten aus einer DataTable eines DataSet.
abstract void	setItems(java.lang.String[] s) Setzt alle Einträge der Box als Array von Strings.
abstract void	setItems(java.util.Vector v) Setzt alle Einträge der Box als Vector.
void	setMap(java.util.ArrayList<java.lang.Object> al) Setzt eine Übersetzungstabelle (ValueMembers) - die genauso groß sein muß wie die Menge der Einträge - für die gelieferten Werte.
void	setMap(java.lang.String[] s) Setzt die Übersetzungstabelle.
void	setMap(java.util.Vector<java.lang.Object> v) Setzt eine Übersetzungstabelle (ValueMembers) - die genauso groß sein muß wie die Menge der Einträge - für die gelieferten Werte.
abstract void	setSelectedIndex(int i)
abstract void	setSelectedItem(java.lang.Object o)
void	setValueMember(java.lang.String valueMember)

Methods inherited from class de.guibuilder.framework.GuiComponent

commitChanges, getDatasetValues, getDatasetValues, getDataType, getDataTypeName, getGuiComponent, getGuiType, getLabel, getMaxlen, getMinlen, getUnformatedValue, getValue, isModified, isNotnull, postProc, setDatasetValues, setMaxlen, setMinlen, setModified, setNotnull, setValue, toString, verify

Methods inherited from class de.guibuilder.framework.GuiElement

getFileName, getHint, getMsgChange, getMsgClick, getMsgDblClick, getParentTable, getRootPane, hasTabstop, isEnabled, requestFocus, setEnabled, setHint, setMsgChange, setMsgClick, setMsgDblClick, setMsgLostFocus, setParentTable, setTabstop

Methods inherited from class de.guibuilder.framework.GuiMember

addSetter, click, d_click, getAwtComponent, getBackground, getConstraints, getControler, getController, getDropTarget, getElementName, getElementPath, getFont, getForeground, getFullName, getGuiParent, getGuiTypeName, getJComponent, getMaximumSize, getMemberElement, getMinimumSize, getMsgDragEnter, getMsgDragExit, getMsgDragOver, getMsgDrop, getMsgFileDrop, getMsgMouseOver, getMsgPopup, getName, getOid, getParentNames, getParentTab, getPopupMenu, getPreferences, getPreferredSize, getRef, getTag, getToolTipText, getUserObject, isRootElement, isVisible, reset, setBackground, setConstraints, setControler, setController, setDrag, setElementName, setFont, setForeground, setGuiParent, setLabel, setMaximumSize, setMinimumSize, setMsgDragEnter, setMsgDragExit, setMsgDragOver, setMsgDrop, setMsgFileDrop, setMsgMouseMoved, setMsgMouseOver, setMsgPopup, setName, setOid, setPopupMenu, setPreferences, setPreferredSize, setRef, setStateAttributes, setToolTipText, setUserObject, setVisible, showPopupMenu, showPopupMenu

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface de.guibuilder.framework.IDatasetMember

getElementName, getElementPath, isRootElement, setElementName

Constructor Detail

GuiSelect

public GuiSelect()

Method Detail

getDatasetName

public final java.lang.String getDatasetName()

Returns:

setDatasetName

public final void setDatasetName(java.lang.String datasetName)

Parameters:

datasetName -

getDisplayMember

public final java.lang.String getDisplayMember()

Returns:

setDisplayMember

public final void setDisplayMember(java.lang.String displayMember)

Parameters:

displayMember -

getValueMember

public final java.lang.String getValueMember()

Returns:

setValueMember

public final void setValueMember(java.lang.String valueMember)

Parameters:

valueMember -

getSelectedIndex

public abstract int getSelectedIndex()

Liefert den vom Benutzer ausgewählten Index (0-relativ) oder -1 wenn kein Eintrag gewählt wurde.

Achtung!
Wenn List vom Typ MULTI ist, wird der erste Index geliefert.

setSelectedIndex

public abstract void setSelectedIndex(int i)

setSelectedItem

public abstract void setSelectedItem(java.lang.Object o)

getSelectedItem

public abstract java.lang.Object getSelectedItem()

Liefert im Unterschied zu getValue "wirklich" ein Object.

getSelectedItems

public abstract java.lang.Object[] getSelectedItems()

getDisplayMemberValue

public java.lang.Object getDisplayMemberValue(java.lang.Object mapValue)

Liefert die "Übersetzung" ValueMember --> DisplayMember.

Wenn keine Map vorhanden, dann wird der übergebene Wert zurückgeliefert. Wenn der Eintrag in der Map fehlt, wird null geliefert.

Parameters:

val - Ein Wert aus der Menge der ValueMembers

Returns:

Object Dem ValueMember entsprechenden DisplayMember oder null, falls dieser nicht gefunden wurde.

See Also:

setMap(java.util.Vector)

getValueMemberValue

public java.lang.Object getValueMemberValue(java.lang.Object disValue)

Liefert die "Übersetzung" DisplayMember --> ValueMember.

Wenn keine Map vorhanden, dann wird der übergebene Wert zurückgeliefert. Wenn der Eintrag in der Map fehlt, wird null geliefert.

Parameters:

val - Ein Wert aus der Menge der ValueMembers

Returns:

Object Dem DisplayMember entsprechenden ValueMember oder null, falls dieser nicht gefunden wurde.

See Also:

setMap(java.util.Vector)

setItems

public abstract void setItems(java.util.Vector v)

Setzt alle Einträge der Box als Vector.

setItems

public abstract void setItems(java.lang.String[] s)

Setzt alle Einträge der Box als Array von Strings.

setItems

public void setItems(JDataSet ds)

Füllt die ComboBox mit den Werten aus einem DataSet.

Es werden die Angaben zu DisplayMember und ValueMember ausgewertet.

ValueMember darf auch null sein; dann wird kein Mapping DiplayMember --> ValueMember vorgenommen.

Ist auch DispayMember null, wird die erste Spalte der DataRow verwendet.

Parameters:

ds -

See Also:

setDisplayMember(java.lang.String), setValueMember(java.lang.String)

setItems

public void setItems(JDataSet ds,
                     java.lang.String rowPath)

Füllt die ComboBox mit den Werten aus einer DataTable eines DataSet.

Parameters:

ds -

rowPath -

See Also:

setItems(JDataSet)

addItem

public abstract void addItem(java.lang.Object item)

Fügt einen Eintrag - am Ende - der Box hinzu.

addItems

public abstract void addItems(java.lang.Object[] items)

addItem

public abstract void addItem(java.lang.Object item,
                             int index)

Fügt einen Eintrag - an dem angegebenen Index - ein.

removeItem

public abstract void removeItem(java.lang.Object item)

Löscht den angegebenen Eintrag aus der Box.

removeAllItems

public abstract void removeAllItems()

Löscht alle Einträge

See Also:

GuiList.reset()

getItems

public abstract java.util.Vector<java.lang.Object> getItems()

Liefert die Menge der Einträge.

setMap

public void setMap(java.util.Vector<java.lang.Object> v)

Setzt eine Übersetzungstabelle (ValueMembers) - die genauso groß sein muß wie die Menge der Einträge - für die gelieferten Werte.

See Also:

GuiComponent.getValue()

setMap

public void setMap(java.lang.String[] s)

Setzt die Übersetzungstabelle.

setMap

public void setMap(java.util.ArrayList<java.lang.Object> al)

Setzt eine Übersetzungstabelle (ValueMembers) - die genauso groß sein muß wie die Menge der Einträge - für die gelieferten Werte.

See Also:

GuiComponent.getValue()

getMap

public java.util.Vector<java.lang.Object> getMap()

Liefert die Menge der Value-Werte.

Returns: