de.guibuilder.framework
Class GuiCombo

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
                  extended by de.guibuilder.framework.GuiCombo
All Implemented Interfaces:
IDatasetComponent, IDatasetMember, MemberAble, MemberPopupAble, TableColumnAble, TableComboColumn

public final class GuiCombo
extends GuiSelect
implements TableComboColumn

Implementierung einer ComboBox.


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
GuiCombo()
          Erzeugt eine leere ComboBox.
GuiCombo(java.util.ArrayList<java.lang.Object> al)
          Erzeugt eine ComboBox mit einer ArrayList von Einträgen.
GuiCombo(java.util.Iterator<java.lang.Object> it)
          Erzeugt eine ComboBox gefüllt mit den Einträgen aus dem Iterator.
GuiCombo(java.lang.String[] s)
          Erzeugt eine ComboBox mit einem Array von Strings.
GuiCombo(java.util.Vector<java.lang.Object> v)
          Erzeugt eine ComboBox mit einem Vector von Einträgen; zumeist Strings.
 
Method Summary
 void addItem(java.lang.Object val)
          Fügt einen Eintrag - am Ende - der Box hinzu.
 void addItem(java.lang.Object val, int index)
          Fügt einen Eintrag - an dem angegebenen Index - ein.
 void addItems(java.lang.Object[] items)
           
 javax.swing.JComboBox getCombo()
          Liefert die Swing-Komponente
 int getDataType()
          Liefert den Datentyp der Componente.
 java.util.Vector<java.lang.Object> getItems()
          Liefert die Menge der Einträge.
 javax.swing.JComponent getJComponent()
          Liefert die Swing-Komponente zu diesem Oberflächen-Objekt (Delegation).
 java.util.regex.Pattern getRegexp()
          Liefert den Regulären Ausdruck zur Eingabeprüfung oder null, wenn keine Eingabeprüfung mit RE vorgenommen wird.
 int getSelectedIndex()
          Liefert den vom Benutzer ausgewählten Index (0-relativ) oder -1 wenn kein Eintrag gewählt wurde.
 java.lang.Object getSelectedItem()
          Liefert im Unterschied zu getValue "wirklich" ein Object.
 java.lang.Object[] getSelectedItems()
           
 java.lang.String getTag()
          Liefert den XML-Element-Tag für den Member.
 java.lang.String getText()
          Liefert den angezeigten Text der ComboBox.
 java.lang.Object getUnformatedValue()
          Liefert den unformatierten Inhalt dieser Componente.
 java.lang.Object getValue()
          Liefert den selektierten Eintrag aus der ComboBox oder einen Leerstring, wenn nichts selektiert, bzw. die Eingabe des Benutzers, wenn sie editierbar ist.
 java.lang.Class getValueClass()
          Liefert die Klasse, die dem Wert der Komponente entspricht.
 void gotFocus(java.awt.event.FocusEvent e)
          Setzt den Statuszeilentext.
 void lostFocus(java.awt.event.FocusEvent e)
          Überschrieben wegen msgLostFocus
 void pullData()
          Füllt die Combobox mit den Werten aus der Datenbank.
 void removeAllItems()
          Löscht alle Einträge
 void removeItem(java.lang.Object val)
          Löscht den angegebenen Eintrag aus der Box.
 void reset()
          Setzt den selektierten Index zurück
 void setEditable(boolean b)
          Setzt das Kennzeichen, ob die ComboBox editierbar ist.
 void setEnabled(boolean b)
          Setzt die Komponente auch "nur anzeigen" wenn "true" übergeben wird: Hintergrundfarbe auf hellgrau setzen, nicht editierbar, kein TabStop.
 void setItems(java.util.List al)
           
 void setItems(java.lang.String[] s)
          Setzt alle Einträge der Box als Array von Strings.
 void setItems(java.util.Vector v)
          Setzt alle Einträge der Box als Vector.
 void setRegexp(java.lang.String s)
          Setzt einen regulären Ausdruck zur Eingabeüberprüfung.
 void setSelectedIndex(int i)
           
 void setSelectedItem(java.lang.Object o)
           
 void setValue(java.lang.Object val)
          Setzt den Inhalt der ComboBox auf einen neuen Wert.
 
Methods inherited from class de.guibuilder.framework.GuiSelect
getDatasetName, getDisplayMember, getDisplayMemberValue, getMap, getValueMember, getValueMemberValue, setDatasetName, setDisplayMember, setItems, setItems, setMap, setMap, setMap, setValueMember
 
Methods inherited from class de.guibuilder.framework.GuiComponent
commitChanges, getDatasetValues, getDatasetValues, getDataTypeName, getGuiComponent, getGuiType, getLabel, getMaxlen, getMinlen, isModified, isNotnull, postProc, setDatasetValues, setMaxlen, setMinlen, setModified, setNotnull, toString, verify
 
Methods inherited from class de.guibuilder.framework.GuiElement
getFileName, getHint, getMsgChange, getMsgClick, getMsgDblClick, getParentTable, getRootPane, hasTabstop, isEnabled, requestFocus, 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, getMaximumSize, getMemberElement, getMinimumSize, getMsgDragEnter, getMsgDragExit, getMsgDragOver, getMsgDrop, getMsgFileDrop, getMsgMouseOver, getMsgPopup, getName, getOid, getParentNames, getParentTab, getPopupMenu, getPreferences, getPreferredSize, getRef, getToolTipText, getUserObject, isRootElement, isVisible, 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.TableComboColumn
getDisplayMember, getMap, getValueMember
 
Methods inherited from interface de.guibuilder.framework.TableColumnAble
getBackground, getElementName, getFont, getForeground, getGuiComponent, getMaximumSize, getMinimumSize, getName, getParentTable, getToolTipText, isEnabled, isVisible, setGuiParent, setParentTable, setToolTipText
 
Methods inherited from interface de.guibuilder.framework.IDatasetMember
getElementName, getElementPath, isRootElement, setElementName
 

Constructor Detail

GuiCombo

public GuiCombo()
Erzeugt eine leere ComboBox.


GuiCombo

public GuiCombo(java.util.Vector<java.lang.Object> v)
Erzeugt eine ComboBox mit einem Vector von Einträgen; zumeist Strings.


GuiCombo

public GuiCombo(java.util.ArrayList<java.lang.Object> al)
Erzeugt eine ComboBox mit einer ArrayList von Einträgen.


GuiCombo

public GuiCombo(java.lang.String[] s)
Erzeugt eine ComboBox mit einem Array von Strings.


GuiCombo

public GuiCombo(java.util.Iterator<java.lang.Object> it)
Erzeugt eine ComboBox gefüllt mit den Einträgen aus dem Iterator.

Parameters:
it -
Method Detail

getTag

public final java.lang.String getTag()
Description copied from class: GuiMember
Liefert den XML-Element-Tag für den Member.

Specified by:
getTag in interface MemberAble
Specified by:
getTag in interface TableColumnAble
Specified by:
getTag in class GuiMember

getJComponent

public javax.swing.JComponent getJComponent()
Description copied from class: GuiMember
Liefert die Swing-Komponente zu diesem Oberflächen-Objekt (Delegation).

Es ist möglich, auf die jeweilige Swing-Klasse (JCombo, JTextField, JPanel, ...) zu casten; die Swing-Methoden können so genutzt werden.

Bei einem HiddenField und OptionGroup wird null geliefert!

Specified by:
getJComponent in interface TableColumnAble
Specified by:
getJComponent in class GuiMember

getCombo

public javax.swing.JComboBox getCombo()
Liefert die Swing-Komponente

Specified by:
getCombo in interface TableComboColumn

getDataType

public final int getDataType()
Description copied from class: GuiComponent
Liefert den Datentyp der Componente.

Denkbare Werte sind:

Specified by:
getDataType in interface TableColumnAble
Specified by:
getDataType in class GuiComponent

gotFocus

public void gotFocus(java.awt.event.FocusEvent e)
Description copied from class: GuiElement
Setzt den Statuszeilentext. Wird vom FocusListener aufgerufen. Diese Methode wird bei vielen Klassen überschrieben.

See Also:
GuiFocusListener, GuiRootPane.setHint(java.lang.String)

lostFocus

public void lostFocus(java.awt.event.FocusEvent e)
Description copied from class: GuiComponent
Überschrieben wegen msgLostFocus

See Also:
GuiElement.setMsgLostFocus(java.lang.String), GuiRootPane.obj_LostFocus(de.guibuilder.framework.GuiElement, java.lang.String, java.lang.Object, java.awt.event.FocusEvent)

setEditable

public void setEditable(boolean b)
Setzt das Kennzeichen, ob die ComboBox editierbar ist.


setEnabled

public final void setEnabled(boolean b)
Setzt die Komponente auch "nur anzeigen" wenn "true" übergeben wird: Hintergrundfarbe auf hellgrau setzen, nicht editierbar, kein TabStop.

Specified by:
setEnabled in interface TableColumnAble
Overrides:
setEnabled in class GuiElement

getText

public java.lang.String getText()
Liefert den angezeigten Text der ComboBox.

Returns:

setRegexp

