de.guibuilder.framework
Class GuiList

java.lang.Object
  |
  +--de.guibuilder.framework.GuiMember
        |
        +--de.guibuilder.framework.GuiElement
              |
              +--de.guibuilder.framework.GuiComponent
                    |
                    +--de.guibuilder.framework.GuiSelect
                          |
                          +--de.guibuilder.framework.GuiList

All Implemented Interfaces:

MemberAble, java.io.Serializable

public final class GuiList

extends GuiSelect

Implementierung einer ListBox.
Es wird ein SelectionListener eingerichtet.

Das Verhalten der Listbox bei get- und setValue kann mit setListboxType gesteuert werden:

• NORMAL liefert und setzt den selektierten Wert; die Listbox benimmt sich wie eine Combobox.
• MULTI liefert und setzt mehrere Werte; der Benutzer kann mehrere Einträge selektieren.
• ALL liefert und setzt alle Werte.

Achtung!
Auch wenn die Listbox nicht auf NORMAL steht, wird beim Anklicken durch den Benutzer im Ereignis "Changed" immer der jeweils angeklickte Wert geliefert.

### PENDING: map

See Also:

Serialized Form

Field Summary

static int	ALL Bei getValue werden immer alle Einträge geliefert.
static java.lang.String	HORIZONTAL_WRAP
static int	MULTI Es können mehrere Einträge selektiert werden.
static int	NORMAL Normale Listebox; es kann nur ein Eintrag gewählt werden.
static java.lang.String	VERTICAL
static java.lang.String	VERTICAL_WRAP

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

GuiList()
Erzeugt eine leere ListBox.

GuiList(java.lang.String[] s)
Erzeugt eine ListBox mit Inhalt.

GuiList(java.util.Vector v)
Erzeugt eine ListBox mit Inhalt.

Method Summary

void	addItem(java.lang.Object s) Fügt der ListBox einen Eintrag hinzu; vorzugsweise Strings.
void	addItem(java.lang.Object val, int index) Fügt einen Eintrag - an dem angegebenen Index - ein.
void	click(java.awt.event.MouseEvent e) Tut nix.
void	d_click(java.awt.event.MouseEvent e) Komponente wurde doppelt geklickt.
int	getDataType() Liefert NORMAL wenn NORMAL, ansonsten ENUM.
java.util.Vector	getItems() Liefert die Menge der Einträge.
javax.swing.JComponent	getJComponent() Liefert JList
int	getSelectedIndex() Liefert den selektierten Index; bei MULTI wird der erste Index geliefert.
java.lang.Object	getSelectedItem() Liefert den selektierten Eintrag.
java.lang.String	getTag() Liefert "List"
java.lang.Object	getValue() Liefert den selektierten Eintrag oder den gesamten Inhalt der ListBox.
java.lang.Object	getValue(int type) Liefert den Wert der Listbox je nach übergebnen Type: NORMAL liefert den Selektierten Eintrag als String.
java.lang.String	getValues() Liefert alle Einträge der Listbox mit "|" getrennt.
void	removeAllItems() Löscht alle Einträge
void	removeItem(java.lang.Object s) Löscht aus der ListBox einen Eintrag.
void	reset() Bei den Typen NORMAL und MULTI wird slectedIndex zurückgesetzt; bei ALL werden alle Einträge aus der ListBox gelöscht.
void	setItems(java.lang.String[] s) Füllt die Listbox mit dem übergebenen Array neu.
void	setItems(java.util.Vector v) Füllt die Listbox mit dem übergebenen Vector neu.
void	setLayout(java.lang.String lay)
void	setListboxType(java.lang.String t) Es sind die Werte NORMAL, MULTI und ALL erlaubt; ansonsten wird eine IllegalArgumentException geworfen.
void	setSelectedIndex(int i) Delegation zu JList.setSelectedInterval
void	setSelectedItem(java.lang.Object o) Setzt den zu selektierenden Eintrag.
void	setValue(java.lang.Object val) Setzt den selektierten Wert auf einen bestimmten Eintrag.

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, setEnabled, setHint, setMsgChange, setMsgDblClick, setMsgLostFocus, setParentTable

Methods inherited from class de.guibuilder.framework.GuiMember

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

Field Detail

VERTICAL

public static final java.lang.String VERTICAL

See Also:

Constant Field Values

VERTICAL_WRAP

public static final java.lang.String VERTICAL_WRAP

See Also:

Constant Field Values

HORIZONTAL_WRAP

public static final java.lang.String HORIZONTAL_WRAP

See Also:

Constant Field Values

NORMAL

public static final int NORMAL

Normale Listebox; es kann nur ein Eintrag gewählt werden.

See Also:

Constant Field Values

MULTI

