de.guibuilder.framework
Class GuiCombo

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

• BOOLEAN (Check)
• DATE = String
• ENUM (not implemented)
• INTEGER (Slider, Scrollbar, Spinn)
• MULTILINE = String (Memo, Editor)
• NUMBER = String
• STRING (Text, Combo, List, Label, Password, Hidden)
• TIME = String
• TABLE = Vector von Vectoren
• TREE (not implemented; see GuiTree.getAllValuesXml)

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