public final void setRegexp(java.lang.String s)
Setzt einen regulären Ausdruck zur Eingabeüberprüfung. Es wird eine Fehlermeldung ausgegeben, wenn der Ausdruck keine korrekte Syntax hat.

Bei Übergabe von null wird der regläre Ausdruck gelöscht.


getRegexp

public final java.util.regex.Pattern getRegexp()
Liefert den Regulären Ausdruck zur Eingabeprüfung oder null, wenn keine Eingabeprüfung mit RE vorgenommen wird.

See Also:
setRegexp(java.lang.String)

setValue

public void setValue(java.lang.Object val)
Setzt den Inhalt der ComboBox auf einen neuen Wert.

Verfügt die ComboBox über eine Mapping von ValueMember auf DisplayMember, wird hier ValueMember erwartet.

Specified by:
setValue in interface TableComboColumn
Overrides:
setValue in class GuiComponent
See Also:
GuiComponent.setModified(boolean), GuiComponent.isModified()

getValue

public java.lang.Object getValue()
Liefert den selektierten Eintrag aus der ComboBox oder einen Leerstring, wenn nichts selektiert, bzw. die Eingabe des Benutzers, wenn sie editierbar ist.

Wenn eine Übersetzungstabelle gesetzt wurde, wird deren Eintrag geliefert.

Specified by:
getValue in interface TableComboColumn
Specified by:
getValue in class GuiComponent
See Also:
GuiSelect.setMap(java.util.Vector)

getUnformatedValue

public java.lang.Object getUnformatedValue()
Description copied from class: GuiComponent
Liefert den unformatierten Inhalt dieser Componente.

Specified by:
getUnformatedValue in class GuiComponent

getItems

public java.util.Vector<java.lang.Object> getItems()
Description copied from class: GuiSelect
Liefert die Menge der Einträge.

Specified by:
getItems in interface TableComboColumn
Specified by:
getItems in class GuiSelect

reset

public final void reset()
Setzt den selektierten Index zurück

Specified by:
reset in class GuiMember

setItems

public void setItems(java.util.Vector v)
Description copied from class: GuiSelect
Setzt alle Einträge der Box als Vector.

Specified by:
setItems in class GuiSelect

setItems

public void setItems(java.util.List al)

pullData

public void pullData()
              throws java.lang.Exception
Füllt die Combobox mit den Werten aus der Datenbank.

Wird von GuiFactory aufgerufen; Voraussetzung ist, daß der GuiSessen ein Adapter zugewiesen ist:
GuiBuilderConfig.xml --> ApplicationAdapter.

Throws:
java.lang.Exception

setItems

public void setItems(java.lang.String[] s)
Description copied from class: GuiSelect
Setzt alle Einträge der Box als Array von Strings.

Specified by:
setItems in class GuiSelect

addItem

public void addItem(java.lang.Object val)
Description copied from class: GuiSelect
Fügt einen Eintrag - am Ende - der Box hinzu.

Specified by:
addItem in class GuiSelect

addItem

public void addItem(java.lang.Object val,
                    int index)
Description copied from class: GuiSelect
Fügt einen Eintrag - an dem angegebenen Index - ein.

Specified by:
addItem in class GuiSelect

addItems

public void addItems(java.lang.Object[] items)
Specified by:
addItems in class GuiSelect

removeItem

public void removeItem(java.lang.Object val)
Description copied from class: GuiSelect
Löscht den angegebenen Eintrag aus der Box.

Specified by:
removeItem in class GuiSelect

removeAllItems

public void removeAllItems()
Description copied from class: GuiSelect
Löscht alle Einträge

Specified by:
removeAllItems in class GuiSelect
See Also:
GuiList.reset()

getSelectedIndex

public int getSelectedIndex()
Description copied from class: GuiSelect
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.

Specified by:
getSelectedIndex in class GuiSelect

getSelectedItems

public java.lang.Object[] getSelectedItems()
Specified by:
getSelectedItems in class GuiSelect

setSelectedIndex

public void setSelectedIndex(int i)
Specified by:
setSelectedIndex in class GuiSelect

getSelectedItem

public java.lang.Object getSelectedItem()
Description copied from class: GuiSelect
Liefert im Unterschied zu getValue "wirklich" ein Object.

Specified by:
getSelectedItem in class GuiSelect

setSelectedItem

public void setSelectedItem(java.lang.Object o)
Specified by:
setSelectedItem in class GuiSelect

getValueClass

public java.lang.Class getValueClass()
Description copied from interface: TableColumnAble
Liefert die Klasse, die dem Wert der Komponente entspricht. String, Number, Date, Boolean.

unused!

Specified by:
getValueClass in interface TableColumnAble