de.guibuilder.framework
Class GuiSelect

java.lang.Object
  extended by de.guibuilder.framework.GuiMember
      extended by de.guibuilder.framework.GuiElement
          extended by de.guibuilder.framework.GuiComponent
              extended by 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: