Top Description Fields Constructors Methods
javax.swing

public abstract Class AbstractListModel<E>

extends Object
implements ListModel<E>, Serializable
Class Inheritance
All Implemented Interfaces
java.io.Serializable, javax.swing.ListModel
Known Direct Subclasses
javax.swing.DefaultComboBoxModel, javax.swing.DefaultListModel, javax.swing.plaf.basic.BasicDirectoryModel, javax.swing.plaf.metal.MetalFileChooserUI.DirectoryComboBoxModel, javax.swing.plaf.metal.MetalFileChooserUI.FilterComboBoxModel, sun.swing.FilePane.SortableListModel, com.sun.java.swing.plaf.gtk.GTKFileChooserUI.GTKDirectoryListModel, com.sun.java.swing.plaf.gtk.GTKFileChooserUI.GTKFileListModel, com.sun.java.swing.plaf.gtk.GTKFileChooserUI.DirectoryComboBoxModel, com.sun.java.swing.plaf.gtk.GTKFileChooserUI.FilterComboBoxModel, com.sun.java.swing.plaf.motif.MotifFileChooserUI.MotifDirectoryListModel, com.sun.java.swing.plaf.motif.MotifFileChooserUI.MotifFileListModel, com.sun.java.swing.plaf.motif.MotifFileChooserUI.FilterComboBoxModel, sun.swing.plaf.synth.SynthFileChooserUIImpl.DirectoryComboBoxModel, sun.swing.plaf.synth.SynthFileChooserUIImpl.FilterComboBoxModel
Annotations
@SuppressWarnings:serial
Type Parameters
<E>
the type of the elements of this model
Imports
javax.swing.event.*, java.io.Serializable, java.util.EventListener
The abstract definition for the data model that provides a List with its contents.

Warning

Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeans has been added to the java.beans package. Please see java.beans.XMLEncoder.

Author
Hans Muller
Since
1.2

Field Summary

Modifier and TypeField and Description
protected EventListenerList
listenerList

The listener list.

Constructor Summary

AccessConstructor and Description
protected
AbstractListModel()

Constructor for subclasses to call.

Method Summary

Modifier and TypeMethod and Description
public void
addListDataListener(ListDataListener
the ListDataListener to be added
l)

Implements javax.swing.ListModel.addListDataListener.

Adds a listener to the list that's notified each time a change to the data model occurs.
protected void
fireContentsChanged(Object
the ListModel that changed, typically "this"
source, int
one end of the new interval
index0, int
the other end of the new interval
index1)

AbstractListModel subclasses must call this method after one or more elements of the list change.

protected void
fireIntervalAdded(Object
the ListModel that changed, typically "this"
source, int
one end of the new interval
index0, int
the other end of the new interval
index1)

AbstractListModel subclasses must call this method after one or more elements are added to the model.

protected void
fireIntervalRemoved(Object
the ListModel that changed, typically "this"
source, int
one end of the removed interval, including index0
index0, int
the other end of the removed interval, including index1
index1)

AbstractListModel subclasses must call this method after one or more elements are removed from the model.

public ListDataListener[]

Returns:

all of this model's ListDataListeners, or an empty array if no list data listeners are currently registered
getListDataListeners()

Returns an array of all the list data listeners registered on this AbstractListModel.

public <
the type of EventListener class being requested
T extends EventListener> T[]

Returns:

an array of all objects registered as FooListeners on this model, or an empty array if no such listeners have been added
getListeners(Class<T>
the type of listeners requested; this parameter should specify an interface that descends from java.util.EventListener
listenerType)

Returns an array of all the objects currently registered as FooListeners upon this model.

public void
removeListDataListener(ListDataListener
the ListDataListener to be removed
l)

Implements javax.swing.ListModel.removeListDataListener.

Removes a listener from the list that's notified each time a change to the data model occurs.
Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

listenerListback to summary
protected EventListenerList listenerList

The listener list.

Constructor Detail

AbstractListModelback to summary
protected AbstractListModel()

Constructor for subclasses to call.

Method Detail

addListDataListenerback to summary
public void addListDataListener(ListDataListener l)

Implements javax.swing.ListModel.addListDataListener.

Adds a listener to the list that's notified each time a change to the data model occurs.

Parameters
l:ListDataListener

the ListDataListener to be added

fireContentsChangedback to summary
protected void fireContentsChanged(Object source, int index0, int index1)

AbstractListModel subclasses must call this method after one or more elements of the list change. The changed elements are specified by the closed interval index0, index1 -- the endpoints are included. Note that index0 need not be less than or equal to index1.

Parameters
source:Object

the ListModel that changed, typically "this"

index0:int

one end of the new interval

index1:int

the other end of the new interval

See Also
EventListenerList, DefaultListModel
fireIntervalAddedback to summary
protected void fireIntervalAdded(Object source, int index0, int index1)

AbstractListModel subclasses must call this method after one or more elements are added to the model. The new elements are specified by a closed interval index0, index1 -- the endpoints are included. Note that index0 need not be less than or equal to index1.

Parameters
source:Object

the ListModel that changed, typically "this"

index0:int

one end of the new interval

index1:int

the other end of the new interval

See Also
EventListenerList, DefaultListModel
fireIntervalRemovedback to summary
protected void fireIntervalRemoved(Object source, int index0, int index1)

AbstractListModel subclasses must call this method after one or more elements are removed from the model. index0 and index1 are the end points of the interval that's been removed. Note that index0 need not be less than or equal to index1.

Parameters
source:Object

the ListModel that changed, typically "this"

index0:int

one end of the removed interval, including index0

index1:int

the other end of the removed interval, including index1

See Also
EventListenerList, DefaultListModel
getListDataListenersback to summary
public ListDataListener[] getListDataListeners()

Returns an array of all the list data listeners registered on this AbstractListModel.

Returns:ListDataListener[]

all of this model's ListDataListeners, or an empty array if no list data listeners are currently registered

Since
1.4
See Also
addListDataListener, removeListDataListener
getListenersback to summary
public <T extends EventListener> T[] getListeners(Class<T> listenerType)

Returns an array of all the objects currently registered as FooListeners upon this model. FooListeners are registered using the addFooListener method.

You can specify the listenerType argument with a class literal, such as FooListener.class. For example, you can query a list model m for its list data listeners with the following code: 

ListDataListener[] ldls = (ListDataListener[])(m.getListeners(ListDataListener.class));
If no such listeners exist, this method returns an empty array.
Parameters
<T>
the type of EventListener class being requested
listenerType:Class<T>

the type of listeners requested; this parameter should specify an interface that descends from java.util.EventListener

Returns:T[]

an array of all objects registered as FooListeners on this model, or an empty array if no such listeners have been added

Exceptions
ClassCastException:
if listenerType doesn't specify a class or interface that implements java.util.EventListener
Since
1.3
See Also
getListDataListeners
removeListDataListenerback to summary
public void removeListDataListener(ListDataListener l)

Implements javax.swing.ListModel.removeListDataListener.

Removes a listener from the list that's notified each time a change to the data model occurs.

Parameters
l:ListDataListener

the ListDataListener to be removed