public static final int MULTI

Es können mehrere Einträge selektiert werden.

See Also:

Constant Field Values

ALL

public static final int ALL

Bei getValue werden immer alle Einträge geliefert.

See Also:

Constant Field Values

Constructor Detail

GuiList

public GuiList()

Erzeugt eine leere ListBox.

Weist ein DefaultListModel zu.

GuiList

public GuiList(java.util.Vector v)

Erzeugt eine ListBox mit Inhalt.

Parameters:

v - Vector von Einträgen (Strings) für die Listbox.

GuiList

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

Erzeugt eine ListBox mit Inhalt.

Parameters:

s - Array von Strings für den Inhalt der Listbox.

Method Detail

getTag

public final java.lang.String getTag()

Liefert "List"

Specified by:

getTag in interface MemberAble

Specified by:

getTag in class GuiMember

getJComponent

public javax.swing.JComponent getJComponent()

Liefert JList

Specified by:

getJComponent in class GuiMember

getDataType

public final int getDataType()

Liefert NORMAL wenn NORMAL, ansonsten ENUM.

Specified by:

getDataType in class GuiComponent

setListboxType

public void setListboxType(java.lang.String t)

Es sind die Werte NORMAL, MULTI und ALL erlaubt; ansonsten wird eine IllegalArgumentException geworfen.

addItem

public void addItem(java.lang.Object s)

Fügt der ListBox einen Eintrag hinzu; vorzugsweise Strings.

Diese Methode fehlt in JList tatsächlich!!!

Specified by:

addItem in class GuiSelect

setItems

public void setItems(java.util.Vector v)

Füllt die Listbox mit dem übergebenen Vector neu.

Bei Übergaben von null wird die Listbox geleert.

Die Swing-Methode setListData ruiniert leider das ListModel!

Specified by:

setItems in class GuiSelect

setItems

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

Füllt die Listbox mit dem übergebenen Array neu.

Bei Übergaben von null wird die Listbox geleert.

Die Swing-Methode setListData ruiniert leider das ListModel!

Specified by:

setItems in class GuiSelect

removeItem

public void removeItem(java.lang.Object s)

Löscht aus der ListBox einen Eintrag.

Diese Methode fehlt in JList tatsächlich!!!

Specified by:

removeItem in class GuiSelect

setValue

public void setValue(java.lang.Object val)

Setzt den selektierten Wert auf einen bestimmten Eintrag.

Overrides:

setValue in class GuiComponent

See Also:

GuiComponent.setModified(boolean), GuiComponent.isModified()

getValue

public java.lang.Object getValue()

Liefert den selektierten Eintrag oder den gesamten Inhalt der ListBox.

Specified by:

getValue in class GuiComponent

getValue

public java.lang.Object getValue(int type)

Liefert den Wert der Listbox je nach übergebnen Type:

• NORMAL liefert den Selektierten Eintrag als String.
• MULTI liefert alle selektierten Einträge mit | getrennt.
• ALL liefert alle Einträge mit | getrennt.

reset

public void reset()

Bei den Typen NORMAL und MULTI wird slectedIndex zurückgesetzt; bei ALL werden alle Einträge aus der ListBox gelöscht.

Overrides:

reset in class GuiMember

getValues

public java.lang.String getValues()

Liefert alle Einträge der Listbox mit "|" getrennt.

getItems

public java.util.Vector getItems()

Description copied from class: GuiSelect

Liefert die Menge der Einträge.

Specified by:

getItems 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

removeAllItems

public void removeAllItems()

Description copied from class: GuiSelect

Löscht alle Einträge

Specified by:

removeAllItems in class GuiSelect

See Also:

reset()

click

public void click(java.awt.event.MouseEvent e)

Tut nix.

Overrides:

click in class GuiMember

See Also:

GuiMouseListener

d_click

public void d_click(java.awt.event.MouseEvent e)

Komponente wurde doppelt geklickt.

Overrides:

d_click in class GuiMember

See Also:

GuiRootPane#obj_DblClick

getSelectedIndex

public int getSelectedIndex()

Liefert den selektierten Index; bei MULTI wird der erste Index geliefert.

Specified by:

getSelectedIndex in class GuiSelect

setSelectedIndex

public void setSelectedIndex(int i)

Delegation zu JList.setSelectedInterval

Specified by:

setSelectedIndex in class GuiSelect

getSelectedItem

public java.lang.Object getSelectedItem()

Liefert den selektierten Eintrag.

Specified by:

getSelectedItem in class GuiSelect

setSelectedItem

public void setSelectedItem(java.lang.Object o)

Setzt den zu selektierenden Eintrag.

Specified by:

setSelectedItem in class GuiSelect

setLayout

public void setLayout(java.lang.String lay)