|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectca.odell.glazedlists.swing.EventListModel<E>
public class EventListModel<E>
An EventListModel adapts an EventList to the ListModel interface making it
appropriate for use with a JList
. Each element of the list
corresponds to an element in the ListModel
.
The EventListModel class is not thread-safe. Unless
otherwise noted, all methods are only safe to be called from the event
dispatch thread. To do this programmatically, use
SwingUtilities.invokeAndWait(Runnable)
.
SwingUtilities.invokeAndWait(Runnable)
Field Summary | |
---|---|
protected ca.odell.glazedlists.swing.MutableListDataEvent |
listDataEvent
recycle the list data event to prevent unnecessary object creation |
Constructor Summary | |
---|---|
EventListModel(EventList<E> source)
Creates a new model that contains all objects located in the given source and reacts to any changes in the given
source . |
Method Summary | |
---|---|
void |
addListDataListener(javax.swing.event.ListDataListener listDataListener)
Registers the specified ListDataListener to receive updates whenever this list changes. |
void |
dispose()
Releases the resources consumed by this EventListModel so that it
may eventually be garbage collected. |
protected void |
fireListDataEvent(javax.swing.event.ListDataEvent listDataEvent)
Notifies all ListDataListeners about one block of changes in the list. |
java.lang.Object |
getElementAt(int index)
Retrieves the value at the specified location from the table. |
int |
getSize()
Gets the size of the list. |
void |
listChanged(ListEvent<E> listChanges)
For implementing the ListEventListener interface. |
void |
removeListDataListener(javax.swing.event.ListDataListener listDataListener)
Deregisters the specified ListDataListener from receiving updates whenever this list changes. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
protected final ca.odell.glazedlists.swing.MutableListDataEvent listDataEvent
Constructor Detail |
---|
public EventListModel(EventList<E> source)
source
and reacts to any changes in the given
source
.
Method Detail |
---|
public void listChanged(ListEvent<E> listChanges)
This always sends discrete changes for the complete size of the list. It may be more efficient to implement a threshhold where a large list of changes are grouped together as a single change. This is how the ListTable accepts large change events.
listChanged
in interface ListEventListener<E>
public java.lang.Object getElementAt(int index)
getElementAt
in interface javax.swing.ListModel
ListTable
public int getSize()
getSize
in interface javax.swing.ListModel
public void addListDataListener(javax.swing.event.ListDataListener listDataListener)
The specified ListDataListener must not save a reference to the ListDataEvent beyond the end of the notification method. This is because the ListDataEvent is re-used to increase the performance of this implementation.
addListDataListener
in interface javax.swing.ListModel
public void removeListDataListener(javax.swing.event.ListDataListener listDataListener)
removeListDataListener
in interface javax.swing.ListModel
protected void fireListDataEvent(javax.swing.event.ListDataEvent listDataEvent)
public void dispose()
EventListModel
so that it
may eventually be garbage collected.
An EventListModel
will be garbage collected without a call to
dispose()
, but not before its source EventList
is garbage
collected. By calling dispose()
, you allow the EventListModel
to be garbage collected before its source EventList
. This is
necessary for situations where an EventListModel
is short-lived but
its source EventList
is long-lived.
Warning: It is an error
to call any method on an EventListModel
after it has been disposed.
As such, this EventListModel
should be detached from its
corresponding Component before it is disposed.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |