EasyFile
Class Mdl_Hotlistbox

java.lang.Object
  |
  +--javax.swing.AbstractListModel
        |
        +--EasyFile.Mdl_Hotlistbox
All Implemented Interfaces:
javax.swing.ComboBoxModel, java.util.EventListener, javax.swing.ListModel, Mdl_HotlistEventListener, javax.swing.MutableComboBoxModel, java.io.Serializable

public class Mdl_Hotlistbox
extends javax.swing.AbstractListModel
implements javax.swing.MutableComboBoxModel, Mdl_HotlistEventListener

Eine Umschlagklasse, die ein Objekt der Klasse Mdl_Hotlist so verpackt, dass daraus eine Modellklasse für JComboBoxen wird, deren Einträge die Elemente der Hotlist sind. Wenn in einer GUI eine ComboBox mit Einträgen einer Hotlist verwendet wird, kann und soll ausschließlich diese Klasse als Datenmodell verwendet werden, direkte Zugriffe auf das darunterliegende Objekt der Klasse Mdl_Hotlist sind zu vermeiden.
JComboBoxen, die Mdl_Hotlistbox als Datenmodell verwenden, müssen keinen eigenen ListCellRenderer implementieren, trotz dass die Objekte in der JComboBox keine Strings sind. Der DefaultRenderer ruft automatisch die Methode »toString« dieser Objekte auf.

See Also:
Serialized Form

Fields inherited from class javax.swing.AbstractListModel
listenerList
 
Constructor Summary
Mdl_Hotlistbox(Mdl_Hotlist theHotlist)
          Erzeugen eines Mdl_Hotlistbox.
 
Method Summary
 void addedEntry(addedEntryEvent e)
          Reaktion darauf, dass ein neuer Eintrag zur anwendungsweit verwendeten Hotlist (Variable theHotlist) hinzugekommen ist.
 void addElement(java.lang.Object anObject)
           
 java.lang.Object getElementAt(int index)
          Gibt das Element an der Position index zurück.
 int getIndexOf(java.lang.Object anObject)
          Liefert die Position (den Index) des übergebenen Objektes in der Hotlist.
 java.lang.Object getSelectedItem()
          Zwischengespeichertes selektiertes Objekt der JComboBox zurückgeben.
 int getSize()
          Gibt die Anzahl der Elemente in diesem Objekt von Mdl_Hotlistbox zurück.
 void insertElementAt(java.lang.Object anObject, int index)
          Fügt ein Element an einer definierten Position ein.
 void removedEntry(removedEntryEvent e)
          Reaktion darauf, dass ein Eintrag der anwendungsweit verwendeten Hotlist (Variable theHotlist) gelöscht wurde.
 void removeElement(java.lang.Object anObject)
           
 void removeElementAt(int index)
           
 void setSelectedItem(java.lang.Object anItem)
          Setze eine Zeile der JComboBox als die selektierte Zeile fest.
 
Methods inherited from class javax.swing.AbstractListModel
addListDataListener, fireContentsChanged, fireIntervalAdded, fireIntervalRemoved, getListeners, removeListDataListener
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface javax.swing.ListModel
addListDataListener, removeListDataListener
 

Constructor Detail

Mdl_Hotlistbox

public Mdl_Hotlistbox(Mdl_Hotlist theHotlist)
Erzeugen eines Mdl_Hotlistbox.
Parameters:
theHotlist - Hotlist, deren Verbindungseinträgen die Elemente dieser Mdl_Hotlistbox sein sollen. Das wird realisiert, indem einfach die entsprechenden Funktionen von theHotlist aufgerufen werden.
Method Detail

getElementAt

