DefaultComboBoxModel (Java Platform SE 8 ) (original) (raw)

• java.lang.Object

• • javax.swing.AbstractListModel
  • • javax.swing.DefaultComboBoxModel

• Type Parameters:
  E - the type of the elements of this model
  All Implemented Interfaces:
  Serializable, ComboBoxModel, ListModel, MutableComboBoxModel

public class DefaultComboBoxModel
extends AbstractListModel
implements MutableComboBoxModel, Serializable
The default model for combo boxes.

• • Field Summary

     * ### Fields inherited from class javax.swing.[AbstractListModel](../../javax/swing/AbstractListModel.html "class in javax.swing")  
     `[listenerList](../../javax/swing/AbstractListModel.html#listenerList)`  

  • 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

  All Methods Instance Methods Concrete Methods

  Modifier and Type	Method	Description
  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 inherited from class javax.swing.[AbstractListModel](../../javax/swing/AbstractListModel.html "class in javax.swing")  
     `[addListDataListener](../../javax/swing/AbstractListModel.html#addListDataListener-javax.swing.event.ListDataListener-), [fireContentsChanged](../../javax/swing/AbstractListModel.html#fireContentsChanged-java.lang.Object-int-int-), [fireIntervalAdded](../../javax/swing/AbstractListModel.html#fireIntervalAdded-java.lang.Object-int-int-), [fireIntervalRemoved](../../javax/swing/AbstractListModel.html#fireIntervalRemoved-java.lang.Object-int-int-), [getListDataListeners](../../javax/swing/AbstractListModel.html#getListDataListeners--), [getListeners](../../javax/swing/AbstractListModel.html#getListeners-java.lang.Class-), [removeListDataListener](../../javax/swing/AbstractListModel.html#removeListDataListener-javax.swing.event.ListDataListener-)`  
     * ### Methods inherited from class java.lang.[Object](../../java/lang/Object.html "class in java.lang")  
     `[clone](../../java/lang/Object.html#clone--), [equals](../../java/lang/Object.html#equals-java.lang.Object-), [finalize](../../java/lang/Object.html#finalize--), [getClass](../../java/lang/Object.html#getClass--), [hashCode](../../java/lang/Object.html#hashCode--), [notify](../../java/lang/Object.html#notify--), [notifyAll](../../java/lang/Object.html#notifyAll--), [toString](../../java/lang/Object.html#toString--), [wait](../../java/lang/Object.html#wait--), [wait](../../java/lang/Object.html#wait-long-), [wait](../../java/lang/Object.html#wait-long-int-)`  
     * ### Methods inherited from interface javax.swing.[ListModel](../../javax/swing/ListModel.html "interface in javax.swing")  
     `[addListDataListener](../../javax/swing/ListModel.html#addListDataListener-javax.swing.event.ListDataListener-), [removeListDataListener](../../javax/swing/ListModel.html#removeListDataListener-javax.swing.event.ListDataListener-)`

