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:

MemberAble, java.io.Serializable, TableColumnAble

public final class GuiCombo

extends GuiSelect

implements TableColumnAble

Implementierung einer ComboBox.

See Also:

Serialized Form

Field Summary

Fields inherited from class de.guibuilder.framework.GuiComponent

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

Fields inherited from class de.guibuilder.framework.GuiElement

actionChange, actionDblClick

Fields inherited from class de.guibuilder.framework.GuiMember

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

Constructor Summary

GuiCombo()
Erzeugt eine leere ComboBox.

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

GuiCombo(java.util.Vector 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.
int	getDataType() Liefert den Datentyp der Componente.
java.util.Vector	getItems() Liefert die Menge der Einträge.
javax.swing.JComponent	getJComponent() Liefert die Swing-Komponente zu diesem Oberflächen-Objekt (Delegation).
java.util.Vector	getMap()
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.String	getTag() Liefert den XML-Element-Tag für den Member.
java.lang.String	getText()
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	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.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	setMap(java.lang.String[] s) Setzt die Übersetzungstabelle.
void	setMap(java.util.Vector v) Setzt eine Übersetzungstabelle - die genauso groß sein muß wie die Menge der Einträge - für die gelieferten Werte.
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.GuiComponent

getDataTypeName, getGuiType, getMaxlen, getMinlen, getModelValues, isModified, isNotnull, setMaxlen, setMinlen, setModelValues, setModified, setNotnull, verify

Methods inherited from class de.guibuilder.framework.GuiElement

getFileName, getHint, getMsgChange, getMsgDblClick, getParentTable, getRootPane, isEnabled, requestFocus, setHint, setMsgChange, setMsgDblClick, setMsgLostFocus, setParentTable

Methods inherited from class de.guibuilder.framework.GuiMember

click, d_click, getBackground, getConstraints, getControler, getElementName, getFont, getForeground, getFullName, getGuiParent, getGuiTypeName, getLabel, getMaximumSize, getMinimumSize, getMsgMouseOver, getName, getOid, getParentNames, getParentTab, getPreferredSize, getRef, getToolTipText, getUserObject, getXValue, isVisible, setBackground, setConstraints, setControler, setFont, setForeground, setGuiParent, setLabel, setMaximumSize, setMinimumSize, setMsgMouseMoved, setMsgMouseOver, setName, setOid, setPopupMenu, setPreferredSize, setRef, setToolTipText, setUserObject, setVisible

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.guibuilder.framework.TableColumnAble

getBackground, getElementName, getFont, getForeground, getMaximumSize, getMinimumSize, getName, getParentTable, getToolTipText, getXValue, isEnabled, isVisible, setParentTable, setToolTipText

Constructor Detail

GuiCombo

public GuiCombo()

Erzeugt eine leere ComboBox.

GuiCombo

public GuiCombo(java.util.Vector v)

Erzeugt eine ComboBox mit einem Vector von Einträgen; zumeist Strings.

GuiCombo

public GuiCombo(java.lang.String[] s)

Erzeugt eine ComboBox mit einem Array von Strings.
Dieser Constructor wird vom Codegenerator verwendet.

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 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

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

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()

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.
Dieses wirkt nur dann, wenn die Combobox auch editierbar ist!

PENDING! Funktioniert leider garnicht, da editierbare ComboBoxen kein LostFocus-Ereignis haben!

setValue

public void setValue(java.lang.Object val)

Setzt den Inhalt der ComboBox auf einen neuen Wert.

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 class GuiComponent

See Also:

setMap(java.util.Vector)

getItems

public java.util.Vector getItems()

Description copied from class: GuiSelect

Liefert die Menge der Einträge.

Specified by:

getItems in class GuiSelect

reset

public final void reset()

Setzt den selektierten Index zurück

Overrides:

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

setMap

public void setMap(java.util.Vector v)

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

See Also:

getValue()

setMap

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

Setzt die Übersetzungstabelle.

getMap

public java.util.Vector getMap()

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

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

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