public java.lang.Object getElementAt(int index)
Gibt das Element an der Position index zurück. Der Index, unter dem ein Element in dieser Klasse und der Klasse Mdl_Hotlist angesprochen wird, ist stets identisch. Mdl_Hotlistbox enthält hier Objekte vom Typ Mdl_Connection. JComboBoxen, die Mdl_Hotlistbox als Datenmodell verwenden, müssen keinen eigenen ListCellRenderer implementieren, trotz dass die Objekte in der JComboBox keine Strings sind. Der DefaultRenderer ruft automatisch die Methode »toString« dieser Objekte auf. Diese Methode gehört zur Implementierung des Interface ComboBoxModel.
Specified by:
getElementAt in interface javax.swing.ListModel
Overrides:
getElementAt in class javax.swing.AbstractListModel
Parameters:
index - Position des angeforderten Elements. Mögliche Werte sind 0 bis getSize()-1. Liegt der Wert nicht in diesen Grenzen, wird null zurückgegeben.

getIndexOf

public int getIndexOf(java.lang.Object anObject)
Liefert die Position (den Index) des übergebenen Objektes in der Hotlist. Die Indizes in Mdl_Hotlistbox und dem darin verwendeten Objekt von Mdl_Hotlist sind jeweils identisch.
Parameters:
anObject - das Objekt, dessen Index in der Liste ermittelt werden soll.
Returns:
der Index in der Liste. Wertebereich von 0 bis getSize()-1. Wenn das übergebene Objekt nicht gefunden wurde, wird -1 zurückgegeben.
See Also:
Vector.indexOf(Object elem)

addElement

public void addElement(java.lang.Object anObject)
Specified by:
addElement in interface javax.swing.MutableComboBoxModel

getSize

public int getSize()
Gibt die Anzahl der Elemente in diesem Objekt von Mdl_Hotlistbox zurück. Methode gehört zur Implementierung des Interface ComboBoxModel.
Specified by:
getSize in interface javax.swing.ListModel
Overrides:
getSize in class javax.swing.AbstractListModel

getSelectedItem

public java.lang.Object getSelectedItem()
Zwischengespeichertes selektiertes Objekt der JComboBox zurückgeben. Es ist hier stets vom Typ Mdl_Connection, aber weil diese Methode zur Implementierung des Interface ComboBoxModel gehört, kann hier nur allgemein Object als Typ des Rückgabewertes angegeben werden.
Specified by:
getSelectedItem in interface javax.swing.ComboBoxModel

setSelectedItem

public void setSelectedItem(java.lang.Object anItem)
Setze eine Zeile der JComboBox als die selektierte Zeile fest. Diese Methode gehört zur Implementierung des Interface ComboBoxModel. anItem ist hier stets vom Typ Mdl_Connection, jedoch schreibt das Interface ComboBoxModel den Typ Object vor.
Specified by:
setSelectedItem in interface javax.swing.ComboBoxModel
Parameters:
anItem - der aktuell selektierte Eintrag der JComboBox

insertElementAt

public void insertElementAt(java.lang.Object anObject,
                            int index)
Fügt ein Element an einer definierten Position ein. Dabei wird das ggf. vorher dort befindliche Element überschrieben. Implementierung des Interface javax.swing.MutableComboBoxModel.
Specified by:
insertElementAt in interface javax.swing.MutableComboBoxModel

removeElementAt

public void removeElementAt(int index)
Specified by:
removeElementAt in interface javax.swing.MutableComboBoxModel

removeElement

public void removeElement(java.lang.Object anObject)
Specified by:
removeElement in interface javax.swing.MutableComboBoxModel

addedEntry

public void addedEntry(addedEntryEvent e)
Reaktion darauf, dass ein neuer Eintrag zur anwendungsweit verwendeten Hotlist (Variable theHotlist) hinzugekommen ist.
Specified by:
addedEntry in interface Mdl_HotlistEventListener
Parameters:
e - Event, das die Identifikationsnummer des neuen Hotlist-Eintrags enthält.

removedEntry

public void removedEntry(removedEntryEvent e)
Reaktion darauf, dass ein Eintrag der anwendungsweit verwendeten Hotlist (Variable theHotlist) gelöscht wurde.
Specified by:
removedEntry in interface Mdl_HotlistEventListener
Parameters:
e - Event, das die Identifikationsnummer des gelöschten Hotlist-Eintrags enthält.