Class DefaultComboBoxModel<E>

java.lang.Object

javax.swing.AbstractListModel<E>

javax.swing.DefaultComboBoxModel<E>

Type Parameters:

E - the type of the elements of this model

All Implemented Interfaces:

Serializable, ComboBoxModel<E>, ListModel<E>, MutableComboBoxModel<E>

public class DefaultComboBoxModel<E>
extends AbstractListModel<E>
implements MutableComboBoxModel<E>, Serializable

The default model for combo boxes.

Since:

1.2

Field Summary

Fields declared in class AbstractListModel

listenerList

Modifier and Type	Field	Description
protected EventListenerList	listenerList	The listener list.

Constructor Summary

Constructors

Constructor	Description
DefaultComboBoxModel()	Constructs an empty DefaultComboBoxModel object.
DefaultComboBoxModel(E[] items)	Constructs a DefaultComboBoxModel object initialized with an array of objects.
DefaultComboBoxModel(Vector<E> v)	Constructs a DefaultComboBoxModel object initialized with a vector.

Method Summary

Modifier and Type	Method	Description
void	addAll(int index, Collection<? extends E> c)	Adds all of the elements present in the collection, starting from the specified index.
void	addAll(Collection<? extends E> c)	Adds all of the elements present in the collection.
void	addElement(E anObject)	Adds an item at the end of the model.
E	getElementAt(int index)	Returns the value at the specified index.
int	getIndexOf(Object anObject)	Returns the index-position of the specified object in the list.
Object	getSelectedItem()	Returns the selected item
int	getSize()	Returns the length of the list.
void	insertElementAt(E anObject, int index)	Adds an item at a specific index.
void	removeAllElements()	Empties the list.
void	removeElement(Object anObject)	Removes an item from the model.
void	removeElementAt(int index)	Removes an item at a specific index.
void	setSelectedItem(Object anObject)	Set the value of the selected item.

Methods declared in class AbstractListModel

addListDataListener, fireContentsChanged, fireIntervalAdded, fireIntervalRemoved, getListDataListeners, getListeners, removeListDataListener

Modifier and Type	Method	Description
void	addListDataListener(ListDataListener l)	Adds a listener to the list that's notified each time a change to the data model occurs.
protected void	fireContentsChanged(Object source, int index0, int index1)	AbstractListModel subclasses must call this method after one or more elements of the list change.
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.
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.
ListDataListener[]	getListDataListeners()	Returns an array of all the list data listeners registered on this AbstractListModel.
<T extends EventListener> T[]	getListeners(Class<T> listenerType)	Returns an array of all the objects currently registered as FooListeners upon this model.
void	removeListDataListener(ListDataListener l)	Removes a listener from the list that's notified each time a change to the data model occurs.

Methods declared in class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Modifier and Type	Method	Description
protected Object	clone()	Creates and returns a copy of this object.
boolean	equals(Object obj)	Indicates whether some other object is "equal to" this one.
protected void	finalize()	Deprecated, for removal: This API element is subject to removal in a future version. Finalization is deprecated and subject to removal in a future release.
final Class<?>	getClass()	Returns the runtime class of this Object.
int	hashCode()	Returns a hash code value for this object.
final void	notify()	Wakes up a single thread that is waiting on this object's monitor.
final void	notifyAll()	Wakes up all threads that are waiting on this object's monitor.
String	toString()	Returns a string representation of the object.
final void	wait()	Causes the current thread to wait until it is awakened, typically by being notified or interrupted.
final void	wait(long timeoutMillis)	Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
final void	wait(long timeoutMillis, int nanos)	Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

Constructor Details

DefaultComboBoxModel

public DefaultComboBoxModel()

Constructs an empty DefaultComboBoxModel object.

DefaultComboBoxModel

public DefaultComboBoxModel(E[] items)

Constructs a DefaultComboBoxModel object initialized with an array of objects.

Parameters:

items - an array of Object objects

DefaultComboBoxModel

public DefaultComboBoxModel(Vector<E> v)

Constructs a DefaultComboBoxModel object initialized with a vector.

Parameters:

v - a Vector object ...

Method Details

setSelectedItem

public void setSelectedItem(Object anObject)

Set the value of the selected item. The selected item may be null.

Specified by:

setSelectedItem in interface ComboBoxModel<E>

Parameters:

anObject - The combo box value or null for no selection.

getSelectedItem

public Object getSelectedItem()

Description copied from interface: ComboBoxModel

Returns the selected item

Specified by:

getSelectedItem in interface ComboBoxModel<E>

Returns:

The selected item or null if there is no selection

getSize

public int getSize()

Description copied from interface: ListModel

Returns the length of the list.

Specified by:

getSize in interface ListModel<E>

Returns:

the length of the list

getElementAt

public E getElementAt(int index)

Description copied from interface: ListModel

Returns the value at the specified index.

Specified by:

getElementAt in interface ListModel<E>

Parameters:

index - the requested index

Returns:

the value at index

getIndexOf

public int getIndexOf(Object anObject)

Returns the index-position of the specified object in the list.

Parameters:

anObject - the object to return the index of

Returns:

an int representing the index position, where 0 is the first position

addElement

public void addElement(E anObject)

Description copied from interface: MutableComboBoxModel

Adds an item at the end of the model. The implementation of this method should notify all registered ListDataListeners that the item has been added.

Specified by:

addElement in interface MutableComboBoxModel<E>

Parameters:

anObject - the item to be added

insertElementAt

public void insertElementAt(E anObject,
 int index)

Description copied from interface: MutableComboBoxModel

Adds an item at a specific index. The implementation of this method should notify all registered ListDataListeners that the item has been added.

Specified by:

insertElementAt in interface MutableComboBoxModel<E>

Parameters:

anObject - the item to be added

index - location to add the object

removeElementAt

public void removeElementAt(int index)

Description copied from interface: MutableComboBoxModel

Removes an item at a specific index. The implementation of this method should notify all registered ListDataListeners that the item has been removed.

Specified by:

removeElementAt in interface MutableComboBoxModel<E>

Parameters:

index - location of the item to be removed

removeElement

public void removeElement(Object anObject)

Description copied from interface: MutableComboBoxModel

Removes an item from the model. The implementation of this method should should notify all registered ListDataListeners that the item has been removed.

Specified by:

removeElement in interface MutableComboBoxModel<E>

Parameters:

anObject - the Object to be removed

removeAllElements

public void removeAllElements()

Empties the list.

addAll

public void addAll(Collection<? extends E> c)

Adds all of the elements present in the collection.

Parameters:

c - the collection which contains the elements to add

Throws:

NullPointerException - if c is null

Since:

11

addAll

public void addAll(int index,
 Collection<? extends E> c)

Adds all of the elements present in the collection, starting from the specified index.

Parameters:

index - index at which to insert the first element from the specified collection

c - the collection which contains the elements to add

Throws:

ArrayIndexOutOfBoundsException - if index does not fall within the range of number of elements currently held

NullPointerException - if c is null

Since:

11