• • Constructor Detail

     * #### DefaultComboBoxModel  
     public DefaultComboBoxModel()  
     Constructs an empty DefaultComboBoxModel object.  
     * #### DefaultComboBoxModel  
     public DefaultComboBoxModel([E](../../javax/swing/DefaultComboBoxModel.html "type parameter in DefaultComboBoxModel")[] items)  
     Constructs a DefaultComboBoxModel object initialized with an array of objects.  
     Parameters:  
     `items` \- an array of Object objects  
     * #### DefaultComboBoxModel  
     public DefaultComboBoxModel([Vector](../../java/util/Vector.html "class in java.util")<[E](../../javax/swing/DefaultComboBoxModel.html "type parameter in DefaultComboBoxModel")> v)  
     Constructs a DefaultComboBoxModel object initialized with a vector.  
     Parameters:  
     `v` \- a Vector object ...  

  • Method Detail

    * #### setSelectedItem  
    public void setSelectedItem([Object](../../java/lang/Object.html "class in java.lang") anObject)  
    Set the value of the selected item. The selected item may be null.  
    Specified by:  
    `[setSelectedItem](../../javax/swing/ComboBoxModel.html#setSelectedItem-java.lang.Object-)` in interface `[ComboBoxModel](../../javax/swing/ComboBoxModel.html "interface in javax.swing")<[E](../../javax/swing/DefaultComboBoxModel.html "type parameter in DefaultComboBoxModel")>`  
    Parameters:  
    `anObject` \- The combo box value or null for no selection.  
    * #### getSelectedItem  
    public [Object](../../java/lang/Object.html "class in java.lang") getSelectedItem()  
    Returns the selected item  
    Specified by:  
    `[getSelectedItem](../../javax/swing/ComboBoxModel.html#getSelectedItem--)` in interface `[ComboBoxModel](../../javax/swing/ComboBoxModel.html "interface in javax.swing")<[E](../../javax/swing/DefaultComboBoxModel.html "type parameter in DefaultComboBoxModel")>`  
    Returns:  
    The selected item or `null` if there is no selection  
    * #### getSize  
    public int getSize()  
    Description copied from interface: `[ListModel](../../javax/swing/ListModel.html#getSize--)`  
    Returns the length of the list.  
    Specified by:  
    `[getSize](../../javax/swing/ListModel.html#getSize--)` in interface `[ListModel](../../javax/swing/ListModel.html "interface in javax.swing")<[E](../../javax/swing/DefaultComboBoxModel.html "type parameter in DefaultComboBoxModel")>`  
    Returns:  
    the length of the list  
    * #### getElementAt  
    public [E](../../javax/swing/DefaultComboBoxModel.html "type parameter in DefaultComboBoxModel") getElementAt(int index)  
    Description copied from interface: `[ListModel](../../javax/swing/ListModel.html#getElementAt-int-)`  
    Returns the value at the specified index.  
    Specified by:  
    `[getElementAt](../../javax/swing/ListModel.html#getElementAt-int-)` in interface `[ListModel](../../javax/swing/ListModel.html "interface in javax.swing")<[E](../../javax/swing/DefaultComboBoxModel.html "type parameter in DefaultComboBoxModel")>`  
    Parameters:  
    `index` \- the requested index  
    Returns:  
    the value at `index`  
    * #### getIndexOf  
    public int getIndexOf([Object](../../java/lang/Object.html "class in java.lang") anObject)  
    Returns the index-position of the specified object in the list.  
    Parameters:  
    `anObject` \-  
    Returns:  
    an int representing the index position, where 0 is the first position  
    * #### addElement  
    public void addElement([E](../../javax/swing/DefaultComboBoxModel.html "type parameter in DefaultComboBoxModel") anObject)  
    Adds an item at the end of the model. The implementation of this method should notify all registered `ListDataListener`s that the item has been added.  
    Specified by:  
    `[addElement](../../javax/swing/MutableComboBoxModel.html#addElement-E-)` in interface `[MutableComboBoxModel](../../javax/swing/MutableComboBoxModel.html "interface in javax.swing")<[E](../../javax/swing/DefaultComboBoxModel.html "type parameter in DefaultComboBoxModel")>`  
    Parameters:  
    `anObject` \- the item to be added  
    * #### insertElementAt  
    public void insertElementAt([E](../../javax/swing/DefaultComboBoxModel.html "type parameter in DefaultComboBoxModel") anObject,  
                                int index)  
    Adds an item at a specific index. The implementation of this method should notify all registered `ListDataListener`s that the item has been added.  
    Specified by:  
    `[insertElementAt](../../javax/swing/MutableComboBoxModel.html#insertElementAt-E-int-)` in interface `[MutableComboBoxModel](../../javax/swing/MutableComboBoxModel.html "interface in javax.swing")<[E](../../javax/swing/DefaultComboBoxModel.html "type parameter in DefaultComboBoxModel")>`  
    Parameters:  
    `anObject` \- the item to be added  
    `index` \- location to add the object  
    * #### removeElementAt  
    public void removeElementAt(int index)  
    Removes an item at a specific index. The implementation of this method should notify all registered `ListDataListener`s that the item has been removed.  
    Specified by:  
    `[removeElementAt](../../javax/swing/MutableComboBoxModel.html#removeElementAt-int-)` in interface `[MutableComboBoxModel](../../javax/swing/MutableComboBoxModel.html "interface in javax.swing")<[E](../../javax/swing/DefaultComboBoxModel.html "type parameter in DefaultComboBoxModel")>`  
    Parameters:  
    `index` \- location of the item to be removed  
    * #### removeElement  
    public void removeElement([Object](../../java/lang/Object.html "class in java.lang") anObject)  
    Removes an item from the model. The implementation of this method should should notify all registered `ListDataListener`s that the item has been removed.  
    Specified by:  
    `[removeElement](../../javax/swing/MutableComboBoxModel.html#removeElement-java.lang.Object-)` in interface `[MutableComboBoxModel](../../javax/swing/MutableComboBoxModel.html "interface in javax.swing")<[E](../../javax/swing/DefaultComboBoxModel.html "type parameter in DefaultComboBoxModel")>`  
    Parameters:  
    `anObject` \- the `Object` to be removed  
    * #### removeAllElements  
    public void removeAllElements()  
    Empties the list.

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.