de.guibuilder.framework
Class GuiList

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.GuiList
All Implemented Interfaces:
IDatasetComponent, IDatasetMember, MemberAble, MemberPopupAble

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:

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


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, 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
GuiList()
          Erzeugt eine leere ListBox.
GuiList(java.lang.String[] s)
          Erzeugt eine ListBox mit Inhalt.
GuiList(java.util.Vector<java.lang.Object> 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 addItems(java.lang.Object[] items)
           
 void clearSelection()
           
 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.Object[] getSelectedItems()
           
 java.lang.String getTag()
          Liefert "List"
 java.lang.Object getUnformatedValue()
          Liefert den unformatierten Inhalt dieser Componente.
 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 setDatasetValues(JDataSet ds)
          Setzt den Inhalt der Komponente auf den Inhalt des Models der über getElementPath erreichbar ist.
 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.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, setMaxlen, setMinlen, setModified, setNotnull, 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, 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.IDatasetMember
getElementName, getElementPath, isRootElement, setElementName
 

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<java.lang.Object> 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

addItems

public void addItems(java.lang.Object[] items)
Specified by:
addItems 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()

getUnformatedValue

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

Specified by:
getUnformatedValue in class GuiComponent

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:


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.

Specified by:
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()

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(GuiComponent, String, Object, MouseEvent)

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

getSelectedItems

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

setSelectedItem

public void setSelectedItem(java.lang.Object o)
Setzt den zu selektierenden Eintrag.

Specified by:
setSelectedItem in class GuiSelect

clearSelection

public void clearSelection()
See Also:
JList.clearSelection()

setLayout

public void setLayout(java.lang.String lay)

setDatasetValues

public void setDatasetValues(JDataSet ds)
Description copied from class: GuiComponent
Setzt den Inhalt der Komponente auf den Inhalt des Models der über getElementPath erreichbar ist. Wird von GuiTable und GuiTree überschrieben.

Specified by:
setDatasetValues in interface IDatasetComponent
Overrides:
setDatasetValues in class GuiComponent