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

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 `FooListener`s 